---
title: "Checkout Redirect"
method: GET
path: "/users/checkout_redirect"
---

# Checkout Redirect

`GET /users/checkout_redirect`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/users/checkout_redirect`
- Auth: none declared

One navigation to Stripe Checkout.

Prefer a session cookie from ``POST /users/refresh_session_cookie`` (with
``fetch(..., credentials: 'include')`` from the app origin) so this URL needs no
query token. Otherwise use ``?access_token=<firebase_id_token>`` for a plain link
(Authorization header is not sent on full-page navigations).

## Query parameters

- `pricing_tier` string, required: Plan tier_id from GET /billing/catalog (e.g. starter_90tt_9d, monthly, yearly).
- `coupon_code` string, nullable
- `calling_page` string
- `return_origin` string, nullable: Trusted frontend origin for Stripe success/cancel (e.g. https://localhost:3000). If omitted, the first trusted match is used: Origin header, then Referer origin; otherwise https://app.tellers.ai.
- `item_list` string[], nullable: Repeatable item list entries as 'price_id:quantity', e.g. item_list=price_x:200&item_list=price_y:1.
- `currency` string, nullable: Lowercase ISO currency to charge in; must be listed in the plan's `currencies` from GET /billing/catalog. A customer with an active subscription must keep its currency (defaults to it when omitted).
- `access_token` string, nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)