caaa.001 Acceptor Authorisation Request

What caaa.001 is for

caaa.001 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.

caaa.001 message structure

The building blocks of caaa.001.001.14 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]
  • AccptrAuthstnReq AcceptorAuthorisationRequest [1..1]
    • Hdr Header [1..1]Header70

      Authorisation 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
    • AuthstnReq Authorisation Request [1..1]AcceptorAuthorisationRequest14

      Information related to the authorisation request.

      • 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
      • Cntxt Context [1..1]PaymentContext30

        Context in which the transaction is performed (payment and sale).

        • PmtCntxt Payment Context [0..1]PaymentContext29
        • SaleCntxt Sale Context [0..1]SaleContext4
        • CdtTrfCntxt Credit Transfer Context [0..1]CreditTransferContext1
        • DrctDbtCntxt Direct Debit Context [0..1]DirectDebitContext1
      • Tx Transaction [1..1]CardPaymentTransaction139

        Card payment transaction for which the authorisation is requested.

        • TxCaptr Transaction Capture [1..1]TrueFalseIndicator
        • TxTp Transaction Type [0..1]CardPaymentServiceType12Code
        • AddtlSvc Additional Service [0..*]CardPaymentServiceType9Code
        • SvcAttr Service Attribute [0..1]CardPaymentServiceType15Code
        • LastTxFlg Last Transaction Flag [0..1]TrueFalseIndicator
        • MrchntCtgyCd Merchant Category Code [0..1]Min3Max4Text
        • CstmrCnsnt Customer Consent [0..1]TrueFalseIndicator
        • CardPrgrmmPropsd Card Programme Proposed [0..*]Max35Text
        • CardPrgrmmApld Card Programme Applied [0..1]Max35Text
        • SaleRefId Sale Reference Identification [0..1]Max35Text
        • TxId Transaction Identification [1..1]TransactionIdentifier1
        • OrgnlTx Original Transaction [0..1]CardPaymentTransaction138
        • InitrTxId Initiator Transaction Identification [0..1]Max35Text
        • RcncltnId Reconciliation Identification [0..1]Max35Text
        • IssrCITId Issuer CIT Identification [0..1]Max140Text
        • MrchntCITId Merchant CIT Identification [0..1]Max140Text
        • TxDtls Transaction Details [1..1]CardPaymentTransactionDetails53
        • MrchntRefData Merchant Reference Data [0..1]Max70Text
        • AcctFr Account From [0..1]CardAccount16
        • AcctTo Account To [0..1]CardAccount16
        • AddtlTxData Additional Transaction Data [0..*]Max70Text
      • SplmtryData Supplementary Data [0..*]SupplementaryData1

        Additional information incorporated as an extension to the message.

        • PlcAndNm Place And Name [0..1]Max350Text
        • Envlp Envelope [1..1]SupplementaryDataEnvelope1
    • 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.001 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 caaa.001

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

• ExternalAccountIdentification1Code4 codes
• ExternalCashAccountType1Code28 codes
• ExternalOrganisationIdentification1Code15 codes
• ExternalPersonIdentification1Code11 codes
• ExternalProxyAccountType1Code22 codes

Related acceptor to acquirer card transaction messages

• caaa.002Acceptor Authorisation Response
• caaa.003Acceptor Completion Advice
• caaa.004Acceptor Completion Advice Response
• caaa.005Acceptor Cancellation Request
• caaa.006Acceptor Cancellation Response
• caaa.007Acceptor Cancellation Advice
• caaa.008Acceptor Cancellation Advice Response
• caaa.009Acceptor Reconciliation Request
• caaa.010Acceptor Reconciliation Response
• caaa.011Acceptor Batch Transfer

caaa.001 questions

What is the latest version of caaa.001?

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

What is the root element of caaa.001?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:caaa.001.001.14, and its message element is AccptrAuthstnReq (AcceptorAuthorisationRequest).

Is there an MT equivalent of caaa.001?

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