Version
POST pci.ravelin.com/3ds/versionReturns the 3DS versions which the customer’s card and issuer support.
Version Request
Show all
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"
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.
conditional
Conditions: Either paymentMethod or pan must be provided.
Hide definition
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.
required
The AES key ciphertext produced by the Ravelin card encryption SDK .
required
The algorithm used to generate the ciphertexts.
Example: "RSA_WITH_AES_256_GCM"
optional
The version of the Ravelin mobile or JavaScript SDK that performed the encryption.
Example: "0.0.13-ravelinjs"
optional
The index of the public RSA key used to encrypt the card.
optional
An identifier for the public RSA key used to encrypt the card.
Version Response
Show all
The HTTP response status code.
2.1.0
2.2.0
The card scheme which the card uses.
Example: "Visa"
The Version Response details.
Hide definition
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"
2.1.0
2.2.0
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"
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"
2.2.0
ACS Information Indicator - provides information about the ACS. The element lists all applicable values for the card range.
Options:
013DS authentication is available at the ACS
02Attempts supported by the ACS or the DS
03Decoupled authentication supported
04Whitelisting supported
80American Express
Card range issued in EU/EEA. Subject to PSD2.
80Mastercard
Enrolled in Smart Authentication Stand-In Service
81Mastercard
Enrolled in Smart Authentication Direct
84Mastercard
Supports payment authentications
85Mastercard
Supports non-payment authentications
86Mastercard
Supports the app device channel
87Mastercard
Supports the browser device channel
88Mastercard
Supports challenges using the app device channel
89Mastercard
Supports challenges using the browser device channel
90Mastercard
Enrolled in Identity Check Express
91Mastercard
Supports Authentication Express Merchant Delegation for Identity Check Express (Type I)
92Mastercard
Supports Authentication Express Low Fraud Merchant (Type II)
93Mastercard
Supports Authentication Express Wallet Delegation
94Mastercard
Supports Authentication Express Device Delegation
Feedback
Was this page helpful?
Yes
No
Thanks for the feedback.
If you'd like to provide more detail, please email support@ravelin.com .