---
title: "Start a top-up and get a hosted checkout URL."
method: POST
path: "/v1/credits/checkout"
tags: ["credits"]
---

# Start a top-up and get a hosted checkout URL.

`POST /v1/credits/checkout`

## Request

- Base URL: `https://api.japanfold.aiand.com`
- URL: `https://api.japanfold.aiand.com/v1/credits/checkout`
- Auth: one of:
  - none
  - HTTP bearer

Send `{"amount": 25.00}`, in US dollars. Returns `url`, which the caller opens to pay. Nothing is added here: the balance moves only when the processor's signed webhook arrives, so poll `GET /v1/credits` afterwards.

## Request body

- object
  - `amount` number, required

## Response `201`

Checkout session

## Other responses

- `400`: Invalid request
- `401`: Unauthorized

---

[API](https://skmtc.dev/aiand/apis/japanfold-api.md) · [All operations](https://skmtc.dev/aiand/apis/japanfold-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiand/apis/japanfold-api/revisions/9f4be813b447?raw)