Checkout Integration
How customers use a wallet balance and wallet codes at hosted checkout
Customers can spend their wallet balance at RevKeen hosted checkout and on hosted invoice pages. The wallet pays as much as it can, and the rest is charged to the customer's card.
Wallet balances are applied by RevKeen hosted checkout. There is no public wallet API for custom checkouts, so a checkout you build yourself cannot read or spend a wallet balance.
Use wallet balance
A returning customer with a wallet balance sees Use wallet balance, with their available balance, on the payment form.
- If the balance covers the full amount, no card is charged.
- If it covers part of the amount, the wallet pays that part and the card is charged the rest.
- A customer with no balance does not see the option.
Example
Amount due: £50.00
Wallet balance: £20.00
Wallet applied: £20.00
Card charge: £30.00
New balance: £0.00If a payment fails
- If the card is declined after the wallet was applied, the wallet is credited back with the same funding types that were used.
- If the wallet cannot be applied, the card is charged the full amount instead.
Wallet codes at checkout
Customers can enter a code in Enter wallet code on the checkout page. The code's value is applied to the payment. If the code cannot be applied, the payment does not go ahead, so the customer is never charged the full price in place of the code. See Wallet Codes.
Recurring charges
For subscription and other recurring charges, turn on Auto-Apply to Invoices in Settings → Wallets. The wallet balance is then used before the customer's payment method is charged.
Related
- Wallets Overview -- How wallets work
- Managing Balances -- Credit and debit in the dashboard
- Wallet Codes -- Redeemable credit codes
- Checkout -- Hosted checkout behaviour and configuration
Owner: david · Reviewed 30 Sep 2026 · Next review 29 Dec 2026