Quickstart

Build your first monetization flow in minutes.

Start in test mode, verify email, choose a project, create a test API key, 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 , tenant webhook setup and outbound Licenzy webhooks, plus checkout session. If you are comparing rollout timing, the pricing page explains when to move from test mode to production.

Test API key firstFirst runtime call: checkoutFirst verification call: access
Start freeRead docs
runtime.licenzy.app
createdPOST /v1/checkout/session

Checkout session

subject_refuser_123
Idempotency-Keyrequired
checkout_urlready
modetest
Integration flow

Stripe payment -> Licenzy entitlement -> app access.

Stripe sends billing events to Licenzy through the Stripe inbound webhook. Your first runtime call is POST /v1/checkout/session with an Idempotency-Key. After Stripe webhook processing, your first verification call is POST /v1/access/check.

Step 1

What matters here

Verify email

Unlock setup changes before you create runtime resources.

  • Finish the account step first so the rest of setup is unblocked.
  • This is the cleanest way to keep the first test pass moving.
Create account

Operational notes

Use these rules for the first test pass.

  • Create a test API key before making any runtime request.
  • POST /v1/checkout/session is the first runtime call and it requires an Idempotency-Key.
  • POST /v1/access/check is the first verification call after Stripe inbound webhook processing.
  • Outbound Licenzy webhooks are optional.
  • POST /v1/usage/consume also requires an Idempotency-Key and applies only to usage_pack products.

Use a backend that can keep Licenzy API keys private, and start by choosing or renaming your first project. The project you configure owns the test API key, products, Stripe setup, outbound webhooks, and runtime activity for that flow.

First-run onboarding order

Follow the required setup sequence before your first real verification pass.

  1. Verify email.
  2. Create a project.
  3. Create a test API key.
  4. Connect Stripe.
  5. Configure Stripe webhook.
  6. Create a product.
  7. Run a test checkout.
  8. Verify access.
  9. Consume usage if you sell a usage pack.
  10. Optionally configure outbound webhooks.

Stripe webhook destinations are configured in Stripe. Licenzy stores the Stripe credentials and signing secret, then receives Stripe events directly.

Checkout docsAccess checksUsage packs

Start in test mode, then go deeper when needed

Quickstart is the shortest path to a working first flow: create a test API key, run checkout with Idempotency-Key, verify access after the Stripe inbound webhook, and use usage/consume only for usage_pack products.

Start freeRead docs