Skip to main content
POST
/
cards
/
three_ds_decision_gateways
Create 3DS Decision Gateway
curl --request POST \
  --url https://api.synctera.com/v1/cards/three_ds_decision_gateways \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "card_products": [
    "4caf8488-6c94-494a-a73d-11fc893312c8"
  ],
  "custom_headers": {},
  "decision_url": "<string>",
  "fallback_decision": "EXEMPT",
  "is_active": true
}'
{
  "card_products": [
    "29346ae3-6481-48c0-ada4-13a60f2d1bd1"
  ],
  "creation_time": "2010-05-06T12:23:34.321Z",
  "custom_headers": {},
  "decision_url": "<string>",
  "fallback_decision": "EXEMPT",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": true,
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "tenant": "abcdef_ghijkl"
}

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

The 3DS Decision Gateway to be created

​
card_products
string<uuid>[]
required

List of Card Product IDs that will use the 3DS decision gateway

​
decision_url
string<uri>
required

URL of the 3DS decision gateway

Maximum length: 1000
​
fallback_decision
enum<string>
required

Possible decision responses when faced with a EMV 3-D Secure transaction.

PolicyDescription
SMS_OTPUse the card holder's phone number on file to perform advanced authentication via SMS
EXEMPTTransactions will be exempted from advanced authentication
Available options:
EXEMPT,
SMS_OTP
​
is_active
boolean
required

The 3DS decision gateway will only be used if this is true.

​
custom_headers
object

These key-value pairs define custom HTTP headers that will be included in every HTTP request to the gateway. Note that when updating this field, all key-value pairs will be replaced. They are not merged with existing data.

Response

The newly-created 3DS Decision Gateway

​
card_products
string<uuid>[]
required

List of Card Product IDs that will use the 3DS decision gateway

​
creation_time
string<date-time>
required

The timestamp when the 3DS decision gateway was created

Example:

"2010-05-06T12:23:34.321Z"

​
decision_url
string<uri>
required

URL of the 3DS decision gateway

Maximum length: 1000
​
fallback_decision
enum<string>
required

Possible decision responses when faced with a EMV 3-D Secure transaction.

PolicyDescription
SMS_OTPUse the card holder's phone number on file to perform advanced authentication via SMS
EXEMPTTransactions will be exempted from advanced authentication
Available options:
EXEMPT,
SMS_OTP
​
id
string<uuid>
required

The unique identifier of an 3DS decision gateway

​
is_active
boolean
required

The 3DS decision gateway will only be used if this is true.

​
last_updated_time
string<date-time>
required

The timestamp when the 3DS decision gateway was last modified

Example:

"2010-05-06T12:23:34.321Z"

​
tenant
string
required

The id of the tenant containing the resource.

Example:

"abcdef_ghijkl"

​
custom_headers
object

These key-value pairs define custom HTTP headers that will be included in every HTTP request to the gateway. Note that when updating this field, all key-value pairs will be replaced. They are not merged with existing data.