Skip to main content
POST
/
v1
/
billing
/
topup
Buy Credits
curl --request POST \
  --url https://api.example.com/v1/billing/topup
Creates a checkout session for a one-time credit pack purchase. Credits are added to the account immediately after payment.

​
Request Body

ParameterTypeRequiredDescription
pack_idstringYesPack ID: small, medium, large, or xl

​
Response

{
  "checkout_url": "https://checkout.example.com/c/pay/...",
  "session_id": "cs_live_...",
  "pack": { "id": "medium", "credits": 50, "price": "$23" },
  "expires_at": "2026-05-02T11:30:00Z",
  "hint": "Open the checkout URL to complete payment. Credits are added immediately after payment."
}
Use GET /v1/billing/packs to see all available packs and their pricing.