Skip to main content

Order cancellation now supports refunds to store credit

As of GraphQL Admin API version 2025-07, the orderCancel mutation allows you to issue refunds as store credit, in addition to the original payment methods, when orders are cancelled.

This update introduces a new refundMethod input, which offers greater flexibility in handling customer refunds during order cancellations, and deprecates the existing refund input.

Action required:

If you want to continue to issue refunds to the original payments methods on order cancellation, replace your usages of the refund input with the new refundMethod.originalPaymentMethodsRefund input going forward.

For detailed information and examples on how to implement the new input, visit our orderCancel documentation on Shopify.dev.

Was this section helpful?