Wallets
Give customers a stored-balance wallet for instant payments with zero processing fees
Wallets let customers pay from a stored balance, eliminating card processing fees on every wallet transaction. Customers fund their wallet via card or bank transfer, and future payments draw instantly from the balance.
What are Wallets?
A wallet is a closed-loop stored-balance account attached to each customer. When a customer has wallet funds available, they can pay invoices instantly without a card transaction — meaning zero processing fees for you.
Wallets support multiple balance types, expiry tracking via lots, and hold/capture mechanics for checkout atomicity.
Balance Types
Every wallet credit is tagged with a funding type that determines how the balance can be used:
| Funding Type | Description | Withdrawable |
|---|---|---|
| cash | Customer-funded via card or bank transfer | Yes |
| promotional | Merchant-issued promotional credit | No |
| code_redemption | Credit from redeeming a wallet code | Depends on code type |
| refund | Credit issued in lieu of a card refund | Yes |
| manual_adjustment | Manual adjustment by merchant | Yes |
How It Works
The wallet payment flow follows a hold/capture pattern for atomicity:
Fund → Hold → Capture → Settle- Fund — Customer tops up their wallet, or merchant credits the account
- Hold — At checkout, the required amount is reserved (held) from the balance
- Capture — Once the order is confirmed, the hold is captured as a debit
- Settle — The transaction is recorded and the invoice marked as paid
If the checkout is abandoned or fails, the hold is released and the balance is restored.
Wallet Settings
Configure wallet behavior for your account in Settings > Billing:
| Setting | Description |
|---|---|
| Auto-apply at checkout | Automatically apply wallet balance to invoices during checkout |
| Allow top-up | Let customers add funds to their wallet |
| Low balance threshold | Trigger a webhook when a customer's balance drops below this amount |
| Credit expiry days | Default expiry period for wallet credits (lots) |
| Top-up amounts | Preset top-up amounts shown to customers |
Related
- Managing Balances — Credit, debit, and transaction history
- Wallet Codes — Create and manage redeemable codes
- Checkout Integration — How wallets work at checkout
- Customer Portal — Customer-facing wallet features
- Products and Pricing — Product configuration