Create order refund

documented

Create a refund for an order.

POST /admin/api/2026-01/orders/{order_id}/refunds.jsonOrdersno implementation yet0 runs

No implementation yet. Run it to have the agent write one, or open a pull request with your own.

Seed example (keychains curl)

npx -y keychains@latest curl "https://{{$shop_domain}}.myshopify.com/admin/api/2026-01/orders/{{$order_id}}/refunds.json" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Shopify-Access-Token: {{OAUTH2_ACCESS_TOKEN}}" \
  -d '{"refund": {"currency": "{{$currency}}", "note": "{{$note}}", "notify": true, "shipping": {"full_refund": {{$full_refund}}}, "refund_line_items": [ {"line_item_id": {{$line_item_id}}, "quantity": {{$quantity}}, "restock_type": "return", "location_id": {{$location_id}} } ], "transactions": [ {"parent_id": {{$parent_id}}, "amount": "{{$amount}}", "kind": "refund", "gateway": "{{$gateway}}"} ] } }'"