In version 2025-07 the “refund” input is deprecated. what happens if you upgrade to 2025-07 but still use “refund” input instead of “refundMethod”
1 Like
Hi @SPS_Commerce,
Currently the refund input is still active on the orderCancel mutation, so at this time if you do still use it with API version 2025-07 it will still successfully run the mutation and refund the cancelled order if set to true.
I tested this on my own test store, and I can confirm it does work with refund: true without errors, however it does indicate the field is deprecated with the HTTP Response Header returned:
x-shopify-api-deprecated-reason: Mutation.orderCancel.refund
However as this field is officially deprecated, with notice in the Changelog post linked below, this is open to be removed from the API on version 2025-07 at any time moving forward, and we do recommend migrating your app to the refundMethod input as soon as possible to prevent any errors when this deprecated input is actually removed from the API without warning.
Additionally the refund input will still be available on previous API versions 2025-01 and 2025-04 as long as those versions are supported (up to 12 months after release).
For more information on our API version release cycle, please see the following Shopify.dev documentation: