acmt.034.001.01
The AccountSwitchRequestPayment message is sent by the old account servicer to the new account servicer after the completion of the account switch to request the transfer of funds for a payment that the previous account servicer has had to make from the old account (for example: the settlement of a card transaction that was authorised offline).
Message Construction
Every ISO20022 message has at the highest level what we call ‘building blocks’. Because the message is constructed as immutable records, the association is by composition. Below you can see the relationship between the message and its constituent building blocks: For comparison, see the ISO20022 official specification
classDiagram
direction LR
%% AccountSwitchRequestPaymentV01 recursion level 0 with max 0
AccountSwitchRequestPaymentV01 *-- "1..1" MessageIdentification1 : MessageIdentification
AccountSwitchRequestPaymentV01 *-- "1..1" AccountSwitchDetails1 : AccountSwitchDetails
AccountSwitchRequestPaymentV01 *-- "1..1" CashAccount36 : OldAccount
AccountSwitchRequestPaymentV01 *-- "1..1" CreditTransferTransaction27 : CreditInstructions
AccountSwitchRequestPaymentV01 *-- "0..1" SupplementaryData1 : SupplementaryData
Now, we will zero-in one-by-one on each of these building blocks.
MessageIdentification building block
Unique identification for the message. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
Identification IsoMax35Text
CreationDateTime IsoISODateTime
}
MessageIdentification1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identification of the message. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date of creation of the message. | IsoISODateTime - Required 1..1 |
AccountSwitchDetails building block
Contains information about the details of the account switch and a response code to the original payment request. Details of the account switch, including its status and any response codes. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% AccountSwitchDetails1 recursion level 0 with max 1
class AccountSwitchDetails1{
UniqueReferenceNumber IsoMax35Text
RoutingUniqueReferenceNumber IsoMax35Text
SwitchReceivedDateTime IsoISODateTime
SwitchDate IsoISODate
SwitchType SwitchType1Code
SwitchStatus SwitchStatus1Code
BalanceTransferWindow BalanceTransferWindow1Code
}
AccountSwitchDetails1 *-- "0..0" ResponseDetails1 : Response
%% ResponseDetails1 recursion level 1 with max 1
class ResponseDetails1{
ResponseCode IsoMax35Text
AdditionalDetails IsoMax350Text
}
AccountSwitchDetails1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| UniqueReferenceNumber | Unique number that provides unique and unambiguous identification of the account switch. | IsoMax35Text - Required 1..1 |
| RoutingUniqueReferenceNumber | Unique number that provides unique and unambiguous identification of the account switch. Usage: Where one or more account switches have taken place since the original account switch this field contains the unique number that relates to the switch that transferred the account to the latest new account servicer. | IsoMax35Text - Required 1..1 |
| SwitchReceivedDateTime | Date and time that the request was received by the central switch service, populated by the central switch service only. | IsoISODateTime - Optional 0..1 |
| SwitchDate | Date on which the account switch is expected to have completed. The value is the same as the targeted switch date if the switch completes in the expected timeline. | IsoISODate - Optional 0..1 |
| SwitchType | Indicates whether the account switch is a full switch or a partial switch. Usage: A full switch indicates the transfer of the full balance of the account and associated payment mandates. A partial switch indicates the transfer of certain payment mandates to a new account. | SwitchType1Code - Required 1..1 |
| SwitchStatus | State of the account switch at the time the message is sent. | SwitchStatus1Code - Optional 0..1 |
| BalanceTransferWindow | Identifies the processing window in which the balance transfer will be processed on the day of the account switch. | BalanceTransferWindow1Code - Optional 0..1 |
| Response | Response code and additional information. | ResponseDetails1 - Unknown 0..0 |
OldAccount building block
Account held at the old account servicer being switched to the new account servicer. Provides the details to identify an account. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CashAccount36 recursion level 0 with max 1
class CashAccount36{
Currency ActiveOrHistoricCurrencyCode
Name IsoMax70Text
}
CashAccount36 *-- "1..1" IAccountIdentification4Choice : Identification
CashAccount36 *-- "0..1" ICashAccountType2Choice : Type
CashAccount36 *-- "0..1" PartyIdentification125 : Owner
CashAccount36 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : Servicer
%% IAccountIdentification4Choice recursion level 1 with max 1
%% ICashAccountType2Choice recursion level 1 with max 1
%% PartyIdentification125 recursion level 1 with max 1
class PartyIdentification125{
Name IsoMax140Text
CountryOfResidence CountryCode
}
PartyIdentification125 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification125 *-- "0..1" IParty34Choice : Identification
PartyIdentification125 *-- "0..1" ContactDetails2 : ContactDetails
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
CashAccount36 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique and unambiguous identification for the account between the account owner and the account servicer. | IAccountIdentification4Choice - Required 1..1 |
| Type | Specifies the nature, or use of the account. | ICashAccountType2Choice - Optional 0..1 |
| Currency | Identification of the currency in which the account is held. | ActiveOrHistoricCurrencyCode - Optional 0..1 |
| Name | Name of the account, as assigned by the account servicing institution, in agreement with the account owner in order to provide an additional means of identification of the account. | |
| Owner | Party that legally owns the account. | PartyIdentification125 - Optional 0..1 |
| Servicer | Party that manages the account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account. | BranchAndFinancialInstitutionIdentification5 - Optional 0..1 |
CreditInstructions building block
Specific information relating to a request for payment, including details that enable the receiving account servicer to reconcile the payment to be received with the original payment request. Details specific to the individual transaction(s) included in the message. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CreditTransferTransaction27 recursion level 0 with max 1
class CreditTransferTransaction27{
TaxRateMarker TaxRateMarker1Code
Amount IsoActiveCurrencyAndAmount
ChargeBearer ChargeBearerType1Code
}
CreditTransferTransaction27 *-- "1..1" PaymentIdentification1 : PaymentIdentification
CreditTransferTransaction27 *-- "0..1" PaymentTypeInformation19 : PaymentTypeInformation
CreditTransferTransaction27 *-- "0..1" Cheque7 : ChequeInstruction
CreditTransferTransaction27 *-- "0..1" Frequency1 : Frequency
CreditTransferTransaction27 *-- "0..1" TransferInstruction1 : TransferInstruction
CreditTransferTransaction27 *-- "0..1" PartyIdentification125 : UltimateDebtor
CreditTransferTransaction27 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : IntermediaryAgent1
CreditTransferTransaction27 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : IntermediaryAgent2
CreditTransferTransaction27 *-- "0..1" BranchAndFinancialInstitutionIdentification5 : IntermediaryAgent3
CreditTransferTransaction27 *-- "1..1" BranchAndFinancialInstitutionIdentification5 : CreditorAgent
CreditTransferTransaction27 *-- "0..1" PartyIdentification125 : Creditor
CreditTransferTransaction27 *-- "0..1" CashAccount24 : CreditorAccount
CreditTransferTransaction27 *-- "0..1" PartyIdentification125 : UltimateCreditor
CreditTransferTransaction27 *-- "0..0" InstructionForCreditorAgent1 : InstructionForCreditorAgent
CreditTransferTransaction27 *-- "0..1" IPurpose2Choice : Purpose
CreditTransferTransaction27 *-- "0..10" RegulatoryReporting3 : RegulatoryReporting
CreditTransferTransaction27 *-- "0..1" TaxInformation6 : Tax
CreditTransferTransaction27 *-- "0..10" RemittanceLocation2 : RelatedRemittanceInformation
CreditTransferTransaction27 *-- "0..1" RemittanceInformation14 : RemittanceInformation
%% PaymentIdentification1 recursion level 1 with max 1
class PaymentIdentification1{
InstructionIdentification IsoMax35Text
EndToEndIdentification IsoMax35Text
}
%% PaymentTypeInformation19 recursion level 1 with max 1
class PaymentTypeInformation19{
InstructionPriority Priority2Code
}
PaymentTypeInformation19 *-- "0..1" IServiceLevel8Choice : ServiceLevel
PaymentTypeInformation19 *-- "0..1" ILocalInstrument2Choice : LocalInstrument
PaymentTypeInformation19 *-- "0..1" ICategoryPurpose1Choice : CategoryPurpose
%% Cheque7 recursion level 1 with max 1
class Cheque7{
ChequeType ChequeType2Code
ChequeNumber IsoMax35Text
InstructionPriority Priority2Code
ChequeMaturityDate IsoISODate
FormsCode IsoMax35Text
MemoField IsoMax35Text
RegionalClearingZone IsoMax35Text
PrintLocation IsoMax35Text
Signature IsoMax70Text
}
Cheque7 *-- "0..1" NameAndAddress10 : ChequeFrom
Cheque7 *-- "0..1" IChequeDeliveryMethod1Choice : DeliveryMethod
Cheque7 *-- "0..1" NameAndAddress10 : DeliverTo
%% Frequency1 recursion level 1 with max 1
class Frequency1{
Sequence IsoMax3NumericText
StartDate IsoISODate
NonWorkingDayAdjustment BusinessDayConvention1Code
}
Frequency1 *-- "1..1" IEndPoint1Choice : EndPointChoice
Frequency1 *-- "0..1" IFrequency37Choice : RequestedFrequencyPattern
%% TransferInstruction1 recursion level 1 with max 1
class TransferInstruction1{
TransferIndicator IsoYesNoIndicator
Code IsoMax35Text
Proprietary IsoMax256Text
StartDateTime IsoISODateTime
StartDate IsoISODate
Description IsoMax350Text
}
%% PartyIdentification125 recursion level 1 with max 1
class PartyIdentification125{
Name IsoMax140Text
CountryOfResidence CountryCode
}
PartyIdentification125 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification125 *-- "0..1" IParty34Choice : Identification
PartyIdentification125 *-- "0..1" ContactDetails2 : ContactDetails
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% BranchAndFinancialInstitutionIdentification5 recursion level 1 with max 1
BranchAndFinancialInstitutionIdentification5 *-- "1..1" FinancialInstitutionIdentification8 : FinancialInstitutionIdentification
BranchAndFinancialInstitutionIdentification5 *-- "0..1" BranchData2 : BranchIdentification
%% PartyIdentification125 recursion level 1 with max 1
class PartyIdentification125{
Name IsoMax140Text
CountryOfResidence CountryCode
}
PartyIdentification125 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification125 *-- "0..1" IParty34Choice : Identification
PartyIdentification125 *-- "0..1" ContactDetails2 : ContactDetails
%% CashAccount24 recursion level 1 with max 1
class CashAccount24{
Currency ActiveOrHistoricCurrencyCode
Name IsoMax70Text
}
CashAccount24 *-- "1..1" IAccountIdentification4Choice : Identification
CashAccount24 *-- "0..1" ICashAccountType2Choice : Type
%% PartyIdentification125 recursion level 1 with max 1
class PartyIdentification125{
Name IsoMax140Text
CountryOfResidence CountryCode
}
PartyIdentification125 *-- "0..1" PostalAddress6 : PostalAddress
PartyIdentification125 *-- "0..1" IParty34Choice : Identification
PartyIdentification125 *-- "0..1" ContactDetails2 : ContactDetails
%% InstructionForCreditorAgent1 recursion level 1 with max 1
class InstructionForCreditorAgent1{
Code Instruction3Code
InstructionInformation IsoMax140Text
}
%% IPurpose2Choice recursion level 1 with max 1
%% RegulatoryReporting3 recursion level 1 with max 1
class RegulatoryReporting3{
DebitCreditReportingIndicator RegulatoryReportingType1Code
}
RegulatoryReporting3 *-- "0..1" RegulatoryAuthority2 : Authority
RegulatoryReporting3 *-- "0..0" StructuredRegulatoryReporting3 : Details
%% TaxInformation6 recursion level 1 with max 1
class TaxInformation6{
AdministrationZone IsoMax35Text
ReferenceNumber IsoMax140Text
Method IsoMax35Text
TotalTaxableBaseAmount IsoActiveOrHistoricCurrencyAndAmount
TotalTaxAmount IsoActiveOrHistoricCurrencyAndAmount
Date IsoISODate
SequenceNumber IsoNumber
}
TaxInformation6 *-- "0..1" TaxParty1 : Creditor
TaxInformation6 *-- "0..1" TaxParty2 : Debtor
TaxInformation6 *-- "0..0" TaxRecord2 : Record
%% RemittanceLocation2 recursion level 1 with max 1
class RemittanceLocation2{
RemittanceIdentification IsoMax35Text
RemittanceLocationMethod RemittanceLocationMethod2Code
RemittanceLocationElectronicAddress IsoMax2048Text
}
RemittanceLocation2 *-- "0..1" NameAndAddress10 : RemittanceLocationPostalAddress
%% RemittanceInformation14 recursion level 1 with max 1
class RemittanceInformation14{
Unstructured IsoMax140Text
}
RemittanceInformation14 *-- "0..0" StructuredRemittanceInformation14 : Structured
CreditTransferTransaction27 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PaymentIdentification | Set of elements used to reference a payment instruction. | PaymentIdentification1 - Required 1..1 |
| PaymentTypeInformation | Set of elements used to further specify the type of transaction. | PaymentTypeInformation19 - Optional 0..1 |
| TaxRateMarker | Specifies the rate of tax levied. | TaxRateMarker1Code - Optional 0..1 |
| Amount | Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party. | IsoActiveCurrencyAndAmount - Required 1..1 |
| ChargeBearer | Specifies which party/parties will bear the charges associated with the processing of the payment transaction. | ChargeBearerType1Code - Optional 0..1 |
| ChequeInstruction | Set of elements needed to issue a cheque. | Cheque7 - Optional 0..1 |
| Frequency | The schedule for a credit payment arrangement. | Frequency1 - Optional 0..1 |
| TransferInstruction | Provides further information about the status of transferred scheduled payment(s). | TransferInstruction1 - Optional 0..1 |
| UltimateDebtor | Ultimate party that owes an amount of money to the (ultimate) creditor. | PartyIdentification125 - Optional 0..1 |
| IntermediaryAgent1 | Agent between the debtor’s agent and the creditor’s agent. | |
| IntermediaryAgent2 | Agent between the debtor’s agent and the creditor’s agent. | |
| IntermediaryAgent3 | Agent between the debtor’s agent and the creditor’s agent. | |
| CreditorAgent | Financial institution servicing an account for the creditor. | BranchAndFinancialInstitutionIdentification5 - Required 1..1 |
| Creditor | Party to which an amount of money is due. | PartyIdentification125 - Optional 0..1 |
| CreditorAccount | Unambiguous identification of the account of the creditor to which a credit entry will be posted as a result of the payment transaction. | CashAccount24 - Optional 0..1 |
| UltimateCreditor | Ultimate party to which an amount of money is due. | PartyIdentification125 - Optional 0..1 |
| InstructionForCreditorAgent | Further information related to the processing of the payment instruction, provided by the initiating party, and intended for the creditor agent. | InstructionForCreditorAgent1 - Unknown 0..0 |
| Purpose | Underlying reason for the payment transaction. Usage: Purpose is used by the end-customers, that is initiating party, (ultimate) debtor, (ultimate) creditor to provide information concerning the nature of the payment. Purpose is a content element, which is not used for processing by any of the agents involved in the payment chain. | IPurpose2Choice - Optional 0..1 |
| RegulatoryReporting | Information needed due to regulatory and statutory requirements. | RegulatoryReporting3 - Collection 0..10 |
| Tax | Provides details on the tax. | TaxInformation6 - Optional 0..1 |
| RelatedRemittanceInformation | Provides information related to the handling of the remittance information by any of the agents in the transaction processing chain. | RemittanceLocation2 - Collection 0..10 |
| RemittanceInformation | Information supplied to enable the matching of an entry with the items that the transfer is intended to settle, such as commercial invoices in an accounts’ receivable system. | RemittanceInformation14 - Optional 0..1 |
SupplementaryData building block
Additional information that cannot be captured in the structured elements and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% SupplementaryData1 recursion level 0 with max 1
class SupplementaryData1{
PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
%% IsoSupplementaryDataEnvelope1 recursion level 1 with max 1
SupplementaryData1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PlaceAndName | Unambiguous reference to the location where the supplementary data must be inserted in the message instance. In the case of XML, this is expressed by a valid XPath. | IsoMax350Text - Optional 0..1 |
| Envelope | Technical element wrapping the supplementary data. | IsoSupplementaryDataEnvelope1 - Required 1..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the AccountSwitchRequestPaymentV01 implementation follows a specific implementaiton pattern. First of all, AccountSwitchRequestPaymentV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, AccountSwitchRequestPaymentV01Document implements IOuterDocument. Because AccountSwitchRequestPaymentV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type AccountSwitchRequestPaymentV01.
classDiagram
class IOuterRecord
AccountSwitchRequestPaymentV01 --|> IOuterRecord : Implements
AccountSwitchRequestPaymentV01Document --|> IOuterDocument~AccountSwitchRequestPaymentV01~ : Implements
class IOuterDocument~AccountSwitchRequestPaymentV01~ {
AccountSwitchRequestPaymentV01 Message
}
Document wrapper for serialization
The only real purpose AccountSwitchRequestPaymentV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:acmt.034.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using AccountSwitchRequestPaymentV01.ToDocument() method. The returned AccountSwitchRequestPaymentV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
AccountSwitchRequestPaymentV01Document *-- AccountSwitchRequestPaymentV01 : Document
Sample of message format
This is an abbreviated version of what the message should look like.
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:acmt.034.001.01">
<AcctSwtchReqPmt>
<MsgId>
<!-- MessageIdentification inner content -->
</MsgId>
<AcctSwtchDtls>
<!-- AccountSwitchDetails inner content -->
</AcctSwtchDtls>
<OdAcct>
<!-- OldAccount inner content -->
</OdAcct>
<CdtInstrs>
<!-- CreditInstructions inner content -->
</CdtInstrs>
<SplmtryData>
<!-- SupplementaryData inner content -->
</SplmtryData>
</AcctSwtchReqPmt>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_I_e4khMMEeSTk5fcu7tr9w"
nextVersions="_7HT_d242EeiU9cctagi5ow"
name="AccountSwitchRequestPaymentV01"
definition="The AccountSwitchRequestPayment message is sent by the old account servicer to the new account servicer after the completion of the account switch to request the transfer of funds for a payment that the previous account servicer has had to make from the old account (for example: the settlement of a card transaction that was authorised offline)."
registrationStatus="Registered"
messageSet="_urpIICeJEeOCeO5e7islRQ"
xmlTag="AcctSwtchReqPmt"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_I3wisa5kEee17eDA_q0a9g"
nextVersions="_7HT_eW42EeiU9cctagi5ow"
name="MessageIdentification"
definition="Unique identification for the message."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="MsgId"
complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
<messageBuildingBlock
xmi:id="_KYA0ga5kEee17eDA_q0a9g"
nextVersions="_7HT_e242EeiU9cctagi5ow"
name="AccountSwitchDetails"
definition="Contains information about the details of the account switch and a response code to the original payment request."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AcctSwtchDtls"
complexType="_8m2xcQ2ZEeSNWNtJlXOAhg" />
<messageBuildingBlock
xmi:id="_XMcGgBMMEeSTk5fcu7tr9w"
nextVersions="_7HT_fW42EeiU9cctagi5ow"
name="OldAccount"
definition="Account held at the old account servicer being switched to the new account servicer."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="OdAcct"
complexType="_jez1wa9UEeeJJK1oRb-jTw" />
<messageBuildingBlock
xmi:id="_kisvcF11EeeRXu-I2a3CBQ"
nextVersions="_7HT_f242EeiU9cctagi5ow"
name="CreditInstructions"
definition="Specific information relating to a request for payment, including details that enable the receiving account servicer to reconcile the payment to be received with the original payment request."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="CdtInstrs"
complexType="_AyXSMORsEeaY150p1rZlTg" />
<messageBuildingBlock
xmi:id="_g84jIA8EEeeJ4ZumUkzG4Q"
nextVersions="_7HT_gW42EeiU9cctagi5ow"
name="SupplementaryData"
definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="SplmtryData"
complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
<messageDefinitionIdentifier
businessArea="acmt"
messageFunctionality="034"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.