Before you start
You need:- An account with Stripe, Lemon Squeezy or Polar, with at least one product already set up there
- Permission to create webhooks and edit checkout settings in that account
- A card — every plan requires one at checkout, even during a trial
Set up your store
1
Create your store
Go to app.keyplar.com/signup, enter your email and pick a
store name. Your store address is derived from it:
https://yourstore.keyplar.com.You’ll get an email with a sign-in link. That link is the only way into your new store, so
open it on a device you can work from.Some names are reserved and can’t be used as a store address —
app, www and api
among them. The signup form tells you if the one you want is taken.2
Pick a plan
You land in the admin panel with the full navigation visible, but most pages are walled off
until you subscribe. Open Billing, compare Starter and Pro, and subscribe.If a trial is running, you still enter card details at checkout — you’re just not charged
until the trial ends. See Billing and plans for what each plan includes.
3
Connect your payment gateway
Open Settings. Each gateway has a panel holding two things you’ll paste into the
gateway, and two things you’ll paste back into Keyplar:Secrets are encrypted before they’re stored, and only your store can use them.
Follow the page for the gateway you use — the events to subscribe to and the exact redirect
syntax differ:
Stripe
Lemon Squeezy
Polar
4
Create a benefit
A benefit is the thing a customer actually receives. Open Benefits → New benefit and
create one — a License key benefit is the quickest to test, since it needs no file
upload.Give it a name your customers will see (for example,
Pro license), and leave the options
at their defaults for now.See Benefits overview for all five types.5
Create a product and map it to your gateway
Open Products → New product. Name it, attach the benefit you just created, then fill
in the mapping field for your gateway:
This mapping is how an incoming purchase finds the right product. Get it wrong and the order
still arrives — Keyplar creates a placeholder product for it — but no benefits are delivered
until you fix the mapping.
6
Make a test purchase
Buy your own product through your gateway’s normal checkout, using a test card if the
gateway supports one.After paying you should be redirected to your store and see the order — the product, the
benefit, and the license key — without signing in. That page stays valid for one hour.
7
Confirm it landed in admin
Back in the admin panel, open Orders. The purchase should be listed, with the customer’s
email and the benefit granted against it. Licenses shows the key that was issued.If the order is there but the benefit isn’t, the product mapping didn’t match — check
Products for a placeholder product holding that purchase.
What to do next
Import your history
Backfill orders you made before Keyplar existed, so returning customers find their purchases
waiting.
Add downloads
Upload the files your product actually ships.
Brand your store
Store name, logo and which sign-in options customers see.
Use your own domain
Serve the store at
shop.yourdomain.com instead.Validate keys from your app
Call the License API from your software.
Invite your team
Give colleagues admin access to the store.