Review a customer's order refunds
Refund information is authoritative at the order level. Start with a customer ID, choose an order, then inspect that order's current refund position.
Find the five most recent orders for customer <CUSTOMER_ID> and let me
choose one. For the selected order, show existing refunds and every line's
original paid, already reserved or refunded, and remaining refundable amount.
Do not create or cancel anything.
The agent first calls list_orders with the customer ID. After you choose an order, it calls get_refund_options to read a fresh refund snapshot.
Sample response
Refund position for order WEB-1042
One refund is processing. GHS 75.00 remains refundable across two lines.
- Customer
- cus_example_01
- Order
- WEB-1042 ord_example_1042
- Payment status
- Paid
- Refundable total
- GHS 75.00
Current line-level snapshot
| Line | Original paid | Reserved or refunded | Remaining |
|---|---|---|---|
| Utility tote × 1 | GHS 50.00 | GHS 25.00 | GHS 25.00 |
| Event pass × 1 | GHS 100.00 | GHS 50.00 | GHS 50.00 |
Existing refund rf_example_01 is processing for GHS 75.00. Processing does
not mean the customer has received the money.
Illustrative values. The exact presentation depends on the MCP client.
The result is a snapshot for the selected order. It is not a complete customer refund history, and no refund should be created from a stale snapshot.