refund-create
Create full or partial refunds for Shopify orders, with optional shipping refunds and line-item restocking.
Instructions
Create a full or partial refund for an order with optional restocking and shipping refund.
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": {
"orderId": "<orderId>"
},
"name": "refund-create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Note attached to the refund | |
| notify | No | Whether to send refund notification to customer. IMPORTANT: Always confirm with the user before enabling — sends a real email/SMS to the customer. Defaults to no notification if omitted. | |
| orderId | Yes | The order GID, e.g. gid://shopify/Order/123 | |
| currency | No | Currency code if different from shop currency (presentment currency) | |
| shipping | No | Shipping cost refund | |
| refundLineItems | No | Line items to refund with quantities and restock type. If omitted, you must provide 'shipping' for a shipping-only refund. Omitting both refundLineItems and shipping will result in a zero-amount refund (note-only). |