Skip to main content
POST
Create a Stripe subscription directly
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /billing/stripe/subscription Creates (or replaces, via createOrReplaceSubscription) a Stripe subscription for the given planLevel/billingCycle, ensures a Stripe customer exists, and syncs a local TenantSubscription row inside a DB transaction. Authorization:
  • Required role: owner only

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
planLevel
enum<string>
required
Available options:
FREE,
STARTER,
PLUS,
PREMIUM
billingCycle
enum<string>
required
Available options:
monthly,
quarterly,
annually

Response

Subscription created

status
string
Example:

"success"

message
string
data
object