Skip to content

Create Checkout

POST
/billing/checkout

Create a Stripe Checkout Session for subscription purchase.

Requires billing admin (owner/admin role). Resolves the selected tier to a Stripe Price ID, creates a Stripe Customer if needed, and returns the Checkout Session URL for redirect.

CheckoutRequest

Request body for POST /billing/checkout.

object
tier_id
required
Tier Id
string

Successful Response

CheckoutResponse

Response body for POST /billing/checkout.

object
checkout_url
required
Checkout Url
string

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object