JSON Object
challengeRequest
ChallengeRequest
The challengeRequest object is only relevant to Server-to-Server implementations. It is part of the authenticationResponse object and only present if a challenge is mandated.
Data Elements
| Key | Format | Condition | Description |
| threeDSServerTransID | string | M | the 1cs Online Payment System PayID in canonical format as specified in IETF RFC 4122. |
| acsTransID | string | M | Universally Unique transaction identifier assigned by the ACS to identify a single transaction. |
| messageType | string | M | Identifies the Message Type. Values accepted: · CReq |
| messageVersion | string | M | Protocol version identifier. |
| challengeWindowSize | string | M | Dimensions of the challenge window that will be 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. Values accepted: · 01 = 250 x 400 · 02 = 390 x 400 · 03 = 500 x 600 · 04 = 600 x 400 · 05 = Full screen the 1cs Online Payment System will determine the best window size according to the browserInfo for server-to-server requests. |
| messageExtension | object | C | Data necessary to support requirements not otherwise defined in the 3-D Secure message are carried in a Message Extension. |
Schema
{
“$schema”: “http://json-schema.org/draft-07/schema#”,
“$id”: “https://www.computop-paygate.com/schemas/challengeRequest.json”,
“title”: “Challenge Request”,
“description”: “Datenelemente von Challenge Request”,
“type”: “object”,
“properties”: {
“threeDSServerTransID”: {
“type”: “string”,
“maxLength”: 36
},
“acsTransID”: {
“type”: “string”,
“maxLength”: 36
},
“messageType”: {
“type”: “string”,
“enum”: [“CReq”]
},
“messageVersion”: {
“type”: “string”,
“minLength”: 5,
“maxLength”: 8
},
“challengeWindowSize”: {
“type”: “string”,
“enum”: [“01”, “02”, “03”, “04”, “05”]
},
“messageExtension”: {
“type”: “array”,
“items”: {
“type”: “object”
}
}
}
}
Sample
{
“threeDSServerTransID”: “8a880dc0-d2d2-4067-bcb1-b08d1690b26e”,
“acsTransID”: “d7c1ee99-9478-44a6-b1f2-391e29c6b340”,
“messageType”: “CReq”,
“messageVersion”: “2.1.0”,
“challengeWindowSize”: “01”,
“messageExtension”: [
{
“name”: “emvcomsgextInChallenge”,
“id”: “tc8Qtm465Ln1FX0nZprA”,
“criticalityIndicator”: false,
“data”: “messageExtensionDataInChallenge”
}
]
}
