DOCS/Platform Docs/Billing/Start Subscription
Start Subscription
Requires
owneroradmin.memberandviewerusers can review billing state, but they cannot start checkout.
Use this guide to select a catalog product and start a category-scoped purchase through Stripe Checkout.

Steps
- Open
Billing_Controlinside the authenticated/dashboardshell and confirm the organization context. - Select a product category in the catalog browser. Categories and available prices come from the synced Stripe catalog; if none appear, ask your operator to check catalog configuration.
- Choose a product, billing interval/price, and quantity where offered.
- Select the product card's
Subscribeaction. A category with an active/trialing subscription instead shows a disabledSubscribedaction. - Review the in-app
Checkoutpanel, select any available same-category addons and quantities, and selectProceed to Payment. - Complete the purchase on Stripe Checkout; payment-card entry remains on Stripe, not in the dashboard.
- After returning, reopen the dashboard and its Billing tab, then verify the subscription/items after webhook synchronization. Do not treat the redirect alone as payment confirmation.
What To Expect
- The current UI has a product/price picker and optional addon selection before the Stripe redirect.
- Subscriptions are category-scoped: another category can be purchased even when the org already has subscriptions. Duplicate active/trialing category checkout is rejected with a conflict.
- Catalog-backed one-time unit prices use Stripe payment mode rather than recurring subscription mode.
- Product Subscribe controls require the active organization billing-management permission. Backend checkout independently requires owner/admin membership.
- The screenshots above depict the earlier single-subscription panel, not the current category browser.
If You Get Stuck
- If the catalog is empty, ask your operator to verify Stripe-to-D1 catalog sync.
- If checkout is denied, confirm owner/admin membership in the active organization. UI permissions derive from the active membership; server membership checks remain authoritative.
- If checkout reports an existing category subscription, manage that subscription instead of starting another.
- Stripe returns to
/billing?checkout=successor/billing?checkout=canceled; the dashboard recognizes this route and opens the billing tab after sign-in.
Next Step
For an existing subscription, continue to Manage Subscription for ongoing billing changes.