---
title: "Buy credits"
method: POST
path: "/v2/credits"
tags: ["billing"]
---

# Buy credits

`POST /v2/credits`

Creates a Stripe Checkout link the account owner opens in a browser to buy credits (quantity between 1000 and 10000). Creating a link never charges anything; payment happens only when a human completes checkout in the browser, and the purchased credits always land on this account.

## Request body

- object
  - `quantity` integer, required
  - `referral` string, nullable

## Response `201`

A Stripe Checkout link to buy credits.

- object — A Stripe Checkout link to buy credits.
  - `checkoutUrl` string, required — Stripe Checkout URL. The account owner opens this in a browser to complete payment. No charge occurs until checkout is completed.

## Other responses

- `400` — Default Response
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate limit exceeded
- `500` — Default Response

---

[API](https://skmtc.net/blotato/apis/blotato-api.md) · [All operations](https://skmtc.net/blotato/apis/blotato-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blotato/blotato-api/revisions/c93447ba6b9d/schema)