What is the latest version of cain.026?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is cain.026.001.03.

What is the root element of cain.026?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:cain.026.001.03, and its message element is AdddmRspn (AddendumResponse).

Is there an MT equivalent of cain.026?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

cain: Acquirer to Issuer Card Transaction

cain.026 Addendum Response

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

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

Message: AddendumResponse
Latest version: cain.026.001.03
Submitting organisation: ISO TC68/SC9/TG1
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What cain.026 is for

The AddendumResponse message is sent by an issuer or an agent to an acquirer in response to an AddendumInitiation message.

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

cain.026 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.

Version	Registration status	Published in
cain.026.001.03latest	Registered	Latest version set
cain.026.001.02	Registered	Previous version set
cain.026.001.01	Registered	Archive

cain.026 message structure

The building blocks of cain.026.001.03 and the elements directly under them, 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]
- AdddmRspn AddendumResponse [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.
    - InitgPty Initiating Party [1..1]GenericIdentification183
      Unique identification of the partner that has initiated the exchange.
    - RcptPty Recipient Party [0..1]GenericIdentification183
      Unique identification of the partner that is the recipient of the message exchange.
    - 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.
    - Tracblt Traceability [0..*]Traceability10
      Identification of partners involved in exchange from the merchant to the issuer, with the relative timestamp of their exchanges.
  - TxDesc Transaction Description [0..1]Max1000Text
    Transaction data related to programmes and services, content and format based on bilateral agreements.
  - 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.
    - LclData Local Data [0..1]LocalData14
      Contains local language equivalent(s) of data in the current component.
  - Acqrr Acquirer [1..1]PartyIdentification286
    Identification of the acquirer.
    - 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.
    - LclData Local Data [0..1]LocalData14
      Contains local language equivalent(s) of data in the current component.
  - 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.
    - LclData Local Data [0..1]LocalData14
      Contains local language equivalent(s) of data in the current component.
  - Card Card [0..1]CardData14
    Card or payment token performing the transaction.
    - PAN PAN [0..1]Max19NumericText
      Primary Account Number (PAN) of the card or a surrogate of the PAN such as a payment token.
    - CardSeqNb Card Sequence Number [0..1]Min2Max3NumericText
      Distinguishes between instances of the same payment card.
    - PmtAcctRef Payment Account Reference [0..1]Max35Text
      Unique non-financial reference assigned to a given PAN.
    - PrtflIdr Portfolio Identifier [0..1]Max35Text
      Identifies the card portfolio.
  - 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.
    - LclData Local Data [0..1]LocalData14
      Contains local language equivalent(s) of data in the current component.
  - Issr Issuer [0..1]PartyIdentification286
    Information related to the issuer.
    - 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.
    - LclData Local Data [0..1]LocalData14
      Contains local language equivalent(s) of data in the current component.
  - 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.
    - LclData Local Data [0..1]LocalData14
      Contains local language equivalent(s) of data in the current component.
  - 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.
  - TxId Transaction Identification [1..1]TransactionIdentification53
    Identification of the transaction.
    - 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 [0..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.
    - 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...
    - AssoctdDataRef Associated Data Reference [0..1]Max70Text
      Reference to additional transaction details to be conveyed separately from this message.
  - OrgnlDataElmts Original Data Elements [0..1]OriginalDataElements3
    Data elements contained in the original message.
    - MsgClss Message Class [0..1]MessageClass1Code
      Message class of the original message.
    - MsgFctn Message Function [0..1]MessageFunction16Code
      Identifies the type of process related to the message.
    - AcqrrId Acquirer Identification [0..1]Max11NumericText
      Code identifying the acquirer of the original message.
    - SndrId Sender Identification [0..1]Max11NumericText
      Code identifying the sender of the original message.
    - TxTp Transaction Type [0..1]ISO8583TransactionTypeCode
      Type of transaction associated with the main service.
    - TxId Transaction Identification [0..1]OriginalTransactionIdentification1
      Identification of the transaction.
    - ConvsDtTm Conversion Date Time [0..1]DateTime2
      Date and Time of currency conversion.
    - TxAmts Transaction Amounts [0..1]OriginalTransactionAmounts3
      Amounts of the card transaction.
    - AddtlFee Additional Fee [0..*]AdditionalFee3
      Fees not included in the transaction amount.
    - RspnCd Response Code [0..1]ISO8583ResponseCode
      Detailed results of the processing, conforming to ISO 8583 Response codes list.
    - ApprvlCd Approval Code [0..1]Exact6AlphaNumericText
      Value assigned by the entity when the transaction is approved.
  - Tkn Token [0..1]Token2
    Details of payment token.
    - PmtTkn Payment Token [0..1]Max19NumericText
      Surrogate value of the PAN.
    - TknXpryDt Token Expiry Date [0..1]ISOYearMonth
      Expiry date of the payment token.
    - TknRqstrId Token Requestor Identification [0..1]Max11NumericText
      Identification of a party requesting a token.
    - TknAssrncData Token Assurance Data [0..1]Max140Text
      Supporting information for the Token Assurance Method.
    - TknAssrncMtd Token Assurance Method [0..1]Max2NumericText
      Value that allows a Token Service Provider to indicate the identification and verification performed representing the binding of the payment token to...
    - TknInittdInd Token Initiated Indicator [0..1]TrueFalseIndicator
      Original transaction was initiated by Token.
    - StorgLctn Storage Location [0..1]StorageLocation1Code
      Storage location of the token.
    - OthrStorgLctn Other Storage Location [0..1]Max35Text
      Other private or national storage location code.
    - PrtcnMtd Protection Method [0..1]ProtectionMethod1Code
      Method used to protect the token.
    - OthrPrtcnMtd Other Protection Method [0..1]Max35Text
      Other national or private protection method code.
    - AddtlData Additional Data [0..*]AdditionalData1
      Additional token data.
  - Accptr Acceptor [0..1]PartyIdentification285
    Card acceptor performing the card transaction.
    - Id Identification [1..1]Max35Text
      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.
    - LclData Local Data [0..*]LocalData14
      Contains local language equivalent(s) of data in the current component.
  - 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.
  - AddtlFee Additional Fee [0..*]AdditionalFee3
    Fees not included in the transaction amount.
    - Tp Type [1..1]TypeOfAmount21Code
      Type or class of fee.
    - OthrTp Other Type [0..1]Max35Text
      Additional information to specify the type of amount of fee.
    - Prgm Program [0..1]Max35Text
      Identification of fee program.
    - Dscrptr Descriptor [0..1]Max35Text
      Identification of specific fee.
    - CdtDbt Credit Debit [0..1]CreditDebit3Code
      Contains code list for a credit or debit transaction
    - Amt Amount [1..1]ImpliedCurrencyAndAmount
      Amount exclusive of currency.
    - Ccy Currency [0..1]ISO3NumericCurrencyCode
      Currency for the type of amount.
    - RcncltnAmt Reconciliation Amount [0..1]ImpliedCurrencyAndAmount
      Amount of the transaction in Reconciliation currency
    - RcncltnCcy Reconciliation Currency [0..1]ISO3NumericCurrencyCode
      Currency code of Reconciliation and associated with Reconciliation amount.
    - RcncltnFctvXchgRate Reconciliation Effective Exchange Rate [0..1]BaseOne25Rate
      Effective exchange rate used in the conversion from transaction amount to reconciliation amount.
    - Assgnr Assigner [0..1]PartyType32Code
      A code to identify the type of party who assign the fee.
    - OthrAssgnr Other Assigner [0..1]Max35Text
      Other type of party that assign the fee.
    - Desc Description [0..1]Max140Text
      Short description of the fee amount.
  - 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.
  - PrcgRslt Processing Result [1..1]ProcessingResult23
    Outcome of the processing of the addendum initiation.
    - RspnSrcId Response Source Identification [0..1]Max35Text
      Identification of response source.
    - RspnSrcTp Response Source Type [0..1]PartyType26Code
      Type of response source.
    - RspnSrcOthrTp Response Source Other Type [0..1]Max35Text
      Other type of response source.
    - RspnSrcAssgnr Response Source Assigner [0..1]PartyType9Code
      Entity that assigns the identification for the response source.
    - RspnSrcCtry Response Source Country [0..1]ISOMax3ACountryCode
      Country of the response source
    - RspnSrcShrtNm Response Source Short Name [0..1]Max35Text
      Short name of the response source
    - RspnCd Response Code [1..1]ISO8583ResponseCode
      Response code defined in ISO 8583.
    - ErrDtl Error Detail [0..*]ErrorDetails3
      Error detail information.
    - AddtlInf Additional Information [0..*]AdditionalData1
      Additional information relevant for the destination.
  - 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.
  - 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.
    - 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.
  - 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.
    - MAC MAC [1..1]Max8HexBinaryText
      Message Authentication Code data.

Have a cain.026 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.026

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

ExternalMessageFunction1Code14 codes

cain.026 questions

What is the latest version of cain.026?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is cain.026.001.03.
What is the root element of cain.026?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:cain.026.001.03, and its message element is AdddmRspn (AddendumResponse).
Is there an MT equivalent of cain.026?: 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.