DOCS/Platform Docs/Billing/Start Subscription

Start Subscription

Requires owner or admin. member and viewer users 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.

Historical inactive billing panel with the Subscribe button visible.
Historical single-subscription panel; the current UI uses category browsing and an in-app checkout review.

Steps

  1. Open Billing_Control inside the authenticated /dashboard shell and confirm the organization context.
  2. 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.
  3. Choose a product, billing interval/price, and quantity where offered.
  4. Select the product card's Subscribe action. A category with an active/trialing subscription instead shows a disabled Subscribed action.
  5. Review the in-app Checkout panel, select any available same-category addons and quantities, and select Proceed to Payment.
  6. Complete the purchase on Stripe Checkout; payment-card entry remains on Stripe, not in the dashboard.
  7. 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=success or /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.