Skip to main content

ChallengeRequest

messageTypestringrequired

Identifies the type of message that is passed.

Possible values: [CReq]

messageVersionstringrequired

Protocol version identifier. This shall be the Protocol Version Number of the specification utilised by the system creating this message.

Possible values: [2.0.1, 2.1.1, 2.1.0, 2.2.0, 2.3.0, 2.3.1]

messageExtension object[]nullable

Data necessary to support requirements not otherwise defined in the 3-D Secure message are carried in a Message Extension.

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

  • ]
  • acsTransIDstring<uuid>required

    Universally unique transaction identifier assigned by the ACS to identify a single transaction.

    threeDSServerTransIDstring<uuid>required

    Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction.

    challengeWindowSizestringrequired

    Dimensions of the challenge window that has been displayed to the Cardholder. The ACS shall reply with content that is formatted to appropriately render in this window to provide the best possible user experience. Preconfigured sizes are width x height in pixels of the window displayed in the Cardholder browser window.

    • 01: 250 x 400
    • 02: 390 x 400
    • 03: 500 x 600
    • 04: 600 x 400
    • 05: Full screen

    Possible values: [01, 02, 03, 04, 05]

    ChallengeRequest
    {
    "messageType": "CReq",
    "messageVersion": "2.0.1",
    "messageExtension": [
    {
    "criticalityIndicator": true,
    "data": {},
    "id": "string",
    "name": "string"
    }
    ],
    "acsTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "threeDSServerTransID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "challengeWindowSize": "01"
    }