Wallet Codes
Create redeemable codes that add credit to a customer's wallet
A wallet code is a code a customer redeems to add credit to their wallet. Use codes for goodwill credit, promotions, gifts, referral rewards and refunds issued as credit.
Wallet codes are created in the dashboard and redeemed by customers in the customer portal or at checkout. There is no public API for creating or redeeming codes.
Wallets must be enabled in Settings → Wallets before you can create codes.
Create a code
- Go to Products → Wallet codes.
- Select Create Code.
- Fill in:
- Amount: the credit the code adds, in your account's default currency
- Code Type: Goodwill, Promotional, Gift, Referral or Refund
- Custom Code (optional): leave blank to generate a code in the format
RK-XXXX-XXXX - Expiry Date (optional): the code cannot be redeemed after this date
- Description (optional): an internal note
- Create the code.
You can also select Create Code on a customer's Wallet tab to create a code for that customer. Only that customer can redeem it.
Create codes in bulk
Select Bulk Create on the Wallet codes page. Set the Number of Codes (1 to 100), the Amount per Code, the code type, an optional expiry date and a description. Select Export CSV to download your codes.
Each code can be redeemed once.
How customers redeem a code
- Customer portal. The customer enters the code in Redeem a Code on their wallet page. The credit is added to their wallet straight away.
- Checkout. The customer enters the code in Enter wallet code. If the code cannot be applied, the payment does not go ahead. The customer is never charged the full price in place of the code.
A code is rejected when:
| Message | Cause |
|---|---|
| Invalid or inactive code | The code does not exist, or has already been redeemed or revoked |
| Code has expired | The expiry date has passed |
| Code is not valid for this customer | The code was created for a different customer |
Revoke a code
On the Wallet codes page, revoke an active code with its revoke (X) button. Revoking a code does not remove credit that was already redeemed.
Funding type
A code keeps the funding type it was created with. When it is redeemed, that funding type is copied to the new credit in the customer's wallet.
Related
- Wallets Overview -- How wallets work
- Managing Balances -- Credit and debit in the dashboard
- Customer Portal -- Customer redemption
Owner: david · Reviewed 30 Sep 2026 · Next review 29 Dec 2026