get_payment_status
FINAL STEP of the in-chat payment flow. Returns the current PaymentSession for an order. Poll this (every ~5 seconds) after initiate_payment/submit_payment_otp until payment_status becomes "paid" or "processing" (success — the order is confirmed) or "failed" (tell the user; they can retry by initiating a new payment). Do NOT treat the purchase as complete until this returns "paid" or "processing". No delegation needed (read-only).
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": {
"order_id": "<order_id>"
},
"name": "get_payment_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site_id | No | Registered site ID (optional if DEFAULT_SITE_ID is set) | |
| order_id | Yes | Order ID to check payment status for |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | ||
| reference | No | ||
| instruction | No | ||
| payment_status | No |