{"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}
three-d-secure
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.
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.