pay_verify_otp
Verify a payment OTP by providing the code, request ID from the purchase initiation, and phone number.
Instructions
Verify a payment OTP after the customer reads the code from their phone and sends it in chat. CRITICAL: This is ONLY for validating payment-related transactions. The request_id MUST be the one returned in the response of a payment/purchase initiation tool (e.g., airtime_purchase, data_purchase, or momo_collect), NOT from otp_send_sms. Providing a standard SMS OTP request ID will result in a 404 Error. :param code: OTP code entered by the customer from their phone. :param request_id: Request ID returned from the payment/purchase initiation response. :param phone_number: The phone number used for the payment transaction.
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": {
"code": "<code>",
"request_id": "<request_id>",
"phone_number": "<phone_number>"
},
"name": "pay_verify_otp"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | OTP code entered by the customer from their phone. | |
| request_id | Yes | Request ID returned from the payment/purchase initiation response. | |
| phone_number | Yes | The phone number used for the payment transaction. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||