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-resultstring

3-D Secure authentication result.

Possible values:

AUTHENTICATION_BYPASSED

AUTHENTICATION_SUCCEEDED

AUTHENTICATION_UNAVAILABLE

AUTHENTICATION_FAILED

For more information, refer to Authentication Results details.