Start checkout
POST/v1/account/billing/checkout
Starts a top-up of a whole number of dollars from 10 to 2,000 and returns the Stripe Checkout page to send the user to. The credit appears once Stripe reports the payment. Needs the account scope as an owner or admin.
- scope
- account
- auth
- Bearer key
- operationId
- StartCheckout
Request body
application/json · CheckoutRequest · no other fields
| Field | Type | Required | Limits |
|---|---|---|---|
| amount_usd | integer | yes | 10 to 2000 |
Response
201 · Checkout. The Checkout page and when it expires.
| Field | Type |
|---|---|
| checkout_url | string |
| expires_at | string · date-time |
Problems
RFC 9457 application/problem+json. An abstention is not one of these: it is a 200.
| HTTP | Code | When |
|---|---|---|
| 400 | INVALID_REQUEST | Malformed JSON, unknown fields, bad filter, limit exceeded |
| 401 | UNAUTHENTICATED | Missing, malformed, or revoked key |
| 403 | FORBIDDEN_SCOPE | The key lacks the required scope |
| 404 | NOT_FOUND | Unknown response, job, document, or reserved route |
| 429 | RATE_LIMITED | Rate limit or per-tenant model cap |
| 500 | INTERNAL, POLICY_ASSERT_FAILED, RESPONSE_UNREPLAYABLE | Server fault. The last two also alert |
| 503 | STORE_UNAVAILABLE, LLM_UNAVAILABLE, LOG_UNAVAILABLE | A dependency is down or a budget tripped |