threeDSResponse

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

This object:

  • authenticationRequestData

    Describes the result of the enrollment request as well as the encoded message that will be transmitted by the buyer's browser to the ACS provider.

  • authenticationResultData

    Describes the details of 3D Secure authentication.

Table 1. The authenticationRequestData object
authenticationRequestData Format
threeDSAcctId

Certificate returned by the Directory Server.

string
threeDSAcsUrl

ACS URL.

string
threeDSBrand

Card scheme.

string
threeDSEncodedPareq

PAReq message encrypted, ready to send to the ACS.

string
threeDSEnrolled

Cardholder's enrollment status.

The possible values are:

  • Y for enrolled status.
  • N for non-enrolled status.
  • U for unknown status.
a1
threeDSRequestId

Query number, recall when calling ENABLED_FINALIZE of the mode attribute within the threeDSRequest object.

string

Table 2. The authenticationResultData object
authenticationResultData Format
transactionCondition

3D Secure authentication status. The possible values are:

  • COND_3D_SUCCESS

    Authentication successfully completed.

    The merchant and the cardholder are enrolled for the 3D Secure program, the cardholder has been correctly authenticated.
  • COND_3D_FAILURE

    Authentication error.

    The merchant and the cardholder are enrolled for the 3D Secure program but the buyer has not managed to identify him/herself (incorrect password).
  • COND_3D_ERROR

    Authentication error.

    The merchant is enrolled for the 3D Secure program but the server of the payment platform has encountered a technical problem in the course of the authentication process (during verification of the card enrollment for the 3DS program or during authentication of the cardholder).
  • COND_3D_NOTENROLLED

    Cardholder not enrolled.

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

    Authentication attempt

    The merchant and the cardholder are enrolled for the 3D Secure program but the buyer could not identify him/herself (the access control server of the issuing bank indicates that an authentication attempt has been made).
  • COND_SSL

    3D Secure non-applicable.

    The merchant is not enrolled for 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 non-enrolled status.
  • U for unknown status.
string
status

Cardholder's authentication status. The possible values are:

  • Y for 3 DS authenticated status.
  • N for authentication error.
  • U for authentication impossible.
  • A for authentication attempt.
a1
eci

E-commerce indicator.

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 Cardholder Authentication Verification Value (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