Retail Exchanges now use the Shopify Exchanges implementation

Retail Exchanges are now supported by the Shopify Exchange Platform. Previously, Retail Exchanges used a separate system called ExchangesV2, which handled exchanges as a combination of a Return and an Order Edit, along with any necessary refunds.

If your shop has opted out of Shopify Exchanges, we will continue to process exchanges using the old system.

Now, Retail Exchanges will create a Return with exchange line items, consolidating several operations into one:

• Separate sales agreements for the Return and the Order Edit are no longer created. The Return agreement now includes all the sales created from an exchange.
• The same validations and constraints that apply to exchanges on the Return platform also apply to exchanges conducted through Shopify POS.

If your integrations or ERP interfaces previously depended on having distinct sales agreements for the Return and the Order Edit, please note that these are now consolidated. The Return agreement now encompasses both operations, so you may need to update your integration to utilize a single sales agreement.

Furthermore, exchanges created in Admin, or via the returnCreate() APIs will now be visible on the Order.exchangeV2s() API. If you are using that API and would like to exclude those “mirrored” exchanges from the API, you can use a new include_mirrored_exchanges query filter parameter.

We are deprecating the ExchangeV2 APIs and plan to remove them after a 1-year deprecation period. During this time, even though exchanges are created through the Shopify Exchange Platform, they will still be accessible via the Order.exchangeV2s() API.