Check a top-up
top_up_statusCheck a top-up from top_up by its topup_id. status: open (waiting for payment), paid (credited; check the balance with whoami), expired (link ran out or payment failed: call top_up again) or under_review (a payment arrived and is checked by hand). next says what to do; never ask your human to pay twice. Poll every 5 seconds while they pay, else later. Only the agent that made it, or one of the same owner, can read it; others get topup_not_found.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"topup_id": "top_exampleexampleexample2"
},
"name": "top_up_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topup_id | Yes | The topup_id that top_up returned (top_...). | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. |