ISO 20022 Advices | camt.054
The camt.054.001.008 (camt.054), also known as the BankToCustomerDebitCreditNotification message, is sent to an account owner or to a financial institution authorized by the account owner. It is used to notify the account owner of any debit or credit entry reported to the account. This ISO 20022 message offers the same functionality as both the MT 900 Confirmation of Debit and the MT 910 Confirmation of Credit messages, while both MT advices continue to remain in use.
The ISO 20022 messaging standards for debit and credit notification are defined as follows:
camt.054 Debit Notification (MT 900 equivalent)
It is used to notify the account owner of an entry which has been debited to its account. A camt.054 debit advice can be identified by the value DBIT in the tag /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/CdtDbtInd.
camt.054 Credit Notification (MT 910 equivalent)
It is used to notify the account owner of an entry which has been credited to its account. A camt.054 credit advice can be identified by the value CRDT in the tag /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/CdtDbtInd.
MT to camt.054 Field Mapping
MT 900 (Debit Confirmation) → camt.054 Mapping
| MT 900 Tag | Sub-Field | Field Name | camt.054 XML Path |
|---|---|---|---|
| 20 | — | Transaction Reference Number | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/TxId |
| 21 | — | Related Reference | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/EndToEndId |
| 25a | Account | Account Identification | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Acct/Id/IBAN OR /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Acct/Id/Othr/Id |
| 13D | Date & Time | Date/Time Indication | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/BookgDt/DtTm |
| 32A | 1: Value Date | Value Date | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/ValDt/Dt |
| 32A | 2: Currency Code | Currency | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Amt/@Ccy |
| 32A | 3: Amount | Amount | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Amt |
| 52a | — | Ordering Institution | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdAgts/DbtrAgt/FinInstnId/BICFI |
| 72 | /EREF/ | End-to-End Reference | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/EndToEndId |
| 72 | /CREF/ | Clearing System Reference | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/ClrSysRef |
| 72 | /CACT/ | Creditor Account Number | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/CdtrAcct/Id/IBAN OR /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/CdtrAcct/Id/Othr/Id |
| 72 | /CBIC/ | Creditor Agent BIC | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdAgts/CdtrAgt/FinInstnId/BICFI |
| 72 | /CRNM/ | Creditor Name | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/Cdtr/Pty/Nm |
| 72 | /REMI/ | Remittance Information | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RmtInf/Ustrd |
MT 910 (Credit Confirmation) → camt.054 Mapping
| MT 910 Tag | Sub-Field | Field Name | camt.054 XML Path |
|---|---|---|---|
| 20 | — | Transaction Reference Number | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/TxId |
| 21 | — | Related Reference | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/EndToEndId |
| 25a | Account | Account Identification | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Acct/Id/IBAN OR /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Acct/Id/Othr/Id |
| 13D | Date & Time | Date/Time Indication | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/BookgDt/DtTm |
| 32A | 1: Value Date | Value Date | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/ValDt/Dt |
| 32A | 2: Currency Code | Currency | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Amt/@Ccy |
| 32A | 3: Amount | Amount | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Amt |
| 50a | — | Ordering Customer | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/Dbtr/Pty/Nm AND /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/DbtrAcct/Id/IBAN |
| 52a | — | Ordering Institution | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdAgts/DbtrAgt/FinInstnId/BICFI |
| 56a | — | Intermediary | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdAgts/IntrmyAgt1/FinInstnId/BICFI |
| 72 | /EREF/ | End-to-End Reference | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/EndToEndId |
| 72 | /CREF/ | Clearing System Reference | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/Refs/ClrSysRef |
| 72 | /DACT/ | Debtor Account Number | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/CdtrAcct/Id/IBAN OR /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/CdtrAcct/Id/Othr/Id |
| 72 | /DBIC/ | Debtor Agent BIC | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdAgts/DbtrAgt/FinInstnId/BICFI |
| 72 | /DBNM/ | Debtor Name | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RltdPties/Dbtr/Pty/Nm |
| 72 | /REMI/ | Remittance Information | /Document/BkToCstmrDbtCdtNtfctn/Ntfctn/Ntry/NtryDtls/TxDtls/RmtInf/Ustrd |
camt.054 Tag details
| Tag Depth | XML Tag | Tag name | Multiplicity | Format/Length | Usage |
|---|---|---|---|---|---|
| Tag Depth | XML Tag | Tag name | Multiplicity | Format/Length | Usage |
| + | AppHdr | Application Header | [1..1] | ||
| ++ | Fr | From | [1..1] | BIC takes the preference | |
| +++ | FIId | Financial Institution Identification | [1..1] | Unique and unambiguous identification of the financial institution | |
| ++++ | FinInstnId | Financial Institution Identification | [1..1] | ||
| +++++ | BIC | BIC | [1..1] | Text/35 | BIC of the financial institution |
| ++ | To | To | [1..1] | BIC takes the preference | |
| +++ | FIId | Financial Institution Identification | [1..1] | Unique and unambiguous identification of the financial institution | |
| ++++ | FinInstnId | Financial Institution Identification | [1..1] | ||
| +++++ | BIC | BIC | [1..1] | Text/35 | BIC of the financial institution |
| ++ | BizMsgIdr | Business Message Identifier | [1..1] | Text/35 | Contains the Message ID of Group Header of the underlying payment instruction |
| ++ | MsgDefIdr | Message Definition Identifier | [1..1] | Text/35 | Identifies the message type: camt.054.001.08 |
| ++ | BizSvc | Business Service | [1..1] | Text/35 | swift.cbprplus.03 |
| ++ | CreDt | Creation Date | [1..1] | Date and time when this Business Message (header) was created | |
| + | Document | ||||
| + | BkToCstmrDbtCdtNtfctn | Bank To Customer Debit Credit Notification V08 (camt.054.001.08) | |||
| +++ | GrpHdr | Group Header | [1..1] | ||
| ++++ | MsgId | Message Identification | [1..1] | 35 | Bank generated unique ID |
| ++++ | CreDtTm | Creation Date Time | [1..1] | Timestamp for file creation | |
| ++++ | MsgRcpt | Message Recipient | [0..1] | ||
| +++++ | Nm | Name | [0..1] | 140 | Your legal name |
| +++++ | Id | Identification | [0..1] | ||
| ++++++ | OrgId | Organisation Identification | [1..1] | ||
| +++++++ | Othr | Other | [0..2] | ||
| ++++++++ | Id | Identification | [1..1] | GS provided client ID | |
| +++ | Ntfctn | Notification | [1..*] | ||
| ++++ | Id | Identification | [1..1] | 35 | Unique report ID |
| ++++ | NtfctnPgntn | Notification Pagination | [0..1] | ||
| +++++ | PgNb | Page Number | [1..1] | Provides detail on the page number of the statement | |
| +++++ | LastPgInd | Last Page Indicator | [1..1] | boolean | True if last page of the report |
| ++++ | ElctrncSeqNb | Electronic Sequence Number | [0..1] | 18 | Electronic sequence number For both intraday and EoD reports, the value will be 1 for the first report/statement and will increase incrementally per report/statement tag. It will reset to 1 only when the 18-digit limit is exhausted |
| ++++ | LglSeqNb | Legal Sequence Number | [0..1] | 18 | Legal Sequence Number .For both intraday and EoD reports, the value will be 1 for the first report/statement and will increase incrementally per report/statement tag. It will reset to 1 only when the 18-digit limit is exhausted |
| ++++ | CreDtTm | Creation Date Time | [0..1] | Timestamp for creation of report (Could be different from file creation date/ time in case the report for the given account in the report is generated at a different time & compiled in 1 file) | |
| ++++ | FrToDt | From To Date | [0..1] | ||
| +++++ | FrDtTm | From Date Time | [1..1] | Report start date & time | |
| +++++ | ToDtTm | To Date Time | [1..1] | Report end date & time | |
| ++++ | Acct | Account | [1..1] | ||
| +++++ | Id | Identification | [1..1] | ||
| ++++++ | IBAN | IBAN | [1..1] | IBAN of the account for which the report is being generated | |
| ++++++ | Othr | Other | [1..1] | ||
| +++++++ | Id | Identification | [1..1] | 34 | Account number for which the report is being generated |
| +++++ | Tp | Type | [0..1] | ||
| ++++++ | Prtry | Proprietary | [1..1] | 35 | Account type with GS Bank (DDA/ VA/ TDA) |
| +++++ | Ccy | Currency | [1..1] | 3 | Account currency |
| +++++ | Nm | Name | [0..1] | 140 | Account name |
| +++++ | Svcr | Servicer | [0..1] | ||
| ++++++ | FinInstnId | Financial Institution Identification | [1..1] | ||
| +++++++ | BIC | BICFI | [0..1] | Account's bank BIC | |
| +++++++ | ClrSysMmbId | Clearing System Member Identification | [0..1] | ||
| ++++++++ | ClrSysId | Clearing System Identification | [1..1] | ||
| +++++++++ | Cd | Code | [1..1] | Account’s bank clearing system code, i.e. GBDSC for UK Sort code | |
| ++++++++ | MmbId | Member Identification | [1..1] | 35 | Account bank’s clearing system identifier |
| +++++++ | Nm | Name | [0..1] | 140 | Account agent's bank name |
| ++++ | TxsSummry | Transactions Summary | [0..1] | ||
| +++++ | TtlNtries | Total Entries | [0..1] | ||
| ++++++ | NbOfNtries | Number Of Entries | [0..1] | 15 | Number of entries in the account report |
| ++++++ | Sum | Sum | [0..1] | Sum of transactions in the account report | |
| ++++++ | TtlNetNtry | Total Net Entry | [0..1] | Net value of transactions in the account report | |
| +++++++ | Amt | Amount | [1..1] | Resulting amount of the netted amounts for all debit and credit entries. | |
| +++++++ | CdtDbtInd | Credit Debit Indicator | [1..1] | 4 | Net amount credit/ debit indicator CRDT= Positive balance DEBT= Negative balance |
| +++++ | TtlCdtNtries | Total Credit Entries | [0..1] | ||
| ++++++ | NbOfNtries | Number Of Entries | [0..1] | 15 | Number of entries in the account report |
| ++++++ | Sum | Sum | [0..1] | Sum of transactions in the account report | |
| +++++ | TtlDbtNtries | Total Debit Entries | [0..1] | Net value of transactions in the account report | |
| ++++++ | NbOfNtries | Number Of Entries | [0..1] | 15 | Total number of debit entries in the account report |
| ++++++ | Sum | Sum | [0..1] | Sum of debit entries in the account report | |
| ++++ | Ntry | Entry | [1..*] | ||
| +++++ | NtryRef | Entry Reference | [1..1] | 35 | Bank generated unique ID |
| +++++ | "AmtCcy="AAA | Amount | [1..1] | Transaction amount with currency | |
| +++++ | CdtDbtInd | Credit Debit Indicator | [1..1] | 4 | Transaction credit/ debit indicator |
| +++++ | RvslInd | Reversal Indicator | [0..1] | true/false | True in case of reject or return scenarios |
| +++++ | Sts | Status | [1..1] | ||
| ++++++ | Cd | Code | [1..1] | Always "BOOK" | |
| +++++ | BookgDt | Booking Date | [0..1] | ||
| ++++++ | DtTm | Date Time | [1..1] | Transaction posting date & time | |
| +++++ | ValDt | Value Date | [0..1] | ||
| ++++++ | Dt | Date | [1..1] | YYYY-MM-DD | Transaction value date |
| +++++ | BkTxCd | Bank Transaction Code | [1..1] | ||
| ++++++ | Domn | Domain | [0..1] | ||
| +++++++ | Cd | Code | [1..1] | 35 | GS proprietary transaction type |
| +++++++ | Fmly | Family | [1..1] | ||
| ++++++++ | Cd | Code | [1..1] | Specifies the family within a domain. | |
| ++++++++ | SubFmlyCd | Sub Family Code | [1..1] | Specifies the sub-product family within a specific family. | |
| ++++++ | Prtry | Proprietary | [0..1] | ||
| +++++++ | Cd | Code | [1..1] | GS proprietary transaction type | |
| +++++++ | Issr | Issuer | [1..1] | Identification of the issuer of the proprietary bank transaction code. | |
| +++++ | NtryDtls | Entry Details | [0..*] | ||
| ++++++ | TxDtls | Transaction Details | [0..*] | ||
| +++++++ | Refs | References | [1..1] | ||
| ++++++++ | MsgId | Message Identification | [0..1] | 35 | File message ID if payment was initiated via a file |
| ++++++++ | AcctSvcrRef | Account Servicer Reference | [0..1] | 35 | Goldman Sachs Bank Unique Payment ID |
| ++++++++ | InstrId | Instruction Identification | [1..1] | 35 | Payment instruction ID (payment ID) if payment was initiated via file |
| ++++++++ | EndToEndId | End To End Identification | [0..1] | 35 | End to end ID (unique payment ID for the payment) if payment was inititated via file |
| ++++++++ | UETR | UETR | [0..1] | Text/35 | Universally unique identifier to provide an end-to-end reference of a payment transaction. |
| ++++++++ | TxId | Transaction Identification | [0..1] | 35 | GS Unique Payment ID in most cases, will contain the original Payment ID for returns |
| ++++++++ | ClrSysRef | Clearing System Reference | [0..1] | 35 | Clearing system reference ID for the respective clearing system used (IMAD for fedwire) |
| +++++++ | AmtCcy="AAA" | Amount | [1..1] | Transaction amount with payment currency | |
| +++++++ | CdtDbtInd | Credit Debit Indicator | [1..1] | 4 | Net amount credit/ debit indicator CRDT= Positive balance DEBT= Negative balance |
| +++++++ | AmtDtls | Amount Details | [0..1] | ||
| ++++++++ | InstdAmt | Instructed Amount | [0..1] | ||
| +++++++++ | AmtCcy="AAA" | Amount | [1..1] | Transaction amount with payment currency | |
| ++++++++ | TxAmt | Transaction Amount | [0..1] | ||
| +++++++++ | AmtCcy="AAA" | Amount | [1..1] | Amount in account currency | |
| +++++++ | RltdPties | Related Parties | [0..1] | ||
| ++++++++ | Dbtr | Debtor | [0..1] | ||
| +++++++++ | Pty | Party | [1..1] | ||
| ++++++++++ | Nm | Name | [0..1] | 140 | Debit party name |
| ++++++++++ | Id | Identification | [0..1] | ||
| +++++++++++ | OrgId | Organisation Identification | [1..1] | ||
| ++++++++++++ | AnyBIC | Any BIC | [0..1] | Debit party BIC | |
| ++++++++ | DbtrAcct | Debtor Account | [0..1] |