---
title: "Purchase additional tokens"
method: POST
path: "/integrator/billing/token-topup"
tags: ["billing"]
---

# Purchase additional tokens

`POST /integrator/billing/token-topup`

Create a one-time payment checkout to add bonus tokens to your account.

## Request body

- TokenTopupRequest — Request to purchase additional tokens.
  - `token_amount` integer, required — Number of tokens to purchase
  - `success_url` string, required
  - `cancel_url` string, required

## Response `200`

Successful Response

- TokenTopupResponse — Response with token top-up checkout URL.
  - `checkout_url` string, required
  - `tokens` integer, required
  - `price_cents` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/scipot/apis/scipot-core-api.md) · [All operations](https://skmtc.dev/scipot/apis/scipot-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scipot/scipot-core-api/revisions/e8712e9ffeae/schema)