await_settlement
Waits for a payment request to be settled by polling every 5 seconds until the status changes or timeout is reached. Call this after sending the QR to the payer.
Instructions
Wait for a payment request to be settled (polls on behalf of the agent).
Polls every 5 seconds until status != pending or the timeout is reached (maximum 600 s). Call this after sending the QR to the payer. If the timeout expires while still pending, ask the user whether to keep waiting or cancel.
Args:
payment_request_id: The id returned by create_payment_request.
timeout_seconds: How long to wait in seconds (10–600, default 180).
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": {
"payment_request_id": "<payment_request_id>"
},
"name": "await_settlement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payment_request_id | Yes | ||
| timeout_seconds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |