---
title: "Get a Stripe checkout link: a credit top-up, or a plan subscription for the user"
method: POST
path: "/v1/credits/checkout"
---

# Get a Stripe checkout link: a credit top-up, or a plan subscription for the user

`POST /v1/credits/checkout`

## Request

- Base URL: `https://varosity.ai/api`
- URL: `https://varosity.ai/api/v1/credits/checkout`
- Auth: HTTP bearer

For agents: pay the link with a card you hold, or give it to the user. Credits are added within a minute of payment. Send amountUsd (whole dollars, 5–500) or packId starter ($10) / pro ($25); credits equal dollars paid. Creating a link is free; 10 per hour per account.

## Request body

- object
  - `amountUsd` integer
  - `packId` 'starter' | 'pro'
  - `plan` 'basic' | 'pro' | 'creator': A monthly plan instead of a top-up: basic $12 → 1,200 credits/mo, pro $29 → 3,500, creator $125 → 17,000. Returns a subscription checkout link for the user.
  - `interval` 'month' | 'year': Plan billing; yearly is about 20% off and still grants credits monthly.

## Response `200`

Checkout link

- object
  - `ok` boolean
  - `checkout_url` string
  - `expires_at` string
  - `pack` object

## Other responses

- `401`: Unauthorized — the user can create a key at https://varosity.ai/agent/key
- `429`: Too many checkout links this hour

---

[API](https://skmtc.dev/varosity/apis/varosity-ai-api.md) · [All operations](https://skmtc.dev/varosity/apis/varosity-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/varosity/apis/varosity-ai-api/revisions/81d0169a4897?raw)