Wallets
Prepaid wallets hold customer credit balances with an optional monthly spend cap. They are the answer to "this customer should never owe us money" — services draw down the wallet, alerts fire as the balance approaches the cap, and the customer tops up before anything breaks.
Manage wallets at Billing → Wallets.
When should I read this?
- A courier point or reseller pays as they go and must never go negative.
- You want hard monthly spend control per customer, with a warning before the ceiling.
- A customer asks "how much credit do I have left?" and you want them to see it themselves.
Use cases
| Scenario | What you do |
|---|---|
| Prepaid reseller relationship | Create a wallet with a monthly cap; they top up by bank transfer; you add credits when funds land. |
| Controlling a high-variance customer | The cap hard-stops runaway spend; the 80% warning gives both sides time to react. |
| Customer checks their own balance | Share the portal link — the wallet tab shows balance, monthly spend, and every transaction. |
Create a wallet
On the wallets page, pick the Customer, optionally set a Monthly cap, and click Create wallet. Every wallet includes an alert threshold (80% of the cap by default) that drives the warning states below.
Balance states
Each wallet reports one of four alert states:
| State | Meaning | What to do |
|---|---|---|
| OK | Healthy balance under the threshold. | Nothing. |
| Warning (N%) | Spent past the alert threshold of the cap. | Nudge the customer to top up. |
| Capped | Monthly spend reached the cap. | Spend is blocked until the cap window resets or you raise the cap. |
| Empty | No credits left. | Top up before the customer can keep consuming. |
The list shows each wallet's balance, this-month spend, cap, and state at a glance.
Top up
Click Top up on a wallet, enter the amount, and confirm — the credits are added immediately with a "Manual top-up" ledger entry. The ledger distinguishes entry types: topup, consumption, adjustment, refund, and expiry, so every balance change is explainable later.
The customer's view
In the customer portal, the Wallet tab shows three cards — balance, this month against the cap, and a spend-status bar (Healthy / Approaching cap / Cap reached) — plus the recent-activity ledger with colored in/out amounts. Customers watch their own burn rate without contacting you.
Common issues
- Consumption isn't automatic everywhere yet. Wallet draw-down is available through the API; automatic wallet-first payment inside every billing flow is on the roadmap — reconcile via the ledger entries for now.
- Cap hit mid-month and the customer is angry. Raise the cap from the wallet record or top up; both take effect immediately.
- Need to undo a wrong top-up. Post an adjustment ledger entry rather than deleting history — the ledger is append-only by design.