Skip to Content
Getting StartedSetting Up Licensing

Setting Up Licensing

Sell your plugin with a real license key: activation limits, expiry, and a store integration that issues licenses automatically when a sale completes. Licensing is configured per Product, from your Organization dashboard’s Licensing section.

License Plans

A Plan is the pricing tier a license is issued from — its activation limit (how many sites one license can run on at once) and validity period (how long it lasts). Changing a Plan later only affects licenses issued after the change: a customer who already bought “Agency” keeps exactly the terms they paid for, even if you edit or archive the plan afterwards.

Creating a plan

  1. From Licensing → Plans, pick the Product this plan is for (the selector at the top of the section), then click New plan.
  2. Fill in:
    • Name — shown to your team and copied onto every license issued from it, e.g. Agency, Single Site.
    • Activation limit — how many sites one license can be active on at once. Check Unlimited instead of a number if this plan has no cap.
    • Validity (days) — how many days after issue a license stays valid. Check Lifetime instead of a number for a plan that never expires.

Both blank inputs are deliberately not how you express “no limit” — Unlimited and Lifetime are their own checkboxes, so there’s no ambiguity between “I forgot to fill this in” and “this plan genuinely has no cap.”

Archiving a plan

Retiring a tier? Archive it rather than delete — archived plans stop appearing as an option for new licenses, but every license already issued under one keeps working exactly as before, and the plan stays visible (greyed out, sorted after your active ones) so you can always see what a customer’s license was originally issued under.

Store Integration

Wire your store (WooCommerce, a custom checkout, anything that can make an HTTP request) to issue a license automatically the moment a sale completes — no one has to open the org panel by hand.

Generating a secret

From Licensing → Store Integration, click Generate secret. The raw secret is shown exactly once — copy it into your store’s code immediately. Appneck never stores it in a retrievable form and cannot show it to you again; if you lose it, Regenerate to get a new one (this replaces the old one immediately, so update your store’s code at the same time).

Revoke removes the secret entirely — every webhook call fails immediately afterwards, with no grace period. Use it if the secret may have leaked.

Calling the webhook

Hand this to whoever builds your checkout integration:

  • URL: POST https://appneck.com/webhooks/v1/licenses/issue
  • Headers:
    • X-Appneck-Product — your product’s slug
    • X-Appneck-Timestamp — the current Unix timestamp, in seconds
    • X-Appneck-Signature — hash_hmac('sha256', timestamp . '.' . raw_body, secret)
  • Body (JSON): plan_name (must match an existing plan’s name exactly), customer_name, customer_email, and external_reference.

Optionally add marketing_consent — {"opted_in": true, "wording": "<the exact text the buyer saw>"}, plus an optional ip — when the buyer ticked an email opt-in at checkout. wording is required whenever opted_in is true. Without the object (or with opted_in: false) nothing changes: no contact is created, because a license by itself never subscribes anyone.

Always send external_reference — your own order or subscription id. Appneck uses it to recognise a retried delivery as the same sale: calling the webhook twice with the same reference returns the existing license instead of issuing a second one. Every real store retries a slow or dropped response sooner or later, so omitting this field means a slow network day quietly double-issues licenses for single sales.

The exact request headers, the signature formula, and a copyable PHP sample are also shown live on the Store Integration page itself, generated against your actual product slug and webhook URL — copy from there rather than retyping the sample above.

For a worked example per platform (WooCommerce, Easy Digital Downloads, Shopify/Gumroad/Lemon Squeezy/Paddle, Laravel/generic PHP, or a plain curl command to test with first), see Store Integration →. Something not working? See Troubleshooting → for every error the webhook can return.

Next: Licensing (WordPress SDK) → — if you also maintain the plugin side, this is how it talks to what you just configured.