ZagTrader

cain: Acquirer to Issuer Card Transaction

cain.025 Addendum Initiation

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

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

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

In use: published in the current ISO 20022 catalogue.

What cain.025 is for

Provides supplemental data in addition to that which is required to complete an authorization initiation or financial initiation.

The supplemental data is associated with an authorization or financial message.

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

cain.025 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.025.001.03latestRegisteredLatest version set
cain.025.001.02RegisteredPrevious version set
cain.025.001.01RegisteredArchive

cain.025 message structure

The building blocks of cain.025.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]
    • AdddmInitn AddendumInitiation [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.

        • 3 more elements not shown
      • DataSrc Data Source [0..1]Max70Text

        Indicates the source of enhanced data.

      • 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 actually applied to 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.

        • 9 more elements not shown
      • 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.

        • 4 more elements not shown
      • OrgnlDataElmts Original Data Elements [0..1]OriginalDataElements3

        Data elements contained in the original transaction

        • 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.

        • 4 more elements not shown
      • Accptr Acceptor [0..1]PartyIdentification288

        Card acceptor performing the card transaction.

        • Id Identification [1..1]Max35Text

          Identification of the acceptor.

        • Assgnr Assigner [0..1]Max35Text

          Identification of the entity assigning an identification to the acceptor.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the acceptor.

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

          Legal Corporate Name of the party.

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification assigned by an agent to an acceptor.

        • NmAndLctn Name And Location [1..1]Max99Text

          Name and location of acceptor.

        • Adr Address [0..1]Address2

          Address of the entity.

        • 22 more elements not shown
      • Cstmr Customer [0..1]Customer4

        Information about the customer.

        • Tp Type [0..1]CustomerType2Code

          Type of customer.

        • RefNb Reference Number [0..1]Max35Text

          Reference number provided by a cardholder or customer to card acceptor to facilitate communication and record keeping.

        • TaxRegnId Tax Registration Identification [0..*]Max70Text

          Identification of the customer recognized by the taxation authority.

        • AuthrsdCtctCpny Authorised Contact Company [0..1]Max70Text

          Contact at the company.

        • AuthrsdCtctNm Authorised Contact Name [0..1]Max70Text

          Corporate individual or company (cardholder or their company) to be contacted for authorised purchases.

        • AuthrsdCtctPhneNb Authorised Contact Phone Number [0..1]PhoneNumber

          Phone number of an individual or company contacted for company authorised purchases.

        • VIPInd VIP Indicator [0..1]TrueFalseIndicator

          Very Important Person indicator.

        • 1 more elements not shown
      • 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.

        • 4 more elements not shown
      • 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.

        • 6 more elements not shown
      • 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.

      • 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.

      • AdddmData Addendum Data [0..1]AddendumData6

        Component contains data structures applicable to certain industries that require specific data within transaction messages.

        • Sale Sale [0..1]Sale3

          Details of good and services included in the sale.

        • Fleet Fleet [0..1]FleetData6

          Fleet data pertaining to the payment transaction.

        • Invc Invoice [0..1]Invoice3

          Invoice data pertaining to the payment transaction.

        • TrvlAgcy Travel Agency [0..*]TravelAgency4

          Component supports corporate transactions for travel agency, airline, or railway transactions.

        • PssngrTrnsprt Passenger Transport [0..1]PassengerTransport3

          Component supports ticketing transactions for airline, railway, and travel agency transactions to provide passenger ticket information for the...

        • VhclRntl Vehicle Rental [0..*]VehicleRentalService3

          Component provides detailed vehicle rental information.

        • Ldgg Lodging [0..*]Lodging4

          Component provides detailed information about lodging accommodations and related expenses for the cardholder.

        • 4 more elements not shown
      • 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.025 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.025

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.025 questions

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