Plumtier Docs Deploy free

Plumtier Docs

Everything you need to sell from your own store and check license keys in your app.

Plumtier is a storefront and checkout that runs on your own Cloudflare account and takes payments through your own Stripe and PayPal. These docs cover what your website and your app talk to:

What you integrate

PieceWhere it livesWho calls it
Product pages/p/<link>Your website, emails, social posts
License API/api/v1/licenses/…Your app, with no secret key
Webhooks ProYour serverPlumtier, signed, with retries
Buyer's purchases/portalYour buyers, by email sign-in

Your store's address

Every store is its own deployment, so there's no shared API host. All examples use https://shop.example.com; use your store's address instead, such as https://plumtier.yourname.workers.dev or the custom domain you added.

Note
The license API is public on purpose: apps ship it and anyone can read an app's network calls. It never needs or accepts a secret key. Keys are long and random, and each key is tied to its product and its device limit.

Conventions

  • Requests are POST with a JSON body (Content-Type: application/json) or form fields (application/x-www-form-urlencoded). Both work everywhere.
  • Responses are JSON. Times are ISO 8601 in UTC. Money in webhooks is in minor units: 2900 is $29.00.
  • Cross-origin requests are allowed, so a web app can call the license API from the browser.
  • Every response of the same call has the same shape, with a boolean saying how it went and an error message when it didn't. See Errors.