ZagTrader

caaa: Acceptor to Acquirer Card Transaction

caaa.018 Acceptor Currency Conversion Advice

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

caaa.018 is the ISO 20022 AcceptorCurrencyConversionAdvice message in the Acceptor to Acquirer Card Transaction business area (caaa). The latest version is caaa.018.001.09, and 9 versions are in the repository.

Message
AcceptorCurrencyConversionAdvice
Latest version
caaa.018.001.09
Submitting organisation
nexo
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What caaa.018 is for

The AcceptorCurrencyConversionAdvice message is sent by the card acceptor to inform the currency conversion service provider of the outcome of the card currency conversion.

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

caaa.018 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
caaa.018.001.09latestRegisteredLatest version set
caaa.018.001.08RegisteredPrevious version set
caaa.018.001.07RegisteredArchive
caaa.018.001.06RegisteredArchive
caaa.018.001.05RegisteredArchive
caaa.018.001.04RegisteredArchive
caaa.018.001.03RegisteredArchive
caaa.018.001.02RegisteredArchive
caaa.018.001.01RegisteredArchive

caaa.018 message structure

The building blocks of caaa.018.001.09 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]
    • AccptrCcyConvsAdvc AcceptorCurrencyConversionAdvice [1..1]
      • Hdr Header [1..1]Header70

        Currency Conversion request message management information.

        • MsgFctn Message Function [1..1]MessageFunction46Code

          Identifies the type of process related to the message.

        • PrtcolVrsn Protocol Version [1..1]Max6Text

          Version of the acquirer protocol specifications.

        • XchgId Exchange Identification [1..1]Number

          Unique identification of an exchange occurrence.

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

          Number of retransmissions of the message.

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

          Date and time at which the message was created.

        • InitgPty Initiating Party [1..1]GenericIdentification176

          Unique identification of the partner that has initiated the exchange.

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType33Code
          • Issr Issuer [0..1]PartyType33Code
          • Ctry Country [0..1]Min2Max3AlphaText
          • ShrtNm Short Name [0..1]Max35Text
        • RcptPty Recipient Party [0..1]GenericIdentification177

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

          • Id Identification [1..1]Max35Text
          • Tp Type [0..1]PartyType33Code
          • Issr Issuer [0..1]PartyType33Code
          • Ctry Country [0..1]Min2Max3AlphaText
          • ShrtNm Short Name [0..1]Max35Text
          • RmotAccs Remote Access [0..1]NetworkParameters7
          • Glctn Geolocation [0..1]Geolocation1
        • Tracblt Traceability [0..*]Traceability8

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

          • RlayId Relay Identification [1..1]GenericIdentification177
          • PrtcolNm Protocol Name [0..1]Max35Text
          • PrtcolVrsn Protocol Version [0..1]Max6Text
          • TracDtTmIn Trace Date Time In [1..1]ISODateTime
          • TracDtTmOut Trace Date Time Out [1..1]ISODateTime
      • AccptrCcyConvsAdvc Acceptor Currency Conversion Advice [1..1]AcceptorCurrencyConversionAdvice9

        Information related to the outcome of the currency conversion.

        • Envt Environment [1..1]CardPaymentEnvironment81

          Environment of the transaction.

          • Acqrr Acquirer [0..1]Acquirer10
          • SvcPrvdr Service Provider [0..1]Acquirer10
          • Mrchnt Merchant [0..1]Organisation41
          • POI POI [0..1]PointOfInteraction15
          • Card Card [0..1]PaymentCard35
          • Chck Check [0..1]Check1
          • StordValAcct Stored Value Account [0..*]StoredValueAccount2
          • LltyAcct Loyalty Account [0..*]LoyaltyAccount3
          • CstmrDvc Customer Device [0..1]CustomerDevice3
          • Wllt Wallet [0..1]CustomerDevice3
          • PmtTkn Payment Token [0..1]Token1
          • MrchntTkn Merchant Token [0..1]MerchantToken2
          • Crdhldr Cardholder [0..1]Cardholder21
          • PrtctdCrdhldrData Protected Cardholder Data [0..1]ContentInformationType40
          • SaleEnvt Sale Environment [0..1]RetailerSaleEnvironment2
        • Tx Transaction [1..1]CardPaymentTransaction137

          Currency conversion of a card payment transaction between an acceptor and a currency conversion provider.

          • SaleRefId Sale Reference Identification [0..1]Max35Text
          • TxId Transaction Identification [1..1]TransactionIdentifier1
          • InitrTxId Initiator Transaction Identification [0..1]Max35Text
          • RcptTxId Recipient Transaction Identification [0..1]Max140Text
          • RcncltnId Reconciliation Identification [0..1]Max35Text
          • IntrchngData Interchange Data [0..1]Max140Text
          • TxDtls Transaction Details [1..1]CardPaymentTransactionDetails53
          • MrchntRefData Merchant Reference Data [0..1]Max70Text
        • CcyConvsRslt Currency Conversion Result [0..1]CurrencyConversion30

          Result of the currency conversion proposed to the cardholder and its result.

          • AccptdByCrdhldr Accepted By Cardholder [0..1]TrueFalseIndicator
          • Convs Conversion [0..1]CurrencyConversion29
      • SctyTrlr Security Trailer [0..1]ContentInformationType37

        Trailer of the message containing a MAC.

        • CnttTp Content Type [1..1]ContentType2Code

          Type of data protection.

        • AuthntcdData Authenticated Data [1..1]AuthenticatedData10

          Data protection by a message authentication code (MAC).

          • Vrsn Version [0..1]Number
          • Rcpt Recipient [1..*]Recipient15Choice (choice)
          • MACAlgo MAC Algorithm [1..1]AlgorithmIdentification31
          • NcpsltdCntt Encapsulated Content [1..1]EncapsulatedContent3
          • MAC MAC [1..1]Max140Binary

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

caaa.018 questions

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