The customer paid but got no key
Keys are issued when the order reaches Completed, not Processing. An order of only virtual, downloadable products completes by itself; anything else must be completed by hand (or by your fulfilment plugin). Complete the order and the keys are issued and emailed with the completed-order email.
Also check the product's Licensing tab: Sells license keys must be ticked (or, in the full edition, Product identifiers filled in) on the product or on the variation's parent.
The order note says a key could not be issued
Either the product's pool is empty, or PHP has neither libsodium nor OpenSSL (the settings screen shows a red banner in that case). Add keys to the pool — or ask your host to enable one of those extensions — and mark the order Completed again. Only the missing keys are issued; units that already have a key keep it.
My pool product shows "Out of stock"
That is the stock rule: a product selling from its pool is out of stock when the pool is empty. Paste more keys into Add keys to the pool and update the product.
Two customers bought the last pool key at once
A pool key is held when the order is placed — on the classic and the block checkout — so the moment the last key is held the product is out of stock and the next shopper cannot buy it. The order that holds the key gets exactly that key when it completes. A cancelled, failed or wholly refunded order gives its held key back to the pool. Only two checkouts finishing in the same instant can still both be accepted; the second then gets a "could not be issued" note until you add keys and complete it again.
A key I pasted into the pool was skipped
A key already in any pool — this product's or another's — is skipped, so one key can never be sold twice.
Where can I see a customer's full key?
In their emails, on their order page, in My Account → Licenses, and on the order's own screen in WooCommerce → Orders. Full edition: also in the CSV export. List screens show only the last five characters on purpose.
What happens when I refund an order?
A full refund revokes every key the order issued: the software keeps running where it is installed but gets no updates, and (full edition) the API answers revoked. A partial refund revokes nothing. Full edition: to revoke one key by hand, use Revoke in Recent licenses.
A customer moved servers and is out of activations
Full edition: they can free the old site themselves in My Account → Licenses → Deactivate. Staging and local sites (staging., dev., .test, localhost and similar) never use a slot.
A customer's key leaked
Full edition: Reset key in My Account issues a new key on the same license. Every activated site stays connected; the old key stops working. The reset is logged.
Can I sell keys for software that is not a WordPress plugin?
Yes: keys and the API work for anything that can make an HTTPS request — set Product identifiers to the name your software sends. The Releases upload and signed downloads are built for WordPress plugin zips (the version is read from the plugin's header).
Does it work with HPOS, the block checkout and caching?
Yes. Both editions declare HPOS and Cart/Checkout blocks compatibility, read orders through WooCommerce, and add the keys to WooCommerce's own order page and emails. The pool-as-stock rule works through WooCommerce's stock filters, so the Store API sees it too. The REST API answers are never cached by WordPress; exclude /wp-json/gatemi-lk/ from any CDN cache.
The API returns rate_limited
Each key gets 30 requests per route per five minutes (more for keys covering several products), and each address 600. Behind a CDN or load balancer every request appears to come from the proxy — declare its addresses with the gmlk_trusted_proxies filter. See the developer reference.
I am moving from the free edition to the full edition
Install and activate the full edition. It uses the same five tables, the same settings (including the encryption secret), the same product fields and the same order record, so every key carries over and a key issued by the free edition validates against the full edition's API. Free-edition keys are for the product's own slug, with one activation and no expiry; change a product's fields to give future keys a limit or term. The free edition stands down while the full edition is active.
What does uninstalling remove?
- Free edition: nothing, unless Delete every key and pool when the plugin is uninstalled was ticked and the full edition has never been configured on the site. Then it drops the five tables and its options.
- Full edition: always its gatemi.com licence state, update cache and rate-limit records. Only with Delete every license, activation, pool key, release and audit row… ticked does it also drop the five tables, delete the stored release packages and remove its settings.
Product fields and order meta are left in place either way.
