---
title: Refund 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/refund-to-store-credit'
  md: 'https://shopify.dev/changelog/posts/refund-to-store-credit.md'
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-04-23T15:50:40-04:00'
  postedAt: '2025-05-20T14:15:00-04:00'
  updatedAt: '2025-05-20T14:03:35-04:00'
  effectiveAt: '2025-04-24T12:00:00-04:00'
---

May 20, 2025

# Refund to Store Credit

DateMay 20, 2025

FlagsNew

SurfacesAPI

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

You can now issue a specified amount as new store credit when processing refunds. This can be done in addition to refunding amounts to the original payment methods. If a customer requests a refund to their original payment method after already receiving a refund to new store credit, you can accomplish this by specifying a parameter that allows over-refunding. Note that this parameter is disabled by default.

To use this feature, ensure the following prerequisites are met:

* [New customer accounts](https://help.shopify.com/en/manual/customers/customer-accounts/new-customer-accounts) must be enabled in the store.
* The order must be associated with a customer.

This feature integrates with the standard refund API process as follows:

* Use the [`Order.suggestedRefund` field](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Order#field-suggestedRefund) to create a suggested set of transactions and refund methods. You can now use the `refundMethodAllocation` parameter to define this set.
* Pass the transactions and other refund components (e.g. `refundLineItems`), as before, to the [`refundCreate` mutation](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/refundCreate). Additionally, you can now use the `refundMethods` parameter to pass in any refunds to new store credit.

You can also refund to store credit using new return processing APIs:

* Use the [`Return.suggestedFinancialOutcome` field](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Return#field-Return.fields.suggestedFinancialOutcome) to query for suggested refund amounts. Specify `STORE_CREDIT` as the [`refundMethodAllocation` parameter](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Return#field-Return.fields.suggestedFinancialOutcome.arguments.refundMethodAllocation) to retrieve a suggested store credit refund amount.
* Use the [`financialTransfer.issueRefund.refundMethods` parameter](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/ReturnProcessInput#fields-financialTransfer.fields.issueRefund.refundMethods) of the [`returnProcess` mutation](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/returnProcess) to specify the `storeCreditRefund` amount and complete the refund.