{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"three-d-secure","type":"basic","slug":"three-d-secure","excerpt":"Contains 3-D Secure details for this transaction","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\": \"Base64 encoded ID obtained from the external MPI.\\n3-D Secure 2.0: 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/docs/3-d-secure-for-api#section-authentication-results).\"\n  },\n  \"cols\": 3,\n  \"rows\": 1\n}\n[/block]","updates":[],"order":113,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"61a5033cd3c4d201e7b58487","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-Extended","version_clean":"8976.0.0-Extended","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a5033cd3c4d201e7b583ba","61a5033cd3c4d201e7b583bb","61a5033cd3c4d201e7b583bc","61a5033cd3c4d201e7b583bd","61a5033cd3c4d201e7b583be","61a5033cd3c4d201e7b583bf","61a5033cd3c4d201e7b583c0","61a5033cd3c4d201e7b583c1","61a5033cd3c4d201e7b583c2","61a5033cd3c4d201e7b583c3","61a5033cd3c4d201e7b583c4"],"_id":"61a5033cd3c4d201e7b5848b","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"6040037678d626005641a154","createdAt":"2018-04-24T15:33:45.744Z","releaseDate":"2018-04-24T15:33:45.744Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Resources","slug":"resources","order":8,"from_sync":false,"reference":false,"_id":"61a5033cd3c4d201e7b583c2","version":"61a5033cd3c4d201e7b5848b","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"user":"5beb1b96bc2003003ecd645e","createdAt":"2019-09-04T16:11:00.427Z","__v":0,"parentDoc":null}

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

Base64 encoded ID obtained from the external MPI.
3-D Secure 2.0: 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.