three-d-secure

Contains 3-D Secure details for this transaction

Request

Property Name

Type

Required

Description

three-d-secure-result-token

string

Optional

The 3-D Secure result token obtained from the Client-Side Encryption library. See 3-D Secure in Client-Side Encryption for more details.

eci

string

Optional

ECI value. Applicable if using external MPI.

Possible values for MasterCard:

  • 00
  • 01
  • 02

Possible values for all other card types:

  • 05
  • 06
  • 07

cavv

string

Optional

Base64 encoded CAVV obtained from the external MPI.

xid

string

Optional

Base64 encoded ID obtained from the external MPI. 3-D Secure 2.0: only required for Amex.

ds-transaction-id

string

Optional

Transaction ID value from the 3DS server. UUID of 36 characters.

three-d-secure-version

string

Optional

The version of 3-D Secure being used. Valid values:

  • 1.0.2
  • 2.1.0
  • 2.2.0

three-d-secure-reference-id

string

Optional

The ID of the initial transaction to link the current transaction to that existing transaction.

Response

Property Name

Type

Description

authentication-result

string

3-D Secure authentication result.

Possible values:

AUTHENTICATION_BYPASSED

AUTHENTICATION_SUCCEEDED

AUTHENTICATION_UNAVAILABLE

AUTHENTICATION_FAILED

For more information, refer to Authentication Results details.