No articles match. Try another word, or contact us.

Sell software licenses with the activation API

Issue a unique key per sale, lock it to a number of devices, and check it from your software with a signed API.

Choose the License key (activation API) type when you sell your own software. Every unit sold creates a new key (no stock to upload), and your app asks SellPass whether the key is valid on that computer.

Set up the product

  • Key prefix: optional letters shown before the key, for example MYAPP-XXXXX-….
  • Devices per key: how many computers (HWIDs) one key works on. 0 means unlimited.
  • Valid for days: leave empty for a lifetime license.
  • Device resets buyers may do / 30 days: buyers who change computer can free their devices from the customer portal.

Check keys from your software

Send a POST request with product_id, key, hwid (a stable ID of the computer) and a random nonce:

  • /api/license/v1/activate: take a device slot.
  • /api/license/v1/validate: check the key on start-up (takes a free slot the first time).
  • /api/license/v1/deactivate: free this device.

The answer contains valid, a code (valid, invalid_key, expired, suspended, revoked, device_limit, not_activated), the expiry and the device count. Every answer has an X-Signature header: the HMAC-SHA256 of the raw body with your product's signing secret (Licenses). Check it, and check the nonce matches, so a fake server can't unlock your app.

Manage keys

Licenses lists every key. You can suspend, revoke, extend, change the device limit, reset devices or issue a key by hand. Refunds and chargebacks revoke keys automatically; a won chargeback restores them. The REST API has /v1/licenses too.

Still need help? Message our team and we will reply by email.

Contact support