{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"threeDSecure","type":"basic","slug":"threedsecure","excerpt":"Contains 3D 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\": \"`threeDSecureResultToken`\",\n    \"0-1\": \"*string*\",\n    \"0-2\": \"Optional\",\n    \"0-3\": \"The 3D Secure result token obtained from the Client-Side Encryption library. See [3D Secure in Client-Side Encryption](https://developers.bluesnap.com/docs/3-d-secure-for-api#section-3-d-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 XID obtained from the external MPI.\",\n    \"4-0\": \"`dsTransactionId`\",\n    \"5-0\": \"`threeDSecureVersion`\",\n    \"6-0\": \"`threeDSecureReferenceId`\",\n    \"4-1\": \"*string*\",\n    \"5-1\": \"*string*\",\n    \"6-1\": \"*string*\",\n    \"4-2\": \"Optional\",\n    \"5-2\": \"Optional\",\n    \"6-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-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\": \"`authenticationResult`\",\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]","updates":[],"order":43,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed0377101fdb400214deda0","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed0377101fdb400214ded00","5ed0377101fdb400214ded01","5ed0377101fdb400214ded02","5ed0377101fdb400214ded03","5ed0377101fdb400214ded04","5ed0377101fdb400214ded05","5ed0377101fdb400214ded06","5ed0377101fdb400214ded07","5ed0377101fdb400214ded08","5ed0377101fdb400214ded09","5ed0377101fdb400214ded0a","5ed0377101fdb400214ded0b","5ed0377101fdb400214ded0c","5ed0377101fdb400214ded0d","5ed0377101fdb400214ded0e","5ed0377101fdb400214ded0f","5ed0377101fdb400214ded10"],"_id":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3aa2dc4d35003d784d9d","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"JSON Objects","slug":"resources","order":13,"from_sync":false,"reference":false,"_id":"5ed0377101fdb400214ded0b","version":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:20:51.519Z","__v":0},"user":"5beb1b96bc2003003ecd645e","createdAt":"2019-09-04T16:13:43.935Z","__v":0,"parentDoc":null}

Payment API (JSON)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Local Bank Transfer transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

JSON Objects

Test Data & Codes

Guides & Tools

Mobile SDK

threeDSecure

Contains 3D Secure details for this transaction

Request

Property Name
Type
Required
Description

threeDSecureResultToken

string

Optional

The 3D Secure result token obtained from the Client-Side Encryption library. See 3D 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 XID obtained from the external MPI.

dsTransactionId

string

Optional

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

threeDSecureVersion

string

Optional

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

  • 1.0.2
  • 2.1.0
  • 2.2.0

threeDSecureReferenceId

string

Optional

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

Response

Property Name
Type
Description

authenticationResult

string

3-D Secure authentication result.

Possible values:

AUTHENTICATION_BYPASSED

AUTHENTICATION_SUCCEEDED

AUTHENTICATION_UNAVAILABLE

AUTHENTICATION_FAILED

For more information, refer to Authentication Results details.