Shopify Refund Order Line Items and Shipping Fee

What it does

• Fetches the order by its internal Shopify order ID.
• Records the refund attempt in a Shopify metaobject for audit and rate-limiting.
• Runs safety checks (refund frequency limits and duplicate detection via metafields).
• Calculates the shipping portion to refund proportionally based on item quantity or weight.
• Calls the Shopify Calculate and Create Refund endpoints with full line-item detail.
• Marks the order with a digitalgenius.is_refunded metafield after success.

Notes

• Uses the internal Shopify order ID, not the visible order number.
• Three refund modes: full (all items + all shipping), percentage of items quantity (selected items + shipping by quantity ratio), or percentage of items weight (selected items + shipping by weight ratio).
• Safety limits block the action if too many refunds are detected (20/hour, 60/12h, 100/24h).
• Soft Launch mode calculates the refund without executing it, useful for testing flows.
• Items are not restocked by this action.
• Requires the $app:order_refund metaobject definition to exist in the Shopify store.

Inputs

Outputs

API reference

• Shopify Refund: Calculate (POST /orders/{id}/refunds/calculate.json)
• Shopify Refund: Create (POST /orders/{id}/refunds.json)
• Shopify Metafields API
• Shopify Admin GraphQL: Metaobjects