Sign in

v3

latestOpenAPI 3.0.3Apache 2.02026-07-312637031.3 MB
External Cards

Lookup 3DS

Using device collection data, performs a lookup for an External Card Transfer 3DS authentication. The results will indicate whether the transfer is successfully authenticated or if a 3DS challenge is required.

post/external_cards/lookup_3ds

Headers

Idempotency-Keystring
Example:7d943c51-e4ff-4e57-9558-08cab6b963c7

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.

Request body

OR

Example request

{
  "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",
    "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"
  },
  "device_channel": "BROWSER",
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7"
}

Response

External Card Transfer 3DS authentication lookup complete

challenge_payloadstring

3DS challenge payload, returned if challenge is required

challenge_urlstring uri

3DS challenge URL, returned if challenge is required

idstring uuid required

The unique identifier of the 3DS authentication

processor_transaction_idstring

Processor Transaction ID, returned if challenge is required

status'CHALLENGE_REQUIRED' | 'FAILED' | 'NOT_ENROLLED' | 'SUCCESS' | 'UNKNOWN' required

Status of the 3DS authentication

Example response

{
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7"
}