ZagTrader

caam: ATM Management

caam.003 ATM Key Download Request

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

caam.003 is the ISO 20022 ATMKeyDownloadRequest message in the ATM Management business area (caam). The latest version is caam.003.001.04, and 4 versions are in the repository.

Message
ATMKeyDownloadRequest
Latest version
caam.003.001.04
Submitting organisation
nexo
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What caam.003 is for

The ATMKeyDownloadRequest message is sent by an ATM to an ATM manager to initiate the download of one or several cryptographic keys.

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

caam.003 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
caam.003.001.04latestRegisteredLatest version set
caam.003.001.03RegisteredPrevious version set
caam.003.001.02RegisteredArchive
caam.003.001.01RegisteredArchive

caam.003 message structure

The building blocks of caam.003.001.04 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]
    • ATMKeyDwnldReq ATMKeyDownloadRequest [1..1]
      • Hdr Header [1..1]Header31

        Information related to the protocol management on a segment of the path from the ATM to the acquirer.

        • MsgFctn Message Function [1..1]ATMMessageFunction2

          Identifies the type of process related to the message.

          • Fctn Function [1..1]MessageFunction11Code
          • ATMSvcCd ATM Service Code [0..1]Max35Text
          • HstSvcCd Host Service Code [0..1]Max35Text
        • PrtcolVrsn Protocol Version [1..1]Max6Text

          Version of the ATM protocol specifications.

        • XchgId Exchange Identification [1..1]Max3NumericText

          Unique identification of an exchange occurrence.

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

          Date and time at which the message was created.

        • InitgPty Initiating Party [1..1]Max35Text

          Unique identification of the partner that has initiated the exchange.

        • RcptPty Recipient Party [0..1]Max35Text

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

        • PrcStat Process State [0..1]Max35Text

          State of the sender of the message inside the process flow.

        • Tracblt Traceability [0..*]Traceability4

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

          • RlayId Relay Identification [1..1]GenericIdentification77
          • SeqNb Sequence Number [0..1]Max35Text
          • TracDtTmIn Trace Date Time In [1..1]ISODateTime
          • TracDtTmOut Trace Date Time Out [1..1]ISODateTime
      • PrtctdATMKeyDwnldReq Protected ATM Key Download Request [0..1]ContentInformationType10

        Encrypted body of the message.

        • CnttTp Content Type [1..1]ContentType2Code

          Type of data protection.

        • EnvlpdData Enveloped Data [1..1]EnvelopedData4

          Data protection by encryption or by a digital envelope, with an encryption key.

          • Vrsn Version [0..1]Number
          • Rcpt Recipient [1..*]Recipient4Choice (choice)
          • NcrptdCntt Encrypted Content [0..1]EncryptedContent3
      • ATMKeyDwnldReq ATM Key Download Request [0..1]ATMKeyDownloadRequest5

        Information related to the request of a key download from an ATM.

        • Envt Environment [1..1]ATMEnvironment15

          Environment of the key download.

          • Acqrr Acquirer [0..1]Acquirer7
          • ATMMgrId ATM Manager Identification [0..1]Max35Text
          • HstgNtty Hosting Entity [0..1]TerminalHosting1
          • ATM ATM [1..1]AutomatedTellerMachine6
        • CmdRslt Command Result [0..*]ATMCommand15

          Result of a maintenance command performed by the ATM.

          • Tp Type [1..1]ATMCommand7Code
          • ReqrdDtTm Required Date Time [0..1]ISODateTime
          • PrcdDtTm Processed Date Time [1..1]ISODateTime
          • CmdId Command Identification [0..1]ATMCommandIdentification1
          • Rslt Result [1..1]TerminalManagementActionResult2Code
          • AddtlErrInf Additional Error Information [0..1]Max140Text
        • CmdCntxt Command Context [0..1]ATMCommand16

          Security command in progress inside which the key download is requested.

          • Tp Type [1..1]ATMCommand7Code
          • CmdId Command Identification [0..1]ATMCommandIdentification1
        • ATMSctyCntxt ATM Security Context [1..1]ATMSecurityContext3

          Context of the ATM for the key download.

          • CurSctySchme Current Security Scheme [1..1]ATMSecurityScheme3Code
          • DvcPrprty Device Property [0..1]ATMEquipment3
          • CurCfgtn Current Configuration [0..1]ATMSecurityConfiguration1
        • ATMSctyParams ATM Security Parameters [1..1]SecurityParameters9

          Security parameters of the ATM for the initiated key download.

          • Key Key [0..1]CryptographicKey12
          • SgntrChc Signature Choice [0..1]ATMSignature2Choice (choice)
          • Cert Certificate [0..*]Max5000Binary
          • ATMChllng ATM Challenge [0..1]Max140Binary
          • ReqdKey Requested Key [0..1]Max35Text
        • HstChllng Host Challenge [0..1]Max140Binary

          Random value from the host provided during a previous exchange.

      • SctyTrlr Security Trailer [0..1]ContentInformationType13

        Trailer of the message containing a MAC or a digital signature.

        • CnttTp Content Type [1..1]ContentType2Code

          Type of data protection.

        • AuthntcdData Authenticated Data [0..1]AuthenticatedData4

          Data protection by a message authentication code (MAC).

          • Vrsn Version [0..1]Number
          • Rcpt Recipient [1..*]Recipient4Choice (choice)
          • MACAlgo MAC Algorithm [1..1]AlgorithmIdentification15
          • NcpsltdCntt Encapsulated Content [1..1]EncapsulatedContent3
          • MAC MAC [1..1]Max140Binary
        • SgndData Signed Data [0..1]SignedData4

          Data protected by a digital signatures.

          • Vrsn Version [0..1]Number
          • DgstAlgo Digest Algorithm [1..*]AlgorithmIdentification16
          • NcpsltdCntt Encapsulated Content [1..1]EncapsulatedContent3
          • Cert Certificate [0..*]Max5000Binary
          • Sgnr Signer [1..*]Signer3

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

caam.003 questions

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