3DS Versioning

Overview

New API version for 3DS Versioning Method has been introduced:

ThreeDsServerVersioningResponse extended with Boolean field isCardFoundIn2xRanges indicating whether the passed card number in the ThreeDsServerVersioningRequest is found within the card ranges and enabled for 3DS 2.x. An error with a 404 error code and message "Card account number not found in card ranges from Directory Server" is no longer returned if the card is not found in the ranges (i.e. it is not enrolled for 3DS 2.x).

Error code REQUIRED_ELEMENT_MISSING("201") is returned if the cardholder account number is missing in the ThreeDsServerVersioningRequest.

Error code FORMAT_ON_ONE_OR_MORE_ELEMENTS_INVALID_ACCORDING_SPECS("203") is returned if the cardholder account number is invalid in the ThreeDsServerVersioningRequest.

For its usage use v2 as a apiVersion path parameter in the Versioning endpoint. If no version is provided, default one is used. Example: /3ds/apiVersion/versioning where apiVersion can be v2.

ThreeDSVersioningRequest Model

The schemeId is used for better resolving of the versioning data, when the versioning data is not present for the BIN range. Whereas the schemeId is an optional field, in the case where card ranges are found in multiple schemes, it is required because it is the only indicator to resolve the versioning data and needs to be sent in the authentication request.

Supported scheme configuration naming

All supported scheme configurations should be named accordingly.

• Visa scheme ID: Visa
• MasterCard scheme ID: Mastercard
• American Express scheme ID: American Express
• JCB scheme ID: JCB
• Diners scheme ID: Diners
• MIR scheme ID: Mir
• Cartes Bancaires scheme ID: CB (For Cartes Bancaires, it is recommended to send the scheme ID)
• UnionPay scheme ID: UnionPay (For UnionPay, it is recommended to send the scheme ID)

ThreeDSVersioningRequest JSON samples

ThreeDSVersioningResponse Model

ThreeDSVersioningResponse V2 Model