How license keys work
Keys, devices, limits, expiry, and what changes a key's status.
Keys
Turn on License keys for a product and every copy sold gets one, like 7KQ2M-XW9PA-4TB8N-R2HDE: 20 characters from an alphabet without look-alike letters, in groups of five. Keys aren't case sensitive and surrounding spaces are ignored, so buyers can paste them carelessly.
Keys are shown on the receipt page, in the receipt email and in the buyer's purchases, and you can see and copy them in License keys in your dashboard.
Devices (instances)
Activating a key on a device creates an instance with an id and the name you send, like a computer's name. The key's activation limit caps how many instances it can have; leave it empty for unlimited. Activating the last free seat is atomic: two devices racing for it can't both win.
Instances are freed by deactivating from the app, by the buyer in their purchases, or by you in the dashboard.
Statuses
| Status | Means | Activate | Validate |
|---|---|---|---|
inactive | Sold but not activated on any device yet | Works | valid: true |
active | Activated on at least one device | Works until the limit | valid: true |
expired | Past its expiry date, or its subscription ended | Refused | valid: false |
disabled | Refunded, or turned off by you | Refused | valid: false |
What changes a key
- Full refund: the key is disabled, whether you refund in Plumtier or in Stripe or PayPal.
- Subscription ends: keys sold with a subscription expire when it does, and come back if it's renewed. While a payment is being retried they keep working.
- Valid for N days: set on the product, keys expire that long after purchase.
- You, in the dashboard: disable or enable a key, change its limit or expiry, or remove a device.
Different limits per option
Each product option can set its own activation limit, so Personal can allow one Mac and Family five. The key carries the limit of the option bought, and the response's meta.variant_name tells your app which one it is, if you want to unlock features by tier.
Tie keys to your product
Send product_id on every call: your product's link (like pastepal) or its id. A key bought for another of your products is then refused with a clear error, so a cheap product's key can't unlock an expensive one.