three-d-secure

Contains 3-D Secure details for this transaction

Request

Property NameTypeRequiredDescription
three-d-secure-result-tokenstringOptionalThe 3-D Secure result token obtained from the Client-Side Encryption library. See 3-D Secure in Client-Side Encryption for more details.
ecistringOptionalECI value. Applicable if using external MPI.

Possible values for MasterCard:
00
01
02

Possible values for all other card types:
05
06
07
cavvstringOptionalBase64 encoded CAVV obtained from the external MPI.
xidstringOptionalBase64 encoded ID obtained from the external MPI.
3-D Secure 2.0: only required for Amex.
ds-transaction-idstringOptionalTransaction ID value from the 3DS server. UUID of 36 characters.
three-d-secure-versionstringOptionalThe version of 3-D Secure being used. Valid values:
1.0.2
2.1.0
* 2.2.0
three-d-secure-reference-idstringOptionalThe ID of the initial transaction to link the current transaction to that existing transaction.

Response

Property NameTypeDescription
authentication-resultstring3-D Secure authentication result.

Possible values:

AUTHENTICATION_BYPASSED

AUTHENTICATION_SUCCEEDED

AUTHENTICATION_UNAVAILABLE

AUTHENTICATION_FAILED

For more information, refer to Authentication Results details.