ShiwakeDocs

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

PeriodWindow
PerTransactionEach individual transaction
DailyMidnight-to-midnight UTC
WeeklyMonday 00:00 UTC to Sunday 23:59 UTC
Monthly1st 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:

PriorityProductTierScore
1 (most specific)SetSet3
2SetAny2
3AnySet1
4 (catch-all)AnyAny0

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 Full tier

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

POST/api/v1/banking/limits

Request 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

GET/api/v1/banking/limits

Prop

Type


Update a limit

PATCH/api/v1/banking/limits/{id}

Prop

Type


Delete a limit

DELETE/api/v1/banking/limits/{id}

Check wallet usage

GET/api/v1/banking/wallets/{id}/limits/usage

Returns 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.

Edit on GitHub

Last updated on

On this page