POST
/
external_cards
/
initialize_3ds
Initialize 3DS
curl --request POST \
  --url https://api.synctera.com/v1/external_cards/initialize_3ds \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 2,
  "currency": "USD",
  "external_card_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7"
}'
{
  "device_data_collection_jwt": "<string>",
  "device_data_collection_url": "<string>",
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7"
}

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 to initialize.

Initialization for an External Card Transfer 3-D Secure Authentication request

​
amount
integer
required

Amount in cents of the External Card Transfer to be authenticated

Required range: x >= 1
​
currency
string
required

ISO 4217 Alpha-3 currency code

Required string length: 3
Example:

"USD"

​
external_card_id
string<uuid>
required

The ID of the External Card for which the 3DS Authentication will be performed

Example:

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

Response

External Card Transfer 3DS authentication initialized

Initialization for an External Card Transfer 3-D Secure Authentication response

​
device_data_collection_jwt
string
required

JWT used for device data collection

​
device_data_collection_url
string<uri>
required

URL used for device data collection

​
id
string<uuid>
required

The unique identifier of the 3DS authentication

Example:

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