Add credit
create_topupStart a prepaid top-up by generating a checkout URL for the user to open and pay. Confirm the exact USD amount beforehand; credit is added after payment settles.
Instructions
Start a top-up. Returns a checkout_url that a HUMAN must open to pay; credit lands once payment settles, not when this returns. Never open the URL or attempt payment yourself. Confirm the amount with the user first.
Requires scope billing:write.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"amount_usd": "<amount_usd>"
},
"name": "create_topup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount_usd | Yes | Amount to add, in US dollars. | |
| return_url | No | Where to send the customer after checkout. | |
| idempotency_key | No | Idempotency-Key for safe retries. Generated automatically when omitted. Reuse the SAME value when retrying the SAME logical request; never reuse it for a different one. |