ratiba_create_and_wait
Create an M-Pesa Ratiba standing order and wait for customer approval, returning the settled outcome and reminder schedule ID.
Instructions
Create an M-Pesa Ratiba standing order and wait for the customer to approve it. Returns the settled outcome including the reminder schedule id.
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": {
"standingOrderName": "<standingOrderName>",
"phoneNumber": "<phoneNumber>",
"amount": "<amount>",
"startDate": "<startDate>",
"endDate": "<endDate>",
"frequency": "<frequency>"
},
"name": "ratiba_create_and_wait"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount in KES. Whole numbers only. | |
| endDate | Yes | Final execution date, yyyymmdd or yyyy-mm-dd. | |
| frequency | Yes | How often the standing order executes. | |
| shortCode | No | ||
| startDate | Yes | First execution date, yyyymmdd or yyyy-mm-dd. | |
| callbackUrl | No | ||
| phoneNumber | Yes | Customer phone number. Accepts 07..., +2547..., or 2547... and is normalised. | |
| receiverType | No | Whether the shortcode is a PayBill or a Buy Goods till. | paybill |
| timeoutSeconds | No | ||
| transactionDesc | No | ||
| accountReference | No | ||
| standingOrderName | Yes | Name of the standing order. Must be unique for this customer; a repeat name is rejected. |