Skip to main content

ChallengeResponse

acsCounterAtoSstringrequired

Counter used as a security measure in the ACS to 3DS SDK secure channel. Categories: PA, NPA. Channels: APP.

acsTransIDstring<uuid>required

Universally unique transaction identifier assigned by the ACS to identify a single transaction. Categories: PA, NPA. Channels: APP, BRW, 3RI.

challengeCompletionIndstringrequired

Indicator of the state of the ACS challenge cycle and whether the challenge has completed or will require additional messages. Shall be populated in all CRes messages to convey the current state of the transaction. Categories: PA, NPA. Channels: APP.

Possible values: [Y, N]

messageExtension object[]nullable

Data necessary to support requirements not otherwise defined in the 3-D Secure message are carried in a Message Extension. Categories: PA, NPA. Channels: APP, BRW, 3RI.

Possible values: <= 10

  • Array [
    • criticalityIndicatorbooleanrequired

    A Boolean value indicating whether the recipient must understand the contents of the extension to interpret the entire message.

    data objectrequired

    The data carried in the extension. Max length: 8059.

    property name*any

    The data carried in the extension. Max length: 8059.

    idstringrequired

    A unique identifier for the extension. Note: Payment System Registered Application Provider Identifier (RID) is required as prefix of the ID.

    Possible values: <= 64 characters

    namestringrequired

    The name of the extension data set as defined by the extension owner.

    Possible values: <= 64 characters

  • ]
    • messageTypestringrequired

    Identifies the type of message that is passed. Categories: PA, NPA. Channels: APP, BRW, 3RI.

    Possible values: [CRes]

    messageVersionstringrequired

    Protocol version identifier. This shall be the Protocol Version Number of the specification utilised by the system creating this message. Categories: PA, NPA. Channels: APP, BRW, 3RI.

    Possible values: [2.2.0]

    sdkTransIDstring<uuid>nullable

    Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction. Required if deviceChannel is "01". Categories: PA, NPA. Channels: APP.

    threeDSServerTransIDstring<uuid>required

    Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction. Categories: PA, NPA. Channels: APP, BRW, 3RI.

    transStatusstringnullable

    Indicates whether a transaction qualifies as an authenticated transaction or account verification. Required if messageCategory is "01". Categories: PA, NPA. Channels: APP, BRW, 3RI.

    • Y: Authentication/ Account Verification Successful
    • N: Not Authenticated /Account Not Verified; Transaction denied

    Possible values: [Y, N]

    ChallengeResponse
    {
      "acsCounterAtoS": "string",
      "acsTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "challengeCompletionInd": "Y",
      "messageExtension": [
        {
          "criticalityIndicator": true,
          "data": {},
          "id": "string",
          "name": "string"
        }
      ],
      "messageType": "CRes",
      "messageVersion": "2.2.0",
      "sdkTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "threeDSServerTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "transStatus": "Y"
    }