Documentation Monext Online

Arborescence des pages

Comparaison des versions

Ancienne version 1

changes.mady.by.user Guillaume VENTRE

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Rodolphe GARIN

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: example sdk


Lists all of the SDK Interface types that the device supports for displaying specific challenge user interfaces within the SDK.

Values accepted:

• 01 = Native

• 02 = HTML

• 03 = Both

Extrait


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


Field

Description

Mandatory

Required

Type

ConditiondeviceRenderingOptionsIF

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. 

Développer
titleExample...

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

YesAN23DSV2deviceRenderOptionsUI

Lists all UI types that the device supports for displaying specific challenge user interfaces within the SDK.

String values accepted:

• 01 = Text

• 02 = Single Select

• 03 = Multi Select

• 04 = OOB

• 05 = HTML Other (valid only for HTML UI)

YesAN23DSV2sdkAppID

Universally unique ID created upon all installations and updates of the 3DS Requestor App on a Consumer Device. This will be newly generated and stored by the 3DS SDK for each installation or update.

Length: 36 characters

JSON Data Type: String

Canonical format as defined in IETF RFC 4122. This may utilise any of the specified versions as long as the output meets specified

YesAN363DSV2sdkEphemPubKey

Public key component of the ephemeral key pair generated by the 3DS SDK and used to establish session keys between the 3DS SDK and ACS.

In AReq, this data element is present as its own object.

In ARes, this data element is contained within the ACS Signed Content JWS Object.

YesAN2563DSV2sdkMaxTimeout

Indicates maximum amount of time (in minutes) for all exchanges.

Greater than or = 05

YesN23DSV2sdkreferenceNumberIdentifies the vendor and version for the 3DS SDK that is integrated in a 3DS Requestor App, assigned by EMVCo when the 3DS SDK is approved.YesAN323DSV2sdkTransIDUniversally unique transaction identifier assigned by the 3DS SDK to identify a single transaction.YesAN363DSV2