Top-ups

How top-ups work

A top-up is an ordinary WooCommerce order carrying a single “Wallet top-up” line for the chosen amount. The customer picks an amount on their wallet page, lands on WooCommerce’s native payment page, and pays with any gateway you allow. The moment the order is paid, the wallet is credited, exactly once, no matter how many times the gateway notifies the site.

Because top-ups ride the standard order flow, everything you already have works on them: your payment gateways, fraud tooling, order emails, and order records.

Settings

WooCommerce → Settings → Elite Balance → Top-ups:

• Enable top-ups: the master switch. Off means no top-up form anywhere.
• Amount limits: minimum and maximum per top-up (defaults 5 and 500). The form enforces them and the server re-checks.
• Allowed gateways: which payment methods may fund a wallet. The wallet gateway itself is always excluded from paying for top-ups, for obvious circular reasons.
• Paid top-up order status: the status a successful top-up order lands in. Default is Completed, since there is nothing to ship; choose Processing if your bookkeeping expects it.

Things to know

• The credit is anchored to the top-up order: open the order and the ledger entry reference each other.
• Refunding a top-up order does not automatically remove the wallet funds (money is sacred); debit the wallet deliberately if that is what you intend, with a reason.
• A cancelled or failed top-up order credits nothing, ever.