Configure targeted auth controls.

Configure card and program level targeted spend controls

Log in to see full request history
Path Params
string
required
Body Params
string | null

Program unique identifier. Program_guid or card_proxy are required.

string | null

Card identifier. Program_guid or card_proxy are required.

string | null

Card limit values

There are four selection options:
allow_all_except
allow_all
block_all
block_all_except

There are three different entities you can configure limits for:
mcc_list - Merchant category code ex 1711 - Air Conditioning, Heating, and Plumbing Contractors
mcc_list is defined as a range of mcc values. See examples
merchant_name_list - Merchant name i.e. Amazon.
Merchant names use value_has logic so "amazon" would select "amazon.com" or "amazon prime" or even "amazon river gift shop". See examples
merchant_id_list - AKA Merchant Identification Number (MID). This is number that uniquely identifies a particular merchant. For example 784959000762203
identifies Amazon.com. This configuration
merchant_id_list uses value_is logic. See examples

Examples
All three configured for allow_all_except
{
"card_auth_target_control": {
"allow_all_except": [
{
"mcc_list": [
{
"range": {
"from": "6011",
"through": "6012"
}
}
]
},
{
"merchant_id_list": [
{
"value_is":
["160146000762203","020014005912000"]
}
]
},
{
"merchant_name_list": [
{
"value_has": [
"Amazon",
"Amazon Prime"
]
}
]
}
]
}
}

/// All three configured for block_all
{
"card_auth_target_control": {
"allow_all_except": [
{
"mcc_list": [
{
"range": {
"from": "6011",
"through": "6012"
}
}
]
},
{
"merchant_id_list": [
{
"value_is":
["160146000762203","020014005912000"]
}
]
},
{
"merchant_name_list": [
{
"value_has": [
"Amazon",
"Amazon Prime"
]
}
]
}
]
}
}

Two MCC ranges defined
{
"card_auth_target_control": {
"allow_all_except": [
{
"mcc_list": [
{
"range": {
"from": "6011",
"through": "6012"
}
}
]
},
{
"mcc_list": [
{
"range": {
"from": "7011",
"through": "7012"
}
}
]
},
{
"merchant_id_list": [
{
"value_is":
["160146000762203","020014005912000"]
}
]
},
{
"merchant_name_list": [
{
"value_has": [
"Amazon",
"Amazon Prime"
]
}
]
}
]
}
}

string | null

Targeted card auth control expiration Date (Optional by default limit will never expire)
use the ccyy-mm-dd format.
Valid for card configuration only

Responses

500

Server Error

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json