billing

Create Checkout Session

Create a Stripe checkout session or update existing subscription.

  • No subscription / FREE tier → Checkout session for new subscription
  • Paid tier → Update existing subscription (no new checkout)
post/api/v1/billing/checkout

Request

  • The document declares no server URL.
  • Auth: none declared

Headers

authorizationstring nullable
x-api-keystring nullable

Request body

tier'free' | 'starter' | 'professional' | 'business' | 'enterprise' required

Subscription pricing tiers (consumer/prosumer model).

Maps to Stripe price IDs.

success_urlstring uri required
cancel_urlstring uri required
billing_emailstring nullable
trial_period_daysinteger nullable

Number of trial days (1-90). If not provided, no trial period.

Response

Successful Response

checkout_urlstring required

Stripe checkout session URL

Changes

No recorded changes to this operation across all 5 revisions of this API.