threeDSResponse

The threeDSResponse object allows to obtain information on 3D Secure v1 authentication.

It contains a authenticationResultData attribute that describes the result of the 3D Secure v1 authentication.

It consists of the following attributes:

Attribute Format
transactionCondition

3D Secure authentication status. The possible values are:

  • COND_3D_SUCCESS

    Authentication success.

    The merchant and the cardholder are registered in the 3D Secure program and the buyer has correctly authenticated.
  • COND_3D_FAILURE

    Authentication failure.

    The merchant and the cardholder are registered in the 3D Secure program but the buyer did not manage to authenticate (wrong password).
  • COND_3D_ERROR

    Authentication error.

    The merchant participates in the 3D Secure program but the payment gateway server has encountered a technical issue during the authentication process (while checking whether the card is registered in the 3D program or whether the cardholder is authenticated).
  • COND_3D_NOTENROLLED

    Cardholder not enrolled.

    The merchant participates in the 3D Secure program but the cardholder's card is not enrolled.
  • COND_3D_ATTEMPT

    Authentication attempt.

    The merchant and the cardholder are registered in the 3D Secure program but the buyer did not need to authenticate (the access control server of the bank that issued the card only implements the generation of proof of authentication attempt).
  • COND_SSL

    3D Secure not applicable.

    The merchant is not enrolled in 3D Secure or the sales channel is not covered by this guarantee.
string
enrolled

Cardholder’s enrollment status. The possible values are:

  • Y for Enrolled status.
  • N for Not Enrolled status.
  • U for Unknown status.
string
status

Authentication status of the cardholder. The possible values are:

  • Y for Authenticated 3DS status.
  • N for an Authentication Error.
  • U for Impossible Authentication.
  • A for an Authentication Attempt.
a1
eci

E-commerce index.

The eci value depends on the 3DS authentication status and the card type. The possible values are:
  status =Y status = A status = U status =N
VISA - AMEX 5 6 7 -
MasterCard 02 01 - -
string
xid

3DS transaction number.

string
cavvAlgorithm

Algorithm for checking the authentication status of the cardholder (CAVV). The possible values are:

  • 0 for HMAC.
  • 1 for CVV.
  • 2 for CVV_ATN.
  • 3 for Mastercard SPA.
n1
cavv

ACS certificate.

string
signValid

3DS authentication signature.

string
brand

Card scheme.

string