{"_id":"5d39bffe1deedb04834b2851","project":"57336fd5a6a9c40e00e13a0b","version":{"_id":"5c742637ad58c70033b9c762","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5bedbcf19b49e8004462d199","createdAt":"2018-04-24T15:33:45.744Z","releaseDate":"2018-04-24T15:33:45.744Z","categories":["5c742637ad58c70033b9c699","5c742637ad58c70033b9c69a","5c742637ad58c70033b9c69b","5c742637ad58c70033b9c69c","5c742637ad58c70033b9c69d","5c742637ad58c70033b9c69e","5c742637ad58c70033b9c69f","5c742637ad58c70033b9c6a0","5c742637ad58c70033b9c6a1","5c742637ad58c70033b9c6a2","5c742637ad58c70033b9c6a3"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"Main","version_clean":"8976.0.0-Extended","version":"8976-Extended"},"category":{"_id":"5c742637ad58c70033b9c6a1","version":"5c742637ad58c70033b9c762","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":8,"slug":"resources","title":"Resources"},"user":"5beb1b96bc2003003ecd645e","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-07-25T14:43:10.482Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":113,"body":"###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"h-3\": \"Description\",\n    \"0-0\": \"`three-d-secure-result-token`\",\n    \"0-1\": \"*string*\",\n    \"0-2\": \"Optional\",\n    \"0-3\": \"The 3-D Secure result token obtained from the Client-Side Encryption library. See [3-D Secure in Client-Side Encryption](/docs/3d-secure#section-3d-secure-in-client-side-encryption) for more details.\",\n    \"1-0\": \"`eci`\",\n    \"1-1\": \"*string*\",\n    \"1-2\": \"Optional\",\n    \"1-3\": \"ECI value. Applicable if using external MPI. \\n\\nPossible values for MasterCard: \\n* **00**\\n* **01**\\n* **02**\\n\\nPossible values for all other card types: \\n* **05**\\n* **06**\\n* **07**\",\n    \"2-0\": \"`cavv`\",\n    \"2-1\": \"*string*\",\n    \"2-2\": \"Optional\",\n    \"2-3\": \"Base64 encoded CAVV obtained from the external MPI.\",\n    \"3-0\": \"`xid`\",\n    \"3-1\": \"*string*\",\n    \"3-2\": \"Optional\",\n    \"3-3\": \"Obtained from the external MPI.\\n* For 3-D Secure 1.0: Base64 encoded\\n* For 3-D Secure 2.0: Hexadecimal encoding; only required for Amex.\",\n    \"4-0\": \"`ds-transaction-id`\",\n    \"4-1\": \"*string*\",\n    \"5-0\": \"`three-d-secure-version`\",\n    \"5-1\": \"*string*\",\n    \"4-2\": \"Optional\",\n    \"5-2\": \"Optional\",\n    \"4-3\": \"Transaction ID value from the 3DS server.  UUID of 36 characters.\",\n    \"5-3\": \"The version of 3-D Secure being used. Valid values: \\n* **1.0.2**\\n* **2.1.0**\\n* **2.2.0**\",\n    \"6-0\": \"`three-d-secure-reference-id`\",\n    \"6-1\": \"*string*\",\n    \"6-2\": \"Optional\",\n    \"6-3\": \"The ID of the initial transaction to link the current transaction to that existing transaction.\"\n  },\n  \"cols\": 4,\n  \"rows\": 7\n}\n[/block]\n###Response \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`authentication-result`\",\n    \"0-1\": \"*string*\",\n    \"0-2\": \"3-D Secure authentication result.\\n\\nPossible values: \\n\\n**AUTHENTICATION_BYPASSED**\\n\\n**AUTHENTICATION_SUCCEEDED**\\n\\n**AUTHENTICATION_UNAVAILABLE**\\n\\n**AUTHENTICATION_FAILED**\\n\\nFor more information, refer to [Authentication Results details](https://developers.bluesnap.com/v8976-Basics/docs/3d-secure#section-authentication-results).\"\n  },\n  \"cols\": 3,\n  \"rows\": 1\n}\n[/block]","excerpt":"Contains 3-D Secure details for this transaction","slug":"three-d-secure","type":"basic","title":"three-d-secure"}

Extended Payment API

Orders

Shopping Context

Shoppers

Catalog

Subscriptions

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

three-d-secure

Contains 3-D Secure details for this transaction

Request

Property Name
Type
Required
Description

three-d-secure-result-token

string

Optional

The 3-D Secure result token obtained from the Client-Side Encryption library. See 3-D Secure in Client-Side Encryption for more details.

eci

string

Optional

ECI value. Applicable if using external MPI.

Possible values for MasterCard:

  • 00
  • 01
  • 02

Possible values for all other card types:

  • 05
  • 06
  • 07

cavv

string

Optional

Base64 encoded CAVV obtained from the external MPI.

xid

string

Optional

Obtained from the external MPI.

  • For 3-D Secure 1.0: Base64 encoded
  • For 3-D Secure 2.0: Hexadecimal encoding; only required for Amex.

ds-transaction-id

string

Optional

Transaction ID value from the 3DS server. UUID of 36 characters.

three-d-secure-version

string

Optional

The version of 3-D Secure being used. Valid values:

  • 1.0.2
  • 2.1.0
  • 2.2.0

three-d-secure-reference-id

string

Optional

The ID of the initial transaction to link the current transaction to that existing transaction.

Response

Property Name
Type
Description

authentication-result

string

3-D Secure authentication result.

Possible values:

AUTHENTICATION_BYPASSED

AUTHENTICATION_SUCCEEDED

AUTHENTICATION_UNAVAILABLE

AUTHENTICATION_FAILED

For more information, refer to Authentication Results details.