COMING SOON
An issued card inherits the restrictions defined in the Card Program used to issue the card. You can also create additional restrictions for an issued card.
A restriction can either allow or block a transaction. For example, a restriction could allow transactions in a specific country, or could block transactions over a specific amount.
A restriction uses the following structure:
type operator value mode
For example, the following restriction does not allow ATM withdrawals over $500:
“type”: “CASH_WITHDRAWAL_TRANSACTION_AMOUNT_LIMIT”,
“operator”: “GT”,
“value”: “500”,
“mode”: “BLOCK”
To create a restriction, you will need:
Note To enable and disable card restrictions, use the Update Card Restriction API.
POST /v1/restrictions
Authorization: Bearer <access_token>
financialAccountId REQUIRED
string (UUID)
ID of the integrated Financial Account. The issued card is linked to this Financial Account.
type REQUIRED
string enum
Type of card restriction. The following values are supported.
Acquirer Controls |
|
---|---|
Value |
Description |
ACQUIRER_ID |
Acquirer ID |
ACQUIRER_ID_MERCHANT_ID |
Acquirer ID and Merchant ID |
ACQUIRER_ID_DEVICE_ID |
Acquirer ID and Device ID |
Merchant Controls |
|
---|---|
Value |
Description |
MERCHANT_ID |
Merchant ID |
MERCHANT_NAME |
Merchant Name |
BRAND_MERCHANT_ID |
Brand Merchant ID |
MERCHANT_GROUPS |
|
MCC_GROUPS |
Device Controls |
|
---|---|
Value |
Description |
DEVICE_OR_TERMINAL_ID |
Device or Terminal ID |
Channel Controls |
|
---|---|
Value |
Description |
BLOCK_ONLINE_TRANSACTIONS |
Block Online Transactions |
BLOCK_POS_PURCHASES |
Block POS (point of sale) Purchases |
BLOCK_ATM_WITHDRAWALS |
Block ATM Withdrawals |
BLOCK_PHONE_AND_MAIL_TRANSACTIONS |
Block by Phone or Mail Transactions |
BLOCK_INTERNATIONAL_TRANSACTIONS_CH |
Block International Transactions |
Transaction Limit Controls |
|
---|---|
Value |
Description |
PURCHASE_TRANSACTION_AMOUNT_LIMIT |
Purchase Transaction Amount Limit |
DAILY_PURCHASE_LIMIT |
Daily Purchase Limit |
CASH_WITHDRAWAL_TRANSACTION_AMOUNT_LIMIT |
Cash Withdrawal Transaction Amount Limit |
DAILY_CASH_WITHDRAWAL_LIMIT |
Daily Cash Withdrawal Limit |
Location Controls |
|
---|---|
Value |
Description |
CITY |
City |
STATE |
State |
COUNTRY |
Country |
COUNTRY_ZIPCODE |
Country and Zip Code |
CARDHOLDER_CITY |
Cardholder City |
CARDHOLDER_STATE |
Cardholder State |
CARDHOLDER_COUNTRY |
Cardholder Country |
BLOCK_INTERNATIONAL_TRANSACTIONS_LOC |
Block International Transactions |
BLOCK_DOMESTIC_TRANSACTIONS_LOC |
Block Domestic Transactions |
Load Controls |
|
---|---|
Value |
Description |
MAXIMUM_CARD_BALANCE_LIMIT |
Maximum Card Balance Limit |
DAILY_LOAD_AMOUNT |
Daily Load Amount |
DAILY_LOAD_FREQUENCY |
Daily Load Frequency |
MONTHLY_LOAD_AMOUNT |
Monthly Load Amount |
MONTHLY_LOAD_FREQUENCY |
Monthly Load Frequency |
operator REQUIRED
string enum, values: EQ, NE, GT, GE, LT, LE, BW, NB, IN, NI, CT, NC, LK, NL
Operates on the restriction value. The following values are supported:
value REQUIRED
string
Value of the restriction.
If type is set to MERCHANT_GROUPS, enter one or more Merchant Group IDs.
If type is set to MCC_GROUPS, enter one or more Merchant Category Code (MCC) Group IDs.
mode REQUIRED
string enum, values: ALLOW, BLOCK
Whether transactions that comply with the restriction should be allowed or blocked. The following values are supported:
enabled
boolean, default: true
Whether the restriction is active.
startDateTime
string (date-time)
Start date and time of the restriction. To create a permanent restriction, leave this field blank.
endDateTime
string (date-time)
End date and time of the restriction. To create a permanent restriction, leave this field blank.
Returns the Card Restriction object. This object contains the restriction details.
SAMPLE REQUEST
{
"financialAccountId": "7d08a89d-2ac5-4ed3-a6ca-ad7c974c994e",
"type": "MERCHANT_NAME",
"operator": "LK",
"value": "Costco",
"mode": "BLOCK",
"enabled": true,
"startDateTime": "2023-01-26T06:00:000Z",
"endDateTime": "2024-01-25T05:59:999Z"
}
SAMPLE RESPONSE
{
"financialAccountId": "7d08a89d-2ac5-4ed3-a6ca-ad7c974c994e",
"type": "ACQUIRER_ID",
"operator": "EQ",
"value": "1234",
"mode": "ALLOW",
"enabled": true,
"startDateTime": "2023-02-13T02:36:05.410Z",
"endDateTime": "2024-02-13T02:36:05.410Z",
"id": "9e573a4c-7859-4ec2-bf57-aace7dcf5981",
"createdAt": "2023-02-13T02:36:05.410Z",
"createdBy": "string",
"updatedAt": "2023-09-13T02:36:05.410Z",
"updatedBy": "string"
}
© 2022 Rocket Financial. All rights reserved. RocketFNCL, RocketKOR, RocketBNK are trade names of Rocket Financial Inc.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL
© 2023 by Rocket Financial Inc. All rights reserved.