POST
/
external_cards
/
lookup_3ds
Lookup 3DS
curl --request POST \
  --url https://api.synctera.com/v1/external_cards/lookup_3ds \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "device_details": {
    "color_depth": 24,
    "header": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
    "ip_address": "1.12.123.255",
    "java_enabled": true,
    "javascript_enabled": true,
    "language": "en-US",
    "screen_height": 1080,
    "screen_width": 1920,
    "timezone": -300,
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36"
  },
  "authentication_indicator": "INSTALLMENT",
  "device_channel": "BROWSER",
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "transaction_mode": "COMPUTER_DEVICE"
}'
{
  "challenge_payload": "<string>",
  "challenge_url": "<string>",
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "processor_transaction_id": "<string>",
  "status": "CHALLENGE_REQUIRED"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string

An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Body

application/json

Details of the External Card Transfer 3DS authentication lookup.

Details for an External Card Transfer 3-D Secure Authentication lookup request

​
authentication_indicator
enum<string>
required
Available options:
INSTALLMENT,
PAYMENT,
RECURRING
​
device_channel
enum<string>
required

Channel through which Device Data Collection was performed

ChannelDescription
BROWSERInternet browser
SDKMobile app
Available options:
BROWSER,
SDK
Example:

"BROWSER"

​
id
string<uuid>
required

The unique identifier of the 3DS authentication

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
transaction_mode
enum<string>
required
Available options:
COMPUTER_DEVICE,
MOBILE_DEVICE,
TABLET_DEVICE
​
device_details
object

Optionally provided browser device details, used as a fallback in case there is an issue with Device Data Collection. Note that minimal field validation is performed.

Response

External Card Transfer 3DS authentication lookup complete

Details for an External Card Transfer 3-D Secure Authentication lookup response

​
id
string<uuid>
required

The unique identifier of the 3DS authentication

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
status
enum<string>
required

Status of the 3DS authentication

Available options:
CHALLENGE_REQUIRED,
FAILED,
NOT_ENROLLED,
SUCCESS,
UNKNOWN
​
challenge_payload
string

3DS challenge payload, returned if challenge is required

​
challenge_url
string<uri>

3DS challenge URL, returned if challenge is required

​
processor_transaction_id
string

Processor Transaction ID, returned if challenge is required