Adding Funds

Customers can add funds to their WalletPro wallet at any time using any active payment gateway. Merchants can also credit balances manually from the admin, or configure auto-reload rules so balances replenish automatically when they fall below a threshold.

Overview

WalletPro supports four distinct ways to add funds to a customer wallet:

Gift credit and redemption codes are covered in their own documentation sections. This page covers the top-up flow, auto-reload, and admin manual credit.

Customer Top-Up (My Account)

Where to find it

Customers access the wallet from My Account > Wallet. The Wallet tab appears automatically for all registered customers once WalletPro is active. The top of the page shows the current balance; below that is an Add Funds panel.

Step-by-step: adding funds

1. Go to My Account > Wallet.
2. In the Add Funds panel, enter the amount to add.
3. Select a payment method from the list. Any gateway active in WooCommerce and marked as supported (see Gateway Compatibility below) will appear here. Saved payment methods (tokens) appear at the top.
4. Click Add Funds. WooCommerce processes the payment in the background through a dedicated top-up order.
5. On success, the wallet balance updates immediately and a confirmation notice appears. The transaction is recorded in the wallet statement.

Minimum and maximum top-up amounts

Merchants can set limits on how much a customer may add in a single transaction. These are configured at WooCommerce > WalletPro > Settings > Funding:

Gateway compatibility

WalletPro supports top-up via any WooCommerce payment gateway that processes standard orders. Gateways that rely on redirect flows (PayPal Standard, some regional gateways) work correctly, the customer is redirected and returned after payment, and the balance is credited on order completion.

Gateways that require a physical product or shipping address may not be compatible with the top-up order type. If a gateway does not appear in the customer's payment method list during top-up, check WooCommerce > WalletPro > Settings > Funding > Excluded gateways, the gateway may be on the exclusion list, or it may not support virtual/downloadable products.

Auto-Reload

Auto-reload automatically adds a fixed amount to a customer's wallet when the balance drops below a configured threshold. It requires a saved payment method (tokenized card or similar).

Customer setup

1. Go to My Account > Wallet > Auto-Reload.
2. Toggle Enable auto-reload on.
3. Set the Reload when balance falls below threshold (e.g. 10.00).
4. Set the Reload amount, the amount to add when the threshold is triggered (e.g. 50.00).
5. Select a saved payment method. If none exist, the customer must save one via My Account > Payment Methods first.
6. Click Save.

When any wallet debit causes the balance to fall below the threshold, WalletPro schedules an auto-reload via Action Scheduler. The reload runs within one minute and charges the saved payment method. If the charge fails, the auto-reload is suspended and the customer receives an email notification.

Merchant configuration

Navigate to WooCommerce > WalletPro > Settings > Auto-Reload:

Admin Manual Credit

Merchants can add or remove funds from any customer wallet directly from the admin without a payment transaction. This is useful for refunds, goodwill credits, contest prizes, or correcting errors.

Crediting a single customer

1. Go to WooCommerce > WalletPro > Customers.
2. Search for the customer by name or email.
3. Click Adjust Balance in the customer row.
4. In the modal, select Credit or Debit, enter the amount, and enter a Reason. The reason is stored in the audit ledger and may be visible to the customer in their statement depending on your settings.
5. Click Apply. The balance updates immediately.

Alternatively, open the customer's WordPress user profile at Users > [Customer Name] and scroll to the WalletPro meta box, which provides the same Adjust Balance control.

Bulk credit via CSV import

To credit multiple customers at once, navigate to WooCommerce > WalletPro > Customers > Import. Upload a CSV with the following columns:

The importer runs via Action Scheduler in batches of 100 rows. Results (including any skipped rows with errors) are emailed to the currently logged-in admin user on completion.

WP-CLI manual credit

Manual credits can also be applied from the command line:

# Credit $25.00 to a customer by email
wp wallet credit --user=customer@example.com --amount=25.00 --reason="Goodwill credit"

# Debit $10.00 (negative amount)
wp wallet debit --user=customer@example.com --amount=10.00 --reason="Manual correction"

# Check the resulting balance
wp wallet balance --user=customer@example.com

See the WP-CLI reference for a full list of flags and options.

Transaction Recording

Every fund addition, whether from a customer top-up, auto-reload, or admin credit, is recorded as an immutable entry in WalletPro's HMAC-chained audit ledger. Each entry includes:

• Timestamp (UTC)
• Transaction type (topup, auto_reload, admin_credit, etc.)
• Amount and currency
• Running balance after the transaction
• Source reference (order ID for gateway transactions, admin user ID for manual credits)
• Reason text
• HMAC chain hash (tamper detection)

Customers can view their transaction history and print a statement at My Account > Wallet > Statement. Merchants can export the full ledger for any customer or date range from WooCommerce > WalletPro > Reports > Export.

Related Settings Summary

All funding-related settings live under WooCommerce > WalletPro > Settings. The table below lists the relevant tabs and key settings referenced on this page: