momo_check_payment_status
Check the status of a previously requested mobile money payment by merchant reference or transaction ID. Returns a final or pending outcome without moving funds.
Instructions
Check what became of a payment you requested earlier. Read-only: it never moves money and never changes anything. Accepts either the merchant reference you supplied when initiating, or the transaction_id returned then. Returns a stable status plus the aggregator's own status and code, and says whether the outcome is final. A payment that was requested but never completed by the customer ends up FAILED, which is final — it does not stay pending forever. The customer's phone number is returned masked, never in full.
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": {
"reference": "<reference>"
},
"name": "momo_check_payment_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reference | Yes | Either the merchant reference you supplied to momo_initiate_payment, or the transaction_id it returned. Both address the same payment. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |