Add Card Limit

To create a limit record for a card, you can send a POST request to the following endpoint:

POST /api/Limit/v{{version}}/AddCardLimit

The request body should contain the cardId, the cardProvider, and the full set of limit values across ATM, POS, and online channels, including daily/weekly limits and transaction counts for each.

This endpoint streamlines the process of configuring how a card can be used, offering granular control over spending and withdrawal behavior across every channel it supports.

Headers

Name	Value
Content-Type*	application/json

Body

Required

Name	Data Type	Required	Description
atM_Daily_Withdrawal_Limit	long		Determines the maximum amount that can be done in a week for the card specified as it relates to ATM transactions.
atM_Single_Withdrawal_Limit	long		Determines the amount that can be done in a single transaction for the card specified as it relates to ATM transactions.
atM_Daily_Withdrawal_Count	integer		Determines the maximum number of transactions that can be done in a day for the card specified as it relates to ATM transactions.
atM_Weekly_Withdrawal_Limit	long		Determines the maximum amount that can be done in a week for the card specified as it relates to ATM transactions.
poS_Daily_Transaction_Limit	long		Determines the maximum amount that can be done in a day for the card specified as it relates to POS transactions.
poS_Daily_Transaction_Count	integer		Determines the maximum number of transactions that can be done in a day for the card specified as it relates to POS transactions.
poS_Daily_Withdrawal_Limit	long		Determines the maximum amount that can be withdrawn in a day for the card specified as it relates to POS transactions. This has to do with POS withdrawal.
poS_Weekly_Withdrawal_Limit	long		Determines the maximum amount that can be done in a week for the card specified as it relates to POS transactions.
online_Daily_Transaction_Limit	long		Determines the maximum amount that can be done in a day for the card specified as it relates to web or online payment.
online_Daily_Transaction_Count	integer		Determines the count of transaction that can be done in a day for the card specified as it relates to web or online payment.
cardId	string		The ID of the card record.
cardProvider	integer		The card processor that hosts the card. Default (Interswitch) = 0, ARCA = 1, Providus = 2.

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

Sample Request

curl --location -g '{{baseUrl}}api/Limit/v{{version}}/AddCardLimit' \
--header 'Content-Type: application/json' \
--data '{
  "atM_Daily_Withdrawal_Limit": 10000,
  "atM_Single_Withdrawal_Limit": 2000,
  "atM_Daily_Withdrawal_Count": 3,
  "atM_Weekly_Withdrawal_Limit": 70000,
  "poS_Daily_Transaction_Limit": 10000,
  "poS_Daily_Transaction_Count": 3,
  "poS_Daily_Withdrawal_Limit": 2000,
  "poS_Weekly_Withdrawal_Limit": 70000,
  "online_Daily_Transaction_Limit": 10000,
  "online_Daily_Transaction_Count": 3,
  "cardId": "5099f14c-b963-4919-95a4-104a42eeedd8",
  "cardProvider": 0 // Default (Interswitch) = 0, ARCA = 1, Providus = 2
}'

Response: 200

{
  "status": true,
  "message": "Operation Successful"
}