Understand account limits
Understand the various limits that apply to a user account. Learn about the different tiers of limits for transactions and balances that govern account activity.
Manage and display limits to your customers
As regulated products, every account issued is governed by a set of limits. These limits are set depending on product use case, type of entities onboarded, and the jurisdiction of issuance. The limits are decided by the MatchMove Compliance team as per the risk classification and dictated by the regulatory partners and governing bodies.
Purse Limits
Purse limits denote the maximum funds that can be stored in the account at any given point in time. The system guarantees that funds added to the account will never breach the limit configured depending on the user's state.
Get the Account purse limits
The purse limit of any account can be retrieved by calling the Get Wallets API.
Call Get Wallets (GET /users/wallets) to retrieve the account details, which include, but are not limited to, purse and transaction limits.
Get Account / Wallet request
curl -X GET 'https://{{accounts_base_url}}/{{program_code}}/v1/users/wallets' \
--header 'X-Auth-User-Id: {{user_id}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: ••••••'Get Account / Wallet response (purse limit excerpt)
{
"details”:{
"purse": {
"pre_kyc": {
"purse_max_limit": 1000
},
"post_kyc": {
"purse_max_limit": 5000
}
}
}Transaction limits
Similarly, every account issued also has transaction limits imposed, depending on the product configured for the program owner. These limits are broken down into applicable transaction types and velocity and count limits for the transaction type.
The possible values of limits configured are illustrated in the table below
| The number of transactions for the transaction category that can be performed in a given day. The day is defined as per the program issuance region. |
| The cumulative value of the transactions in the issuance currency for the transaction category that can be performed on a given day. The day is defined as per the product issuance region. |
| Total Number of transactions for the transaction category that can be performed for the lifetime of the account |
| The cumulative value of the transactions for the transaction category that can be performed for the lifetime of the account |
| The total number of transactions for the calendar month that can be performed for the account. The duration is defined as per the product issuance region |
| The cumulative value of transactions for the calendar month that can be performed for the account. The duration is defined as per the product issuance region |
| The total number of transactions for the calendar week starting on that date can be performed for the account. The duration is defined as per the product issuance region |
| The cumulative value of transactions for the calendar week can be calculated for the account. The duration is defined as per the product issuance region |
| The total number of transactions for the calendar year that can be performed for the account. The duration is defined as per the product issuance region |
| The cumulative value of transactions for the calendar year that can be performed for the account. The duration is defined as per the product issuance region |
| The maximum value of a transaction for the transaction category that can be performed at any given point in time. |
Get Account / Wallet response (transaction limit excerpt)
{
"details": {
"topup": {
"pre_kyc": {
"daily_count_limit": null,
"daily_transactional_limit": 2250,
"lifetime_count_limit": null,
"lifetime_transactional_limit": null,
"monthly_count_limit": null,
"monthly_transactional_limit": 2250,
"weekly_count_limit": null,
"weekly_transactional_limit": 2250,
"annual_count_limit": null,
"annual_transactional_limit": 15000,
"unit_transactional_limit": 750
},
"post_kyc": {
"daily_count_limit": null,
"daily_transactional_limit": 500000,
"lifetime_count_limit": null,
"lifetime_transactional_limit": null,
"monthly_count_limit": null,
"monthly_transactional_limit": 500000,
"weekly_count_limit": null,
"weekly_transactional_limit": 500000,
"annual_count_limit": null,
"annual_transactional_limit": null,
"unit_transactional_limit": 500000
},
"current": {
"lifetime_count": 29,
"lifetime_transactional": 12037.25,
"daily_count": 0,
"daily_transactional": 0,
"weekly_count": 0,
"weekly_transactional": 0,
"monthly_count": 6,
"monthly_transactional": 3595.79
}
}
}
}Related Links
On this page
- Understand account limits