Get Limits
Read on details on transaction limits specific to wallet accounts
You will be able to retrieve the remaining transfer limits of a particular user's wallet based on your spec sheet and transactions they have already created.
The transfer limits are categorized into the following transfer and transaction types:
- 1.Load: Adding funds into the wallet through linked card or bank.
- 2.Unload: Withdrawing funds from the wallet to linked card or bank.
- 3.Internal: Sending funds to another wallet holder.
- 4.External: Sending funds to external recipients using transaction API. This limit can also be obtained using the Get Transaction limits API but is only applicable for Clients who are approved for both wallet and external transactions.
The remaining limits are also broken down into the following types:
- 1.Annual limit: Annual limit minus the amount already transfered this year.
- 2.Daily limit: Daily limit minus the amount already transfered today.
- 3.Monthly limit: Monthly limit minus the amount already transfered this month.
- 4.Wallet hold limit: Maximum wallet hold limit minus the actual balance of the wallet. This is particularly valid for LOAD transfer types as load amount shall not exceed remaining wallet hold limit.
Details
Request Sample
Response Sample
Field | Required | Type | Description |
---|---|---|---|
country | Response | String | 2-letter ISO code of the user’s country |
current_tier | Response | Numeric | Current tier of the user |
remaining_limit | Response | Object | Remaining transaction limit of the user in the current tier |
remaining_limit.annual_limit | Response | Numeric | Remaining annual transaction limit of the user in the current tier |
remaining_limit.monthly_limit | Response | Numeric | Remaining monthly transaction limit of the user in the current tier |
remaining_limi.daily_limit | Response | Numeric | Remaining daily transaction limit of the user in the current tier |
remaining_limit.wallet_hold_limit | Response | Numeric | Remaining amount that can be held in the wallet |
user_id | Response | UUID | UUID of the user |
type | Response | String | Transaction and transfer type for which the limits are applicable |
curl --location --request GET '{{url}}/users/{userId}/limits' \
--header 'X-Client-Id:{{client_id}} ' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json'
[
{
"country": "US",
"remaining_limit": {
"annual_limit": 10000,
"daily_limit": 200,
"monthly_limit": 5000
},
"type": "EXTERNAL",
"current_tier" : 1,
"user_id": UUID
},
{
"remaining_limit": {
"annual_limit": 6401.00,
"daily_limit": 1790.00,
"monthly_limit": 2310.00,
"wallet_hold_limit": 2000.00
},
"type": "LOAD",
"current_tier" : 1,
"user_id": UUID
},
{
"remaining_limit": {
"annual_limit": 9860.80,
"daily_limit": 22.00,
"monthly_limit": 4960.80
},
"type": "UNLOAD",
"current_tier" : 1,
"user_id": UUID
},
{
"remaining_limit": {
"annual_limit": 9876.60,
"daily_limit": 200,
"monthly_limit": 4906.60
},
"type": "TRANSFER",
"current_tier" : 1,
"user_id": UUID
}
]
Last modified 7mo ago