Historique de la page

Parameters of the shopper application.

Extrait

The merchant receive receives the SDK Challenge from authentitication request.

Field	Description	Required	Format	Condition
cardType	Card type: CB, VISA, MASTERCARD, MAESTRO, AMEX	N	AN20	Version 31 or higher (3DSV2)
threeDSServerTransID	Required by the SDK to continue in challenge. Canonical format as defined in IETF RFC 4122. Example = 6bf8f23c-e721-5bfc-8000-00000039a43d	N	AN36
threeDSVersion	This field contains the 3DS version that was used to process the transaction. Example = 2.2.0	N	AN8
authenticationType	Indicates the type of authentication that will be used to challenge the card holder. Possible Values: 01 - Static 02 - Dynamic 03 - OOB (Out of Band) 04 - Decoupled	N	AN2
transStatus	Returns an indicator about enrollment result : see values transStatus.	N	AN1
sdkTransID	Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction.

dsTransID

acsTransID

acsRenderingType

acsReferenceNumber

acsSignedContent

acsOperatorID

acsChallengeMandated

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.

No

AN2048

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.

No

AN2

Version 21 or higher (3DSV2)

threeDSReqPriorAuthTimestamp

Date and time in UTC of the prior cardholder authentication

Recommended for 3DSV2.

No

AN16

Version 21 or higher (3DSV2)

browser

Parameters of the shopper web browser.

Conditional

Object 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

Développer

title	Example...

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

NoN2Version 22 or higher (3DSV2)

Canonical format as defined in IETF RFC 4122. Example = b60c9879-ac77-4918-a317-7b01c4317053	N	AN36
dsTransID	Canonical format as defined in IETF RFC 4122. May utilise any of the specified versions as long as the output meets specified requirements.	N	AN36
acsTransID	Required by the SDK to continue in challenge. Canonical format as defined in IETF RFC 4122. Example = 38b4a4f4-ceee-457a-80d3-40d4fd3aa618	N	AN36
acsRenderingType	Example = { "acsInterface" : "01", "acsUiTemplate" : "01" }	N	JSON
acsReferenceNumber	Required by the SDK to continue in challenge. Example = 3DS_LOA_ACS_MOMD_020100_00061	N	AN32
acsSignedContent	Required by the SDK to continue in challenge. Example = eyJ4NWMi##..6716..##95_fYwXQ	N	CDATA
acsOperatorID	Any individual DS may impose specific formatting and character requirements on the contents of this field.	N	AN32
acsChallengeMandated	Example = N	N	AN1

Arborescence des pages

Comparaison des versions

Ancienne version 1

Nouvelle version Actuel

Légende