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:
QuickstartFrom a new store to a sold license key, in about ten minutes.
Checkout linksProduct links, buy buttons, discount and affiliate links.
Add licensing to your appActivate on first launch, validate after, work offline.
WebhooksGet told when someone pays, refunds or subscribes.
What you integrate
| Piece | Where it lives | Who calls it |
|---|---|---|
| Product pages | /p/<link> | Your website, emails, social posts |
| License API | /api/v1/licenses/… | Your app, with no secret key |
| Webhooks Pro | Your server | Plumtier, signed, with retries |
| Buyer's purchases | /portal | Your 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
POSTwith 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:
2900is $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
errormessage when it didn't. See Errors.