Add Funds

The full top-up form at /wallet-central/add-to-wallet/. Customers add money to their wallet here.

What Customers See

┌──────────────────────────────────┐
│  H1: Add to wallet               │
│  Sub: Pick an amount or type     │
├──────────────────────────────────┤
│  Quick top-up chips (3×2)        │
│  ₹100  ₹500  ₹1000               │
│  ₹2500 ₹5000 ₹10000              │
├──────────────────────────────────┤
│  Custom amount  [   ₹___  ]      │
│  You'll pay     ₹X.XX            │
│  Bonus banner   "+5% extra"      │
├──────────────────────────────────┤
│  [ Add to Wallet ] (violet CTA)  │
└──────────────────────────────────┘

Add Funds — full layout at /wallet-central/add-to-wallet/

How It Works

Pick a chip OR type a custom amount
The "You'll pay" line updates instantly
If a bonus is on, the green offer banner shows the live preview ("Pay ₹1000 and get ₹1050")
Click Add to Wallet → redirected to standard WC checkout
Pay normally with any payment gateway
Order completes → wallet credited (with bonus if enabled)

Same engine as legacy

This form uses the same WooCommerce add-to-cart flow as the legacy My Wallet recharge — same business logic, different UI.

Add Funds form card — preset chips, custom amount, You'll-pay row, submit

Quick Chips

Configurable in Wallet → Settings → Recharge → Preset chips. Default 100, 500, 1000, 2500, 5000, 10000.

3×2 grid. Click → fills the custom amount input.

Custom Amount

Validation	Source
Min	Recharge settings → Min top-up
Max	Recharge settings → Max per order
Numeric	Required (`step="0.01"`)

Below min or above max → JS alert blocks submit.

Bonus Preview

Green banner when bonus is enabled (admin → Recharge → Bonus enable):

💚 Offer: Get 5% Extra Credit on every Top-up! Pay ₹1000 and get ₹1050 in your wallet.

Updates live as the customer types. Hidden when bonus is off. See Deposit / Top-up Bonus.

Embed on a Custom Page

Drop the shortcode anywhere:

[wkwp_central_add_funds presets="50,100,200" min="50" max="500"]

Attribute	Notes
`presets`	comma list of chip amounts
`min`	min top-up
`max`	max per order
`allow_custom`	`yes` (default) or `no`
`bonus_preview`	`yes` (default) or `no`

Common Scenarios

Customer typed ₹50 but min is ₹100

Validation blocks submit with a hint. Customer adjusts.

Customer wants UPI specifically

The Pay-with hint row at the bottom is cosmetic. Actual payment method is chosen at checkout — UPI, card, COD all work. Whatever gateways you have enabled.

Recharge product missing

Plugin shows admin notice "Recharge product missing — recreate via Status Tools". See Recharge / Top-up.

When Something Goes Wrong

Problem	Fix
Bonus banner not showing	Bonus disabled OR amount below "Min top-up to qualify"
Custom amount input rejected	Below admin min or above max — adjust limits in settings
KYC-locked wallet	If KYC `wallet_usage` is gated, form replaced with "Verify KYC to top up" CTA

For developers — hooks

Hooks

Hook	Type	When
`wkwp_central_add_funds_presets`	filter	mutate chip list
`wkwp_central_add_funds_intro_html`	filter	rewrite intro section
`wkwp_central_add_funds_submit_url`	filter	swap form action
`wkwp_central_add_funds_after_submit`	action	analytics hook