---
title: "Mint a Stripe Checkout URL to add balance (API-key auth; works from a test-mode key)"
method: POST
path: "/requestor/billing/topup-link"
tags: ["Billing"]
---

# Mint a Stripe Checkout URL to add balance (API-key auth; works from a test-mode key)

`POST /requestor/billing/topup-link`

## Request

- Base URL: `https://www.getabrain.ai/api/v1`
- URL: `https://www.getabrain.ai/api/v1/requestor/billing/topup-link`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

The agent-facing twin of /requestor/billing/checkout: returns a hosted Stripe Checkout URL for a HUMAN to open and pay by card. Accepted with test-mode keys too, so a sandboxed agent can fund its account to go live. Min $5.

## Request body

- object
  - `amount_cents` integer, required

## Response `200`

Checkout URL

- object
  - `checkout_url` string, uri

## Other responses

- `400`: Request failed validation
- `401`: Missing or invalid authentication
- `404`: Resource not found
- `503`: A required upstream service (e.g. payments) is temporarily unavailable

---

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