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 deemed necessary.

Data Elements


KeyFormatConditionDescription
1

threeDSServerTransID

string

M

BNP Payment platform PayID in canonical format as specified in IETF RFC 4122

2

acsTransID

string

M

Universally Unique transaction identifier assigned by the ACS to identify a single transaction

3

messageType

string

M

Identifies the Message Type.

Values accepted:

  • CReq

4

messageVersion

string

M

Protocol version identifier

5

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

Paygate will determine the best window size according to the browserInfo for server-to-server requests.

6

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://paymentpage.axepta.bnpparibas/schemas/challengeRequest.json",
    "title": "Challenge Request",
    "description": "Challenge Request Data Elements",
    "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"
		}
    ]
}


  • No labels