Page tree

The merchant can specify the authentication mode that it wants to apply to this transaction with ChallengeInd.

Field

Description

Required

Format

Condition

challengeInd

Indicates whether a challenge is requested for this transaction, see values Codes - ChallengeInd

No

AN2

Version 21 or higher (3DSV2)

threeDSReqPriorAuthData

Data supports a specific authentication process.

In the current version of the specification this data element is not defined in detail, however the intention is that for each 3DS Requestor Authentication Method, this field carry data that the ACS can use to verify the authentication process. In future versions of the specification, these details are expected to be included.

NoAN2048

For Future usage

Version 21 or higher (3DSV2)

threeDSReqPriorAuthMethod

Mechanism used by the Cardholder to previously authenticate to the 3DS Requestor, see values Codes - threeDSReqPriorAuthMethod

Recommended for 3DSV2.

NoAN2

Version 21 or higher (3DSV2)

threeDSReqPriorAuthTimestamp

Date and time in UTC of the prior cardholder authentication

Recommended for 3DSV2.

NoAN16

Version 21 or higher (3DSV2)

browserParameters of the shopper web browser. ConditionalObject browser

Mandatory in verifyEnrollment when the buyer is connected to a web browser either within a computer or a mobile (web app integration).

Version 21 or higher (3DSV2)

sdk

Parameters of the shopper application. 

<ns2:sdk>
<ns2:deviceRenderingOptionsIF>01</ns2:deviceRenderingOptionsIF>
<ns2:deviceRenderOptionsUI>01,02</ns2:deviceRenderOptionsUI>
<ns2:appID>9063b12c-fcde-43c7-b28e-8d0af5520e8a</ns2:appID>
<ns2:ephemPubKey>P-256;EC;fLu0jFkny8EFesPgIIOXACukmKg8QZ5ZL1mzofJdrUA;E05T0cGOTOcoSfLWfRQg_OjVm6nJAoSS7cO03T7wE1s</ns2:ephemPubKey>
<ns2:maxTimeout>06</ns2:maxTimeout>
<ns2:referenceNumber>3DSSDK74332823FF</ns2:referenceNumber>
<ns2:transID>b60c9879-ac77-4918-a317-7b01c4317053</ns2:transID>
<ns2:encData>eyJlbmMiOiJBMTI4Q0JDLUhT...2oQumoyFni9rCdtfMmcl5VWdA8QkkcMHuVWrcpjrMAred8UwUlr2Fz.JTD5-5-4MFuwqBtzYWuTBg</ns2:encData>
</ns2:sdk>


ConditionalObject sdk

Mandatory in verifyEnrollment when the buyer is connected to a mobile application and the merchant is using a 3DS SDK (in app integration).

Version 21 or higher (3DSV2)

threeDSMethodNotificationURLFully qualified URL where the merchant receive the notification of the completion result of the 3DS Method (server to server notification)ConditionalAN255

Mandatory in verifyEnrollment.

Version 21 or higher (3DSV2)

threeDSMethodResult

Indicates whether the 3DS Method successfully completed.

  • I: Value for the first call to verifyEnrollmen.
  • Y: 3DS method succeeded.
  • N: 3DS method failed or no response received.
ConditionalAN1

Mandatory in verifyEnrollment.

Version 21 or higher (3DSV2)

ChallengeWindowSize

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

Recommended for 3DSV2.

NoN2

Version 22 or higher (3DSV2)