PaymentMethodOptionCard

  • request_three_d_secure
    Type: stringenum

    We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to automatic.

    values
    • any
    • automatic
    • challenge
  • three_d_secure

    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.