Refund all remaining order lines
Use this workflow when the customer should receive every amount that remains refundable on a paid order. The agent still shows each line and exact amount before creating anything.
Prepare a refund for every amount that remains refundable on order
<ORDER_ID>. Show each line's original paid amount, any amount already
reserved or refunded, and the exact remaining amount. Ask for the overall
reason, then give me one final itemized confirmation. Do not create the refund
until I approve it, and do not call it complete until its status is succeeded.
The agent first calls get_refund_options. It may offer the full remaining amount for each line, but you must approve the itemized values and provide the overall reason before create_refund is called.
Sample response
Full remaining refund ready
Every currently refundable line is included. No refund has been created yet.
- Order
- ord_example_2088
- Currency
- GHS
- Refund total
- GHS 145.00
- Overall reason
- Requested by customer
Amounts awaiting confirmation
| Order line | Original paid | Already reserved | This refund |
|---|---|---|---|
| Canvas bag × 1 | GHS 95.00 | GHS 20.00 | GHS 75.00 |
| Delivery × 1 | GHS 70.00 | GHS 0.00 | GHS 70.00 |
Approving this summary starts an asynchronous refund for GHS 145.00. It does not mean the customer has received the money.
Illustrative values. The exact presentation depends on the MCP client.
After creation, the agent uses get_refund to reconcile the result. pending and processing remain in progress; only succeeded is complete.