Skip to main content
PATCH
/
cards
/
three_ds_decision_gateways
/
{id}
Update 3DS Decision Gateway
curl --request PATCH \
  --url https://api.synctera.com/v1/cards/three_ds_decision_gateways/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "card_products": [
    "7d943c51-e4ff-4e57-9558-08cab6b963c7"
  ],
  "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"

Path Parameters

​
id
string<uuid>
required

The unique identifier of an 3DS decision gateway

Body

application/json

Updated 3DS Decision Gateway fields

​
card_products
string<uuid>[]

List of card product unique IDs that will use the 3DS decision gateway. Note that the list of card product IDs from this request does not merge with the 3DS gateway's previous list of card product IDs. The list of card product IDs for the gateway will be fully replaced by the list from the update request, if any such list is included in the request.

​
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.

​
decision_url
string<uri>

URL of the 3DS decision gateway

Maximum length: 1000
​
fallback_decision
enum<string>

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

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

Response

The updated 3DS Decision Gateway Updated

​
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.