Transaction Limits
Per-transaction, daily, weekly, and monthly limits with product and tier-based resolution.
Transaction limits let you cap how much money can move through a wallet
in a given period. Limits are enforced automatically on deposits and
withdrawals. If a transaction would exceed a limit, it is rejected with a
422 response.
Limit periods
| Period | Window |
|---|---|
PerTransaction | Each individual transaction |
Daily | Midnight-to-midnight UTC |
Weekly | Monday 00:00 UTC to Sunday 23:59 UTC |
Monthly | 1st of the month 00:00 UTC to last day 23:59 UTC |
Resolution priority
Limits are scoped by product and wallet tier. When checking a transaction, the engine finds the most specific matching rule for each period:
| Priority | Product | Tier | Score |
|---|---|---|---|
| 1 (most specific) | Set | Set | 3 |
| 2 | Set | Any | 2 |
| 3 | Any | Set | 1 |
| 4 (catch-all) | Any | Any | 0 |
For each period, the rule with the highest score wins. This means you can:
- Set a tenant-wide daily limit (product=null, tier=null)
- Override it for fully-verified wallets (product=null, tier=Full)
- Override it again for a specific product's
Fulltier
If no limit rule matches for a period, there is no limit for that period. Limits are opt-in. You only enforce what you configure.
The TransactionLimit object
{
"id": "tl_01HZ...",
"productId": "wp_01HZ...",
"productName": "Savings Account",
"walletTier": "Basic",
"transactionType": "Deposit",
"period": "Daily",
"maxAmount": 500000,
"currency": "GHS",
"isActive": true,
"createdAt": "2026-04-01T10:00:00Z",
"updatedAt": null
}Prop
Type
Create a limit
/api/v1/banking/limitsRequest body
Prop
Type
curl -X POST "https://api.shiwake.example.com/api/v1/banking/limits" \
-H "X-Api-Key: sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"transactionType": "Deposit",
"period": "Daily",
"maxAmount": 500000,
"currency": "GHS",
"walletTier": "Basic"
}'List limits
/api/v1/banking/limitsProp
Type
Update a limit
/api/v1/banking/limits/{id}Prop
Type
Delete a limit
/api/v1/banking/limits/{id}Check wallet usage
/api/v1/banking/wallets/{id}/limits/usageReturns the wallet's current usage against all applicable limits. See Wallets: Get limit usage for the response shape.
This is useful for showing users how much of their limit they've consumed before they attempt a transaction.
Last updated on