---
title: "Open a Stripe Checkout session for the setup fee plus the first credit top-up"
method: POST
path: "/v1/setup-orders/{id}/checkout"
---

# Open a Stripe Checkout session for the setup fee plus the first credit top-up

`POST /v1/setup-orders/{id}/checkout`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/setup-orders/{id}/checkout`
- Auth: HTTP bearer

Creates a Stripe Checkout session for the quoted setup fee plus a first credit top-up (`creditCzk`, one of the account's supported top-up amounts). Only from `quoted` status, and only the order's owner. The success and cancel redirect both point back to the order's page in the **conversation's** language (`order.locale`), not necessarily this request's.

## Path parameters

- `id` string, required

## Request body

- object
  - `creditCzk` integer, required: First credit top-up amount in whole CZK to bundle with the setup fee, one of 200, 500, 1000, 2000 (same set as POST /v1/credit/topup).

## Response `200`

Checkout session

- object
  - `url` string, required
  - `sessionId` string, required

## Other responses

- `400`: Error codes: validation (request), invalid_amount (request), billing_address_required (account).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: setup_order_not_found (account).
- `409`: Error codes: checkout_open (account), invalid_transition (request), quote_pending_confirmation (account), turn_in_progress (busy).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).
- `503`: Error codes: setup_orders_disabled (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)