Start a purchase

POST /v1/billing/checkout

Create a Stripe Checkout session for a subscription plan ({"plan": "growth"}) or a one-time credit pack ({"pack": "pack_5k"}). Returns the hosted checkout URL; credits/plan apply automatically via webhook after payment.

Request body

Field	Type	Description
`plan`	string	Plan id from the /v1/account catalog
`pack`	string	Pack id from the /v1/account catalog

Example request


curl -X POST "https://oxtg7m5erd.execute-api.us-east-1.amazonaws.com/v1/billing/checkout" \
  -H "Authorization: Bearer <session-jwt>" \
  -H "Content-Type: application/json" \
  -d '{
  "plan": "growth"
}'

Example response


{
  "success": true,
  "data": {
    "url": "https://checkout.stripe.com/c/pay/cs_…",
    "session_id": "cs_…"
  },
  "credits_used": 0,
  "request_id": "req_…"
}

Errors

Status	Meaning
`400`	invalid_request / unsupported_format

All errors share the error envelope.

Try it

Open this endpoint in the interactive playground — requests run with your API key.