Gatemi Smart Coupons FAQ and Troubleshooting

The order was paid but no code was emailed

Check in this order:

  1. The status. The free edition issues only when the order reaches Completed; a Processing order has issued nothing yet. The full edition issues on the statuses in Selling & delivery → Issue on (default Processing and Completed).
  2. The product. Free edition: Gift certificate must be ticked on the product. Full edition: the product needs at least one coupon in Coupons to hand out.
  3. The order notes. The free edition writes "Gift certificate(s) issued: …" when it issues. No note means nothing was issued.
  4. Coupon activity (full edition). The row shows Pending, Sent or Failed with the reason. Retry sends a failed one again; a site that cannot send mail at all usually needs an SMTP plugin.
  5. A delivery date (full edition). A coupon scheduled for a later day is created when the order is paid and emailed on that day by an hourly cron, so a quiet site with no visits may send it late.

Will a status change issue the certificate twice?

No. The free edition records the issued codes on the order and issues nothing if they are already there. The full edition writes a unique dedupe_key per order line, template and recipient, so a replayed status change cannot create a second coupon.

What is a free-edition certificate worth?

The line subtotal divided by the quantity: what the item was sold for, including a sale price, before any cart-level coupon and without tax. A £25 certificate bought with a 10% cart coupon still issues at £25.

Can the free edition's certificate be spent in parts?

No. It is a single-use fixed cart coupon. If the order total is lower than its value, the rest is not kept. Spending a little at a time is store credit, which is the full edition's Store Credit / Gift certificate discount type with a balance and a ledger.

A store credit card shows the wrong balance

Open the coupon and look at its Smart Coupons tab. The ledger lists every movement — issue, redeem, restore, expire, adjust — with the balance after each one. The amount charged is read from the paid order, so if the order was edited before payment the ledger follows the order, not the cart. Refunds restore the refunded proportion; a cancelled or failed order restores the whole charge.

The coupon panel does not appear

  1. Check Display → Show on includes the page you are looking at.
  2. The panel renders nothing when the shopper has nothing to use. It offers coupons issued to the shopper's address and coupons marked Show to everyone, and only those that pass WooCommerce's own validity check and the coupon's conditions.
  3. A guest has no address until they type one, so they usually see only Show to everyone coupons.
  4. Elsewhere, place it with [gmsc_coupons].

My Account → Coupons gives "page not found"

The full edition adds a Coupons tab to My Account on the coupons endpoint. WordPress only learns a new endpoint when its rewrite rules are rebuilt; the plugin rebuilds them once, on the first request after the endpoint is added. If the tab still answers "page not found" — a cache plugin serving an old copy of the rules, say — go to Settings → Permalinks and press Save Changes once.

Does it work with the Cart and Checkout blocks?

Yes. Store credit's remainder is a negative fee, which the blocks and the Store API display natively. The gift form is on the product page, so it works whichever checkout you use. The coupon panel is rendered by the server next to the Cart and Checkout blocks rather than inside the block's own interface.

Does it work with page caching?

Yes. The panel's Apply buttons are ordinary links, and a coupon link (?gmsc-coupon=CODE) is handled when the request reaches WordPress. If your cache serves the cart or checkout from cache, exclude those pages, as WooCommerce already recommends.

Is it compatible with HPOS?

Yes. Both editions declare High-Performance Order Storage compatibility and read and write orders through WooCommerce's order API.

"Apply before tax" and "Maximum discount" make no difference

In version 1.0.0 both are saved but not yet read by the code that applies the discount. Apply before tax (Store credit tab) does not change how credit is applied, and Maximum discount on a coupon's Smart Coupons tab does not cap it. Use WooCommerce's own restrictions for now.

I did not ask for reminder emails, but customers get them

Remind before expiry is stored with a default of 7 days, so a coupon with an expiry date and Send an expiry reminder on (the default) is reminded about once, seven days before it expires. Set Remind before expiry to 0 on the Selling & delivery tab to stop it.

Moving from the free edition to the full edition

The two editions do not share settings or product markers. After installing the full edition (the free one stands down while it is active):

  1. Create a template coupon for each gift certificate you sell.
  2. Pick it in Coupons to hand out on each product that had Gift certificate ticked.
  3. Deactivate and delete the free edition.

Every certificate already issued is an ordinary WooCommerce coupon and keeps working; the order meta _gmscf_codes stays on each order as the record of what was issued.

What happens when I uninstall?

  • Free edition: removes the product marker and the _gmscf_issued mark on coupons. Issued coupons are not deleted — they are promises the store has made — and _gmscf_codes stays on orders.
  • Full edition: always removes its cron events, the licence state and the cached update data. Everything else — tables, settings, coupon and product meta — is removed only when Delete everything on uninstall is on. Coupons themselves are never deleted.
Shopping Cart
Scroll to Top