Documentation / Elite Balance

about the plugin →

Wallet emails

The wallet and withdrawal emails, where to edit their text, and exactly when they do and do not send.

The wallet emails

Elite Balance registers its emails into WooCommerce’s own email system, so each lives on its own screen under WooCommerce → Settings → Emails, with the same controls as every WooCommerce email:

EmailDefaultSends when
Wallet creditedOnFunds are added: manual credits, refunds to wallet, top-ups.
Wallet debitedOnFunds are removed by a manual debit.
Wallet low balanceOffA spend pushes the balance below your threshold.

The withdrawal emails

Four more emails cover the withdrawal lifecycle. They ride the request events, so an idempotent replay (a double-clicked button, a retried script) never sends a duplicate:

EmailDefaultSends when
Withdrawal request receivedOnA customer opens a request; confirms the amount is reserved.
New withdrawal request (staff)OnSame moment, to a configurable staff address (default: the site admin email), linking straight to the request in the queue.
Withdrawal transferredOnStaff mark a request transferred; states the actual fee, the net amount sent, and the transfer reference.
Withdrawal rejectedOnStaff reject a request; includes the reason and that the funds are available again.

Payout details never ride any email; staff read them behind the capability wall. Extra placeholders per email: {method} everywhere, {net}, {fee}, and {reference} on the transferred email, {reason} on the rejected email, {customer} on the staff notification.

Editing the text

Open any email on its WooCommerce settings screen. Besides the standard subject and heading, each has a body text field right below the heading, and optional From name and From address overrides. The placeholders {amount}, {balance} (wallet emails), and {site_title} work in subjects, headings, and the body.

Full layout control (HTML structure, wrappers) is available through standard WooCommerce template overrides; see Template overrides.

When emails deliberately do not send

  • Order payments never send credited or debited emails. WooCommerce’s own order emails already tell that story; doubling it up trains customers to ignore wallet mail.
  • Migration imports never email. Importing ten thousand opening balances must not mass-mail your customer base.
  • A withdrawal transfer never sends the generic debited email. The dedicated transferred email, with fee, net, and reference, supersedes it.
  • The “Notify the customer” checkbox on every manual adjustment form lets you silence any single operation. On bulk operations it starts unchecked, because a bulk run can mean thousands of emails at once; tick it deliberately when that is what you want.

Low balance details

The low balance email has its own threshold setting (default 10) on its email screen. It fires only when a debit crosses the threshold from above, so a customer living below the threshold is not nagged on every purchase. It rides every kind of debit, including order payments, since spending is exactly when balances run low.

Stuck, or found a gap in these docs? Tell us and a human who works on the plugin answers.

Contact support →