Plans & Checkout

Sell your product directly through PackEdge. List your pricing plans, send buyers to your provider's hosted checkout, and have the purchased license delivered straight back to your app for one-click activation. PackEdge is brand-neutral — these endpoints work for any product; just use your own public_key.

Base URL: https://api.packedge.dev/public/v1

List plans

GET /public/v1/plans?public_key=pk_your_public_key

Returns the product's active, public plans for rendering a pricing table.

{
  "plans": [
    {
      "id": "plan_…",
      "name": "Personal Yearly",
      "slug": "personal-yearly",
      "price": 49,
      "currency": "USD",
      "billingCycle": "yearly",
      "siteLimit": 1,
      "checkoutUrl": "https://api.packedge.dev/public/v1/checkout?public_key=pk_…&plan=personal-yearly"
    }
  ]
}

Send the buyer to checkout

GET /public/v1/checkout?public_key=pk_your_public_key&plan=<slug>

Responds 303 and redirects the buyer to the hosted checkout for your connected provider. After payment, PackEdge issues the license (via the provider webhook), emails it to the buyer, and — if you passed a return_url — bounces back to your app with the key for auto-activation.

Query parameters

Param	Required	Description
public_key	✅	Your product's public key.
plan	✅	Plan slug. (Or use the path form GET /public/v1/checkout/{planId}.)
email		Prefills + binds the purchase to this buyer email.
return_url		Your app URL to return to after purchase (e.g. your license page).
activate_param		Name of the query param PackEdge appends with the license key on success. Default packedge_activate.
pending_param		Name of the query param PackEdge appends if the license is still being provisioned at redirect time. Default packedge_pending.

Pick your own param names

activate_param / pending_param let each product use its own return params — so a site running two PackEdge-powered products never collides. Example: &activate_param=myplugin_activate&pending_param=myplugin_pending.

The post-purchase return

If you passed return_url, the buyer lands back on it with one of:

• Success: ?<activate_param>=<LICENSE_KEY> — activate it immediately.
• Still provisioning (rare; webhook hadn't landed yet): ?<pending_param>=1 — show a "license on its way (also emailed)" notice; it activates on next load.

Example (browser JS)

const PUBLIC_KEY = 'pk_your_public_key';
const ACTIVATE = 'myplugin_activate';
const PENDING  = 'myplugin_pending';

// 1) Send the buyer to checkout, asking PackEdge to use our param names.
function buy(planSlug, email) {
  const u = new URL('https://api.packedge.dev/public/v1/checkout');
  u.searchParams.set('public_key', PUBLIC_KEY);
  u.searchParams.set('plan', planSlug);
  if (email) u.searchParams.set('email', email);
  u.searchParams.set('return_url', location.origin + location.pathname);
  u.searchParams.set('activate_param', ACTIVATE);
  u.searchParams.set('pending_param', PENDING);
  location.href = u.toString();
}

// 2) On your return page, read the key and activate.
const params = new URLSearchParams(location.search);
const key = params.get(ACTIVATE);
if (key) {
  // POST /public/v1/licenses/activate with this key (see Licenses → Activate)
} else if (params.get(PENDING)) {
  // Show "your license is being provisioned and was emailed to you"
}

Notes

• The provider is whatever you've connected in the console under Settings → Payments — Stripe, Polar, Paddle, Lemon Squeezy, Creem or Dodo Payments — and the buyer sees that provider's checkout. See Payment providers for what each one needs.
• On purchase, PackEdge auto-issues the license with the plan's seat limit and emails it — so even without return_url, the buyer always gets their key.
• All /public/v1/* endpoints are CORS-open and need no secret (the public_key identifies the product, not a user).