Merchants > API Reference > Endpoints > 3D Secure > Version

Version

Field Status Definitions

Required Required fields must be sent. If the data is not sent Ravelin will return an error.

Important Important fields are crucial for performance.

Optional Optional fields are additional data points that can be shared with the card schemes, issuers, and Ravelin. These fields may impact performance or dashboard usability.

Conditional Fields that may be required under certain conditions.

POST 3ds.live.pci.ravelin.com/3ds/version

Returns the 3DS versions which the customer’s card and issuer support.

Version Request

Show all

transactionId string

optional

The unique identifier for the transaction used on the Checkout endpoint. Required if you want to associate the 3D Secure authentication with the transaction.

Example: "123-abc-XYZ"

transactionStepId string

optional

The unique identifier for the transaction step within the transaction used only for PSP clients. Required if you want to associate the 3D Secure authentication with the PSP transaction step.

Example: "123-abc-XYZ"

Minimum length: 1

pan string

conditional

The Primary Account Number (PAN) of the card being used for the transaction. If EMV Tokenisation is supported, this may be an EMV Payment Token instead of a PAN.

This field is cardholder data. Submission of this field requires PCI DSS SAQ-D certification.

Please see our PCI DSS documentation for more information.

Example: "4900000000001234"

Conditions:

Either pan or paymentMethod must be provided.

paymentMethod object

conditional

The card being used for the transaction, encrypted using the Ravelin card encryption SDK.

See Submission of Encrypted Card Details for more information.

Conditions:

Either paymentMethod or pan must be provided.

Hide definition

cardCiphertext string required	The card ciphertext produced by the Ravelin card encryption SDK. This field constitutes cardholder data. Submission of this field requires PCI DSS SAQ-A or SAQ-AEP certification. Please see our PCI DSS documentation for more information.
aesKeyCiphertext string required	The AES key ciphertext produced by the Ravelin card encryption SDK . Minimum length: 1
algorithm string required	The algorithm used to generate the ciphertexts. Example: `"RSA_WITH_AES_256_GCM"` Minimum length: 1
ravelinSDKVersion string optional	The version of the Ravelin mobile or JavaScript SDK that performed the encryption. Example: `"0.0.13-ravelinjs"`
keyIndex integer optional	The index of the public RSA key used to encrypt the card.
keySignature string optional	An identifier for the public RSA key used to encrypt the card.

Version Response

Show all

timestamp integer

A Unix timestamp indicating when we finished handling the request.

status integer

The HTTP response status code.

cardScheme string

2.1.0 2.2.0

The card scheme which the card uses.

Example: "Visa"

data object

The Version Response details.

Hide definition

transactionId string

2.1.0 2.2.0

The unique identifier for tracking the transaction throughout Ravelin.

Example: "123-abc-XYZ"

threeDSServerTransID string

2.1.0 2.2.0

The unique identifier (UUID) for tracking the transaction throughout the 3DS process.

Example: "c5584543-b67e-5117-bb34-3567ac6a1123"

threeDSMethodURL string

2.1.0 2.2.0

The Method URL for sending the Method Request.

Example: "https://www.example-acs.com/method-url"

versionRecommendation string

2.1.0 2.2.0

Ravelin's version recommendation - the highest available 3DS protocol version up to 2.2.0.

Example: "2.2.0"

availableVersions array

2.1.0 2.2.0

The 3DS protocol versions which are available to use.

acsStartProtocolVersion string

2.1.0 2.2.0

The earliest 3DS 2 protocol version that is supported by the ACS.

Example: "2.1.0"

acsEndProtocolVersion string

2.1.0 2.2.0

The most recent 3DS 2 protocol version that is supported by the ACS.

Example: "2.2.0"

dsStartProtocolVersion string

2.1.0 2.2.0

The earliest 3DS 2 protocol version that is supported by the directory server.

Example: "2.1.0"

dsEndProtocolVersion string

2.1.0 2.2.0

The most recent 3DS 2 protocol version that is supported by the directory server.

Example: "2.2.0"

acsInfoInd array

2.2.0

ACS Information Indicator - provides information about the ACS. The element lists all applicable values for the card range.

Options:

`01`	3DS authentication is available at the ACS
`02`	Attempts supported by the ACS or the DS
`03`	Decoupled authentication supported
`04`	Whitelisting supported
`80`	American Express	Card range issued in EU/EEA. Subject to PSD2.
`80`	Mastercard	Enrolled in Smart Authentication Stand-In Service
`81`	Mastercard	Enrolled in Smart Authentication Direct
`84`	Mastercard	Supports payment authentications
`85`	Mastercard	Supports non-payment authentications
`86`	Mastercard	Supports the app device channel
`87`	Mastercard	Supports the browser device channel
`88`	Mastercard	Supports challenges using the app device channel
`89`	Mastercard	Supports challenges using the browser device channel
`90`	Mastercard	Enrolled in Identity Check Express
`91`	Mastercard	Supports Authentication Express Merchant Delegation for Identity Check Express (Type I)
`92`	Mastercard	Supports Authentication Express Low Fraud Merchant (Type II)
`93`	Mastercard	Supports Authentication Express Wallet Delegation
`94`	Mastercard	Supports Authentication Express Device Delegation

Feedback

Was this page helpful?