---
updatedAt: 2025-11-13T16:07:29.000Z
agentTools:
  projectIndex: https://developers.bluesnap.com/v8976-Extended/llms.txt
---

# three-d-secure

Contains 3-D Secure details for this transaction

### Request

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Property Name
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Required
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        `three-d-secure-result-token`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        The 3-D Secure result token obtained from the Client-Side Encryption library. See [3-D Secure in Client-Side Encryption](https://developers.bluesnap.com/v8976-Basics/reference/3-d-secure-for-api-with-cse-info-section#section-3-d-secure-in-client-side-encryption) for more details.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `eci`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        ECI value. Applicable if using external MPI. 

        Possible values for MasterCard: 

        * **00**
        * **01**
        * **02**

        Possible values for all other card types: 

        * **05**
        * **06**
        * **07**
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `cavv`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Base64 encoded CAVV obtained from the external MPI.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `xid`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Base64 encoded ID obtained from the external MPI.\
        3-D Secure 2.0: only required for Amex.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `ds-transaction-id`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Transaction ID value from the 3DS server.  UUID of 36 characters.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `three-d-secure-version`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        The version of 3-D Secure being used. Valid values: 

        * **1.0.2**
        * **2.1.0**
        * **2.2.0**
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `three-d-secure-reference-id`
      </td>

      <td style={{ textAlign: "left" }}>
        *string*
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        The ID of the initial transaction to link the current transaction to that existing transaction.
      </td>
    </tr>
  </tbody>
</Table>

### Response

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Property Name
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `authentication-result`
      </td>

      <td>
        *string*
      </td>

      <td>
        3-D Secure authentication result.

        Possible values: 

        **AUTHENTICATION\_BYPASSED**

        **AUTHENTICATION\_SUCCEEDED**

        **AUTHENTICATION\_UNAVAILABLE**

        **AUTHENTICATION\_FAILED**

        For more information, refer to [Authentication Results details](https://developers.bluesnap.com/v8976-Basics/reference/3-d-secure-for-api#section-authentication-results).
      </td>
    </tr>
  </tbody>
</Table>