# Subscription flow

Use `POST /api/v1/agent/checkout-sessions/` with a public `tariff_id` to start a subscription.

The endpoint requires a verified account and the `billing:checkout` OAuth scope. It returns a Stripe Checkout URL. The user confirms payment in Stripe; the agent must not collect card details.

After Stripe confirms the Checkout Session, the existing Site-Shot Stripe webhook activates the subscription. Use `GET /api/v1/agent/subscription/` to read the current status.

Billing details, payment methods and invoices are managed by the account owner in the Stripe customer portal, not through this API. A signed-in owner reaches it from **Billing & invoices** in the account menu, from the billing block on the dashboard beside their subscription, or from their profile page. An agent must not collect or change card details.