billing

Start a Stripe Checkout Session

Create a hosted Checkout Session for a seat subscription or a credit pack; returns its URL.

post/v1/billing/checkout

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/billing/checkout
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

kind'subscription' | 'topup' | 'credits' | 'setup' required

What a checkout session buys.

  • SUBSCRIPTION: the flat $45/mo Founding plan (no seats, no plan needed).
  • TOPUP: a one-time credit purchase from the 7-tier ladder (topup_tier).
  • CREDITS: the legacy one-time credit pack (per-unit quantity); retained so the pre-v2 pack checkout keeps working until the ladder fully replaces it.
  • SETUP: no charge; a mode=setup session that saves a card for auto-refill (started via the dedicated setup-session endpoint, not /billing/checkout).
plan'team' | 'business'

A purchasable seat plan, mapped to a per-seat recurring Stripe price (legacy).

Superseded by the flat Founding subscription (CheckoutKind.SUBSCRIPTION needs no plan); kept so the legacy seat checkout path still validates for historical callers.

seatsinteger
quantityinteger
topup_tier'10k' | '25k' | '50k' | '100k' | '300k' | '750k' | '2m'

A rung of the 7-tier one-time top-up ladder (plan §1.3).

The value is the settings suffix (stripe_price_topup_<value>) so the API name, the catalog key, and the settings field stay same-same.

Response

Successful Response

checkout_urlstring required
session_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.