ZagTrader

cain: Acquirer to Issuer Card Transaction

cain.020 Amendment

Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked

cain.020 is the ISO 20022 Amendment message in the Acquirer to Issuer Card Transaction business area (cain). The latest version is cain.020.001.03, and 3 versions are in the repository.

Message
Amendment
Latest version
cain.020.001.03
Submitting organisation
ISO TC68/SC9/TG1
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What cain.020 is for

The Amendment message can be initiated by any party and received by any party (acquirer, agent or issuer).

This message is used to inform the originator that the original message has been corrected/amended and then forwarded to the destination on behalf of the originator. It contains a copy of the original message and any errors found. It may also contain any corrections and/or amendments that were made to the original message.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

cain.020 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

VersionRegistration statusPublished in
cain.020.001.03latestRegisteredLatest version set
cain.020.001.02RegisteredPrevious version set
cain.020.001.01RegisteredArchive

cain.020 message structure

The building blocks of cain.020.001.03 to three levels, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

  • Document [1..1]
    • Amdmnt Amendment [1..1]
      • Hdr Header [1..1]Header71

        Information related to the management of the protocol.

        • MsgFctn Message Function [1..1]ExternalMessageFunction1Code

          Identifies the type of process related to the message.

        • PrtcolVrsn Protocol Version [1..1]Max2048Text

          Version of the acquirer to issuer protocol specifications.

        • XchgId Exchange Identification [0..1]Max35Text

          Unique identification of an exchange of messages between two parties.

        • ReTrnsmssnCntr Re Transmission Counter [0..1]Max3NumericText

          Number of retransmission of the message.

        • CreDtTm Creation Date Time [1..1]ISODateTime

          Date and time at which the message was sent.

        • BtchMgmtInf Batch Management Information [0..1]BatchManagementInformation1

          Information related to the batch and the collection to which the message belongs if any.

          • ColltnId Collection Identification [0..1]Max35Text
          • BtchId Batch Identification [1..1]Max35Text
          • MsgSeqNb Message Sequence Number [0..1]Max15NumericText
          • MsgChcksmInptVal Message Checksum Input Value [0..1]Max140Binary
        • InitgPty Initiating Party [1..1]GenericIdentification183

          Unique identification of the partner that has initiated the exchange.

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType17Code
          • OthrTp Other Type [0..1]Max35Text
          • Assgnr Assigner [0..1]PartyType18Code
          • Ctry Country [0..1]ISOMax3ACountryCode
          • ShrtNm Short Name [0..1]Max35Text
        • RcptPty Recipient Party [0..1]GenericIdentification183

          Unique identification of the partner that is the recipient of the message exchange.

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType17Code
          • OthrTp Other Type [0..1]Max35Text
          • Assgnr Assigner [0..1]PartyType18Code
          • Ctry Country [0..1]ISOMax3ACountryCode
          • ShrtNm Short Name [0..1]Max35Text
        • TracData Trace Data [0..*]AdditionalData1

          Information sent in the request message to be returned in the response one, for instance to help in the retrieval of the context of the exchange.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • Tracblt Traceability [0..*]Traceability10

          Identification of partners involved in exchange from the merchant to the issuer, with the relative timestamp of their exchanges.

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType17Code
          • OthrTp Other Type [0..1]Max35Text
          • Assgnr Assigner [0..1]PartyType18Code
          • Ctry Country [0..1]ISOMax3ACountryCode
          • ShrtNm Short Name [0..1]Max35Text
          • DtTmIn Date Time In [0..1]ISODateTime
          • DtTmOut Date Time Out [0..1]ISODateTime
      • Orgtr Originator [0..1]PartyIdentification286

        Identifies the originator of the transaction.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Sndr Sender [0..1]PartyIdentification286

        Party sending the message to another intermediary agent or to the final destination.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Rcvr Receiver [0..1]PartyIdentification286

        Party receiving the message from the origin or from an intermediary agent.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Dstn Destination [0..1]PartyIdentification286

        Identifies the destination of the transaction.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • LglCorpNm Legal Corporate Name [0..1]Max99Text

          Legal Corporate Name of the party

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the party.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
        • LclData Local Data [0..1]LocalData14

          Contains local language equivalent(s) of data in the current component.

          • Lang Language [1..1]ISOMax3ALanguageCode
          • NcodgFrmt Encoding Format [0..1]Max35Text
          • ShrtNm Short Name [0..1]Max70Text
          • LglCorpNm Legal Corporate Name [0..1]Max210Text
          • AddtlData Additional Data [0..*]AdditionalData1
      • Prgrmm Programme [0..*]ProgrammeMode5

        Programme, network, or brand processes the transaction.

        • ApldId Applied Identification [1..1]Max35Text

          Identification of the programme, network, or brand applied to the transaction.

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the program, network, or brand processed the transaction.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
      • Jursdctn Jurisdiction [0..1]Jurisdiction2

        Contains information that identifies or is specific to a transaction jurisdiction.

        • DmstInd Domestic Indicator [0..1]TrueFalseIndicator

          When true, indicates the transaction is considered to be domestic.

        • DmstQlfctn Domestic Qualification [0..1]Max35Text

          Identifies the reason the transaction is considered to be domestic or non-domestic.

      • SttlmSvc Settlement Service [0..1]SettlementService6

        Type of settlement service for specific services requiring settlement.

        • Tp Type [0..1]Max35Text

          Type of settlement service applied

        • Id Identification [0..1]Max35Text

          Identification of settlement service applied.

        • ReqdDt Requested Date [0..1]ISODate

          Date requested for settlement.

        • Dfrrd Deferred [0..1]TrueFalseIndicator

          Indicate a deferred Settlement date.

        • Dt Date [0..1]ISODate

          Actual date of settlement.

        • Tm Time [0..1]ISOTime

          Actual time of settlement.

        • Prd Period [0..1]Max35Text

          Identifies the settlement period, cycle or group.

        • CutOffTm Cut Off Time [0..1]ISODateTime

          Identifies the effective end time of the settlement date and/or period.

        • RptgNttyTp Reporting Entity Type [0..1]Max35Text

          Identifies the type of settlement reporting entity

        • RptgNttyId Reporting Entity Identification [0..1]Max35Text

          Identification of the settlement reporting entity.

        • AddtlInf Additional Information [0..*]AdditionalData1

          Additional Settlement Information.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
      • Rcncltn Reconciliation [0..1]Reconciliation4

        Identification of the reconciliation period between the acquirer and the issuer or their respective agents.

        • Id Identification [0..1]Max35Text

          Identification of the reconciliation.

        • Dt Date [0..1]ISODate

          Date of the reconciliation.

        • ChckptRef Checkpoint Reference [0..1]Max35Text

          A value used to allow a period within a reconciliation date.

      • AmddData Amended Data [1..*]DetailedError1

        Detailed description of an error that caused the message to be corrected/amended.

        • Tp Type [1..1]Max35Text

          Type of error corrected or amendment brought to the message.

        • Desc Description [1..1]Max500Text

          Detailed description of the error or amendment.

        • Val Value [0..1]Max256Text

          Contains the modified value.

      • TxId Transaction Identification [1..1]TransactionIdentification55

        Identification of the transaction.

        • LclDt Local Date [1..1]ISODate

          Local date the transaction takes place at the card acceptor location.

        • LclTm Local Time [0..1]ISOTime

          Local time the transaction takes place at the card acceptor location.

        • TmZone Time Zone [0..1]Max70Text

          Time zone name (for example, as defined by IANA - Internet Assigned Numbers Authority - in the time zone database).

        • PurchsIdrTp Purchase Identifier Type [0..1]PurchaseIdentifierType2Code

          Specifies the type of identifier present in the message.

        • OthrPurchsIdrTp Other Purchase Identifier Type [0..1]Max35Text

          Used when Purchase Identifier Type is Other National or Other Private.

        • PurchsIdr Purchase Identifier [0..1]Max99Text

          Contains a value identifying Invoice Data or Purchase Request Data.

        • TrnsmssnDtTm Transmission Date Time [0..1]ISODateTime

          Date and time expressed in UTC of the message as sent by the initiator.

        • SysTracAudtNb System Trace Audit Number [1..1]Max12NumericText

          Number assigned by a transaction originator to assist in identifying a transaction uniquely.

        • RtrvlRefNb Retrieval Reference Number [1..1]Exact12Text

          Reference supplied by the system retaining the original source information and used to assist in locating that information or a copy thereof.

        • LifeCyclSpprt Life Cycle Support [0..1]LifeCycleSupport1Code

          Indicate the point in the transaction lifecycle at which the lifecycle identifier was assigned.

        • LifeCyclId Life Cycle Identification [0..1]Exact15Text

          Transaction lifecycle identification

        • AuthstnSeqNb Authorisation Sequence Number [0..1]Exact2NumericText

          Contains authorisation sequence number.

        • PresntmntSeqNb Presentment Sequence Number [0..1]Exact2NumericText

          Number used with trace identifier to uniquely identify where a single authorisation was obtained covering a number of financial presentments.

        • PresntmntSeqCnt Presentment Sequence Count [0..1]Exact2NumericText

          Expected maximum number of presentments for this transaction.

        • AuthntcnTkn Authentication Token [0..1]Max35Text

          Code calculated using an algorithm against key transaction data elements that are common to both authorisation and financial messages.

        • LifeCyclIdMssng Life Cycle Identification Missing [0..1]Max70Text

          Reason for not providing a lifecycle trace identification information.

        • AcqrrRefData Acquirer Reference Data [0..1]Max140Text

          Data supplied by an acquirer in an authorisation or financial request, advice or notification that may be required to be provided in a subsequent...

        • AcqrrRefNb Acquirer Reference Number [0..1]Max23NumericText

          Data supplied by an acquirer to assist in identifying a transaction (for example, for researching retrievals and chargebacks).

        • IssrRefData Issuer Reference Data [0..1]Max1000Text

          Data supplied by a card issuer in an authorisation response, financial response message or in a chargeback transaction that the acquirer may be...

        • AssoctdData Associated Data [0..1]TrueFalseIndicator

          Indicates that additional data will be provided in a separate addendum message.

        • AssoctdDataRef Associated Data Reference [0..1]Max70Text

          Reference to additional transaction details to be conveyed separately from this message.

        • AssoctdDataDstn Associated Data Destination [0..1]Max35Text

          Destination value to be used in the subsequent addendum message.

      • OrgnlMsg Original Message [0..1]Max100KBinary

        Original message before correction/amendment.

      • MsgAmdd Message Amended [0..1]Max100KBinary

        Message amended.

      • AddtlData Additional Data [0..*]AdditionalData2

        Contains additional data.

        • Tp Type [0..1]Max35Text

          Type of information.

        • Dtls Details [0..*]AdditionalData1

          Detail of the specific type of data.

          • Tp Type [0..1]Max35Text
          • Val Value [0..1]Max2048Text
      • PrtctdData Protected Data [0..*]ProtectedData2

        Contains protected data and the attributes used to protect the data.

        • CnttTp Content Type [1..1]ContentType3Code

          Type of data protection.

        • EnvlpdData Enveloped Data [0..1]EnvelopedData12

          Consists of an encrypted content of any type and encrypted content-encryption keys for one or more recipients.

          • Vrsn Version [0..1]Number
          • Rcpt Recipient [1..*]Recipient7Choice (choice)
          • NcrptdCntt Encrypted Content [0..1]EncryptedContent8
        • NcrptdData Encrypted Data [0..1]EncryptedData2

          Contains encrypted data and the attributes used to encrypt the data using the ISO 13492 methods for data encryption.

          • Ctrl Control [0..1]Exact1HexBinaryText
          • KeySetIdr Key Set Identifier [0..1]Max8NumericText
          • DrvdInf Derived Information [0..1]Max32HexBinaryText
          • Algo Algorithm [0..1]Max2NumericText
          • KeyLngth Key Length [0..1]Max4NumericText
          • KeyPrtcn Key Protection [0..1]Max2NumericText
          • KeyIndx Key Index [0..1]Max5NumericText
          • PddgMtd Padding Method [0..1]Max2NumericText
          • NcrptdFrmt Encrypted Format [0..1]Max2NumericText
          • NcrptdElmt Encrypted Element [1..*]EncryptedDataElement2
      • SplmtryData Supplementary Data [0..*]SupplementaryData1

        Additional information that can not be captured in the structured fields and/or other specific block.

        • PlcAndNm Place And Name [0..1]Max350Text

          Unambiguous reference to the location where the supplementary data must be inserted in the message instance.

        • Envlp Envelope [1..1]SupplementaryDataEnvelope1

          Technical element wrapping the supplementary data.

      • SctyTrlr Security Trailer [0..1]ContentInformationType41

        Trailer of the message containing a MAC

        • MACData MAC Data [1..1]MACData1

          Type of data protection.

          • Ctrl Control [1..1]Exact1HexBinaryText
          • KeySetIdr Key Set Identifier [1..1]Max8NumericText
          • DrvdInf Derived Information [0..1]Max32HexBinaryText
          • Algo Algorithm [1..1]Max2NumericText
          • KeyLngth Key Length [0..1]Max4NumericText
          • KeyPrtcn Key Protection [0..1]Max2NumericText
          • KeyIndx Key Index [0..1]Max5NumericText
          • PddgMtd Padding Method [0..1]Max2NumericText
          • InitlstnVctr Initialisation Vector [0..1]Max32HexBinaryText
        • MAC MAC [1..1]Max8HexBinaryText

          Message Authentication Code data.

Have a cain.020 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in cain.020

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

cain.020 questions

What is the latest version of cain.020?
The latest version in the ISO 20022 e-Repository release of 24 April 2025 is cain.020.001.03.
What is the root element of cain.020?
The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:cain.020.001.03, and its message element is Amdmnt (Amendment).
Is there an MT equivalent of cain.020?
No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.