All JSON objects

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”

               }

    ]

}