I completed an order and no email arrived
Work through these in order:
- Is the switch on? WooCommerce → Next Order Coupons, "Email a coupon when an order is completed" (full edition: Send coupons).
- Did the order reach the right status? The free edition reacts to Completed only. The full edition reacts to the status chosen under Earned when the order reaches — if that is Completed, marking an order Processing does nothing.
- Does the order have a valid billing email? An order without one earns nothing.
- Was a coupon minted? Look under Marketing → Coupons for a coupon whose description names the order ("Next-order coupon, earned by order …"). If it is there, the plugin did its part and the email was lost on the way out — see the next question.
- Full edition: is the order below Only for orders worth at least? Is it a repeat order while On every order after that is off?
The coupon exists but the customer never got the email
The plugin hands the message to WordPress's wp_mail(). If your site cannot send mail reliably, the coupon is still minted and the message is lost. Fix your mail delivery with an SMTP plugin, then send the customer the code from the coupon by hand. Re-completing the order will not send it again — that is deliberate, see below.
Why doesn't completing the order again send another coupon?
Because one order earns one coupon, whatever happens. WooCommerce fires the status hook again every time an order goes back to Processing and is completed again. Before minting, the plugin writes a claim onto the order (order meta _gmnc_coupon), and any later run that finds it stops. Otherwise a customer could be handed two codes for one purchase.
If you genuinely want an order to earn a second coupon, delete the _gmnc_coupon custom field from the order (or create a coupon by hand).
The customer says the code is refused at the checkout
Check the coupon under Marketing → Coupons:
- Allowed emails holds the address that earned it. WooCommerce compares it with the billing email typed at the checkout, so a customer using a different address is refused. This is the point: a code posted on a deals site works for nobody else.
- Usage limit is 1. A code already used is used.
- Individual use only is ticked, so it cannot be combined with another coupon in the same cart.
- Coupon expiry date may have passed.
- Full edition: Minimum spend comes from Spendable on orders worth at least.
You can edit any of these on the coupon itself; the plugin never changes a coupon after it is minted.
Does it work with the Checkout block?
Yes. The coupon is an ordinary WooCommerce coupon, and the plugin's work happens when an order changes status, not on the checkout page. The classic checkout, the Checkout block and the Store API all accept it the same way.
Does it work with HPOS?
Yes. Both editions declare High-Performance Order Storage compatibility and read and write order meta through the order object, so it works with HPOS on or off. In the full edition the Next-order coupon box appears on both order screens.
Will a page cache or performance plugin interfere?
No. The plugin adds nothing to storefront pages — no script, no stylesheet, no output — so there is nothing to cache.
How does the full edition decide a first order?
By billing email, through WooCommerce's own order query: orders with the same billing email in Processing, Completed or On hold, other than this one. A guest's history counts; logging in or out, a private window or a new account changes nothing. Refunds are not counted as orders.
Can a customer earn a coupon by using a coupon?
Yes. Any qualifying order earns one. If you want to avoid it, use the full edition's Only for orders worth at least, or a developer can use the gmnc_coupon_kind filter (see the developer reference).
I changed the discount. Do old coupons change?
No. A coupon is written once, with the settings in force when it was minted. New settings apply to coupons minted from then on.
How do I move from the free edition to the full edition?
Install and activate the full edition beside the free one. Both use the same option (gmnc_settings) and the same claim on the order (_gmnc_coupon), so:
- your discount, expiry and on/off switch are already there;
- an order that earned a coupon under the free edition never earns a second one under the full edition.
While the full edition is active the free edition does nothing and says so on the Plugins screen. You can then deactivate and delete the free edition.
What happens if I uninstall?
- Full edition: deletes its settings (
gmnc_settings), its licence (gmnc_license), the cached update information and its licence check schedule. - Free edition: deletes
gmnc_settingsonly when the full edition has never been configured on the site; otherwise it leaves the shared settings alone.
Neither edition deletes a coupon or the _gmnc_coupon claim on an order. A coupon already emailed is a promise to a customer, and the claim is what stops a reinstall from minting a second code for the same order.
The free edition shows "WooCommerce is required"
The plugin needs WooCommerce active. Without it, it loads nothing and explains this in a line under its entry on the Plugins screen.
