← All Shopify Updates
Shopify Update · Published June 1, 2026 · Source: Returns Processing APIs replaces Return Refund APIs

Shopify Replaces Return Refund APIs with New Returns Processing API in 2025

What Changed

Shopify has deprecated the returnRefund mutation in favor of a new returnProcess mutation within the Admin API. This streamlined approach consolidates return lifecycle management by combining disposition decisions and financial processing into a single API call, eliminating the need for separate operations. Additionally, the Return.suggestedReturnRefund field has been replaced with the new Return.suggestedFinancialOutcome field for improved clarity and functionality.

Why This Matters

For Shopify developers managing return workflows, this change simplifies integration logic and reduces complexity in handling return management. By merging two operations into one, the new returnProcess mutation decreases API calls, improves performance, and makes return processing more intuitive. If your app relies on the deprecated returnRefund mutation or suggestedReturnRefund field, migration is now necessary to maintain compatibility with future Shopify Admin API versions.

What You Should Do

How GetShopifyToken Helps

GetShopifyToken makes it easy to obtain and manage the OAuth credentials needed to access Shopify's Admin API. Whether you're updating your app for the new Returns Processing API or building fresh integrations, we handle the token generation so you can focus on implementation.

← More Shopify Updates