PaymentMethodOptionCardThreeDSecure

If 3D Secure authentication was performed, the authentication details to use for this payment.

  • cryptogram
    Type: string
    max length:  
    1000
    required

    The cryptogram, also known as the "authentication value" (AAV, CAVV or AEVV). This value is 20 bytes, base64-encoded into a 28-character string. (Most 3D Secure providers will return the base64-encoded version, which is what you should specify here.)

  • transaction_id
    Type: string
    max length:  
    5000
    required

    For 3D Secure 1, the XID. For 3D Secure 2, the Directory Server Transaction ID (dsTransID).

  • version
    Type: stringenum
    required

    The version of 3D Secure that was performed.

    values
    • 1.0.2
    • 2.1.0
    • 2.2.0
  • ares_trans_status
    Type: stringenum

    The transStatus returned from the card Issuer's ACS in the ARes.

    values
    • A
    • C
    • I
    • N
    • R
    • U
    • Y
  • electronic_commerce_indicator
    Type: stringenum

    The Electronic Commerce Indicator (ECI) is returned by your 3D Secure provider and indicates what degree of authentication was performed.

    values
    • 01
    • 02
    • 05
    • 06
    • 07
  • exemption_indicator
    Type: stringenum

    The exemption requested via 3DS and accepted by the issuer at authentication time.

    values
    • low_risk
    • none
  • requestor_challenge_indicator
    Type: string
    max length:  
    2

    The challenge indicator (threeDSRequestorChallengeInd) which was requested in the AReq sent to the card Issuer's ACS. A string containing 2 digits from 01-99.

  • session_id
    Type: string

    Optional key to correlate retries/refreshes on the same 3DS attempt.