---
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/refund-to-store-credit
  md: https://shopify.dev/changelog/refund-to-store-credit.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

May 20, 2025

Tags:

* Admin GraphQL API

# Refund to Store Credit

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.