3DS 2.1 Deprecation Notice
EMVCo and the card schemes will shortly be sunsetting 3D Secure version 2.1.
Please contact Ravelin if you have any questions in advance of this change.
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
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"
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.