Get top-up link
topup_linkReturns the page where the prepaid balance can be topped up, plus the minimum amount.
Use when: the balance is empty or too low for the documents the user wants to process. Do not use when: the balance is sufficient — check it with get_balance first.
Side effects and cost: none. The call only builds a link; the payment happens in the browser and is handled by the payment provider, never by this server.
Parameter interactions and edge cases: amount_eur is echoed back only; a value outside 8..5000 is rejected by parameter validation before the call runs. The returned url is a pricing page, not a payment link tied to a sum — the user chooses the amount there. Calling it repeatedly returns the same page and creates no orders.
Returns: {ok, url, minimum_eur}.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "topup_link"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount_eur | No | Planned top-up in euro, minimum 8, maximum 5000, default 8. Informational only: it does not create an order or reserve money, it is echoed back in requested_eur so the assistant can show the user what was intended. |