First-Time Setup
A 10-minute checklist after activation. Each step links to the dedicated settings page that walks you through every field.
Prerequisite
Plugin installed and activated. See Installation if not.
All 8 steps live on the same Settings tab — Wallet → Settings:
The 8-Step Checklist
Work top to bottom. Each takes 1-2 minutes.
| # | Step | Setup page |
|---|---|---|
| 1 | Enable wallet payment gateway | Checkout Settings |
| 2 | Confirm recharge product exists | (one-time check, no settings page) |
| 3 | Set wallet defaults (currency, low-balance) | General Settings |
| 4 | Configure top-up presets + bonus | Recharge Settings |
| 5 | Choose notification preferences | Notifications Settings |
| 6 | Decide which features need KYC | KYC Settings |
| 7 | Pick payout methods (bank / PayPal / Stripe) | Withdrawal Settings + Payout Settings |
| 8 | Test a full top-up + spend cycle | front-end |
Step Details
1. Enable the Wallet Payment Gateway
Where: WooCommerce → Settings → Payments → Wallet → Manage
Why: Until you turn this on, customers can't pay with wallet at checkout.
What to do:
- Toggle Enable ON
- Set a friendly Title (
Pay with Wallet) - Allow split payment ON
Full walkthrough: Checkout Settings.
2. Confirm Recharge Product Exists
Where: Products → All Products → look for Recharge Your Wallet
Why: This is the WooCommerce product customers buy when they top up. Auto-created on activation.
If missing: WooCommerce → Status → Tools → Wallet → Recreate recharge product.
3. Set Wallet Defaults
Where: Wallet → Settings → General
Why: Pick currency, low-balance threshold, and display name (the brand of your wallet).
Full walkthrough: General Settings.
4. Configure Top-up Presets + Bonus
Where: Wallet → Settings → Recharge
Why: Choose the one-tap amounts customers see on the Add money panel. Optional bonus % to boost top-ups.
Full walkthrough: Recharge Settings.
5. Choose Notification Preferences
Where: Wallet → Settings → Notifications
Why: Decide which email + SMS notifications fire. Defaults are sensible; review which you actually want.
Full walkthrough: Notifications Settings.
6. Decide Which Features Need KYC
Where: Wallet → Settings → KYC
Why: Enable KYC + tick which features (withdrawal / transfer / etc.) require approved KYC. Most stores at minimum gate withdrawal.
Full walkthrough: KYC Settings.
7. Pick Payout Methods
Where: Wallet → Settings → Withdrawal + Wallet → Settings → Payout
Why: Tick which payout methods to expose (bank / PayPal / Stripe). Add credentials for PayPal + Stripe if used.
Full walkthroughs:
- Withdrawal Settings — min/max, fee, hold, methods toggle
- Payout Settings — PayPal + Stripe credentials
8. Test a Full Cycle
End-to-end smoke test:
- Log in as a test customer
- Top up
100via Add money - Complete the top-up order
- Confirm balance =
105if you set a 5% bonus - Place a normal order, pay with wallet
- Confirm balance =
105 - order_total - Open Wallet → Transactions — confirm two ledger rows (credit, debit)
- As admin, refund the test order via Refund-to-wallet → confirm credit row
If all 8 work, you're live.
Recommended Optional Next Steps
| Want to | Setup page |
|---|---|
| Reward customers with cashback | Cashback Settings |
| Run a referral programme | Referral Settings |
| Multi-level commission chain | Multilevel Settings |
| Daily login bonus | General Settings → Daily login section |
| BNPL pilot | BNPL Settings |
| QR receive / scan-to-pay | QR Pay Settings |
| Bulk credit from CSV | Bulk Credit / Debit |
| Standalone /wallet-central/ | Wallet Central Settings |
| Third-party integrations | Integrations Settings |
| REST API for automation | API Keys Settings |
Full Settings Index
Every settings tab and its dedicated page: Admin Settings.
When Something Goes Wrong
See Troubleshooting.
Related
- Quick Start — 5-minute end-to-end test
- Admin Tour — walk every wallet admin page
- Admin Settings — full settings index
- Installation