Quickstart

Build your first monetization flow in minutes.

Start in test mode, create a product, open Stripe checkout, and verify access from your backend. Licenzy handles the runtime billing flow on top of Stripe, so you do not have to rebuild subscriptions, credits, and access logic yourself.

Start free in test mode. Go live only when you're ready for real payments.

For setup details, see Stripe setup and checkout session. If you are comparing rollout timing, the pricing page explains when to move from test mode to production.

Test mode firstCreate checkout fastVerify access quickly

Start free Read docs

Runtime access checkConcrete integration example
TypeScript

const response = await fetch("https://api.licenzy.app/v1/access/check", {
  method: "POST",
  headers: {
    Authorization: "Bearer lz_test_***",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    subject_ref: "user_123",
  }),
});

const result = await response.json();
// { subject_ref: "user_123", allowed: true }

Integration flow

Stripe payment -> Licenzy entitlement -> app access.

The full loop should stay visible to the team. This is the shortest version that still explains how the system behaves in production.

Step 1

Connect Stripe

Save test Stripe credentials and webhook secret in the portal.

Step 2

Map products

Create Licenzy products that point at Stripe price IDs.

Step 3

Call Licenzy checkout

Create the session with `POST /v1/checkout/session` and redirect to `checkout_url`.

Step 4

Process webhooks

Stripe calls Licenzy directly and entitlements are updated there.

Step 5

Check access

Call `POST /v1/access/check` and optionally `POST /v1/usage/consume`.

Prerequisites

Start here before wiring your first request.

A Stripe account with at least one product price.
A backend that can keep Licenzy API keys private.
A stable customer or workspace ID.
A webhook endpoint that can verify Stripe signatures.

Recommended first milestone

Prove the test-mode loop end to end before thinking about live mode.

Create one test product in Stripe and one matching Licenzy product.
Create checkout through `POST /v1/checkout/session`.
Confirm Stripe webhook delivery updates entitlement state.
Confirm `POST /v1/access/check` returns the expected decision.

Start in test mode, then go deeper when needed

Quickstart is the shortest path to a working first flow. The full docs cover Stripe setup, product mapping, checkout context, webhooks and usage metering.

Start free Read docs