---
title: "Post Checkout Session"
method: POST
path: "/api/billing/credits/checkout-session"
tags: ["billing"]
---

# Post Checkout Session

`POST /api/billing/credits/checkout-session`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/billing/credits/checkout-session`
- Auth: none declared

Open a Stripe Checkout Session for a real-money top-up (TOS-3810 D2).

Only for identities the admin has switched to ``funding_mode='test'`` or
``funding_mode='real_money'``. Bypass identities stay on the free
``POST /api/billing/credits/topup`` rail.
No credit is granted here; the wallet is credited by the webhook once
Stripe confirms the payment actually happened.

## Headers

- `x-impersonate-identity-id` string, nullable

## Request body

- CheckoutSessionRequest
  - `amount_usd` integer, required: Whole dollars, 10 to 500

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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