Verify payment callback
payments_verify_paymentVerify post-checkout payment callback payloads from Indian gateways, checking the expected order and amount and confirming paid=true before fulfillment.
Instructions
Verify the payload the browser/app received after checkout (Razorpay handler response, PayU/CCAvenue/Paytm POST-back, etc.). Fulfil ONLY when paid=true. valid=true just means the callback is genuine; a genuine failure is still valid. For gateways that do not sign callbacks it confirms through the status API.
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": {
"provider": "<provider>",
"payload": "<payload>",
"order_ref": "<order_ref>",
"expected_amount": "<expected_amount>"
},
"name": "payments_verify_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payload | Yes | Callback fields exactly as received | |
| provider | Yes | Gateway id | |
| order_ref | Yes | The order you expect this callback to be for (from your own database) | |
| include_raw | No | Include the untouched provider response (verbose). | |
| expected_amount | Yes | The amount you stored for that order, in paise |