---
title: >-
  Order cancellation now supports refunds to store credit - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/ordercancel-mutation-now-supports-refunds-to-store-credit
  md: >-
    https://shopify.dev/changelog/posts/ordercancel-mutation-now-supports-refunds-to-store-credit.md
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  indicatesActionRequired: false
  createdAt: '2025-06-11T06:56:40-04:00'
  postedAt: '2025-07-01T12:00:00-04:00'
  updatedAt: '2025-06-16T11:53:14-04:00'
  effectiveAt: '2025-06-17T12:00:00-04:00'
---

July 1, 2025

# Order cancellation now supports refunds to store credit

DateJuly 1, 2025

Version[2025-07](https://shopify.dev/changelog?api_version=2025-07)

Flags[Deprecation announcement](https://shopify.dev/changelog?filter=deprecation-announcement)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

As of GraphQL Admin API version `2025-07`, the [`orderCancel` mutation](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/orderCancel) 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](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/orderCancel#arguments-refundMethod), which offers greater flexibility in handling customer refunds during order cancellations, and deprecates the existing [`refund` input](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/orderCancel#arguments-refund).

#### 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](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/orderCancel#arguments-refund) with the new [`refundMethod.originalPaymentMethodsRefund` input](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/orderCancel#arguments-refundMethod.fields.originalPaymentMethodsRefund) going forward.

For detailed information and examples on how to implement the new input, visit our [orderCancel documentation](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/orderCancel) on Shopify.dev.