COMING SOON
Update a restriction that has been created for an issued card. You can also activate or deactivate a restriction by setting active to true or false.
To update, activate, or deactivate a restriction, you will need:
PUT /v1/restrictions/{id}
Authorization: Bearer <access_token>
id REQUIRED
string (UUID)
ID of the card restriction.
financialAccountId
string (UUID)
ID of the integrated Financial Account. The issued card is linked to this Financial Account.
type
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 | Merchant Group ID |
MCC_GROUPS | Merchant Category Code (MCC) Group ID |
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
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
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
string enum, values: ALLOW, BLOCK
Whether transactions that comply with the restriction should be allowed or blocked. The following values are supported:
active
boolean, default: true
Whether the restriction is active.
startDateTime
string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz
Start date and time of the restriction. To create a permanent restriction, leave this field blank.
endDateTime
string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz
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
{
"active": true
}
SAMPLE RESPONSE
{
"financialAccountId": "7d08a89d-2ac5-4ed3-a6ca-ad7c974c994e",
"type": "ACQUIRER_ID",
"operator": "EQ",
"value": "1234",
"mode": "ALLOW",
"active": 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.