Billing
- Written for
- ＋ Written for
- Deprecated
- ＋ Deprecated
- Applies to
- ＋ Applies to
Billing
Backend API — secret key (Authorization: Bearer sk_…).
6 routes. Each row is one endpoint with its explanation, required scope, and whether it honours the Idempotency-Key header.
Method & path | Scope | Idem | Explanation |
|---|---|---|---|
|
| List the plans the tenant defines for their app's users (end-user billing). Admin view — includes the Stripe price id. | |
|
| ✓ | Create an end-user billing plan (name, slug, Stripe price, features, user/org audience). The slug becomes the |
|
| Read one end-user billing plan, including its Stripe price id and granted features. | |
|
| Update an end-user billing plan's name, slug, price, interval, features, audience or active flag. | |
|
| Delete an end-user billing plan. Existing subscriptions retain their plan_id (the FK restricts deletion of a plan still referenced). | |
|
| List end-user subscriptions, optionally filtered by subject_type (user/org) and subject_id. Read-only — status is moved solely by the Stripe webhook. |