Skip to main content
Solved

Shopify store uses mexchangeV2 field from Shopify Order API

  • June 2, 2026
  • 5 replies
  • 49 views

Forum|alt.badge.img+1

Shopify store uses a custom app that relies on the exchangeV2 field from Shopify Order API. This field was deprecated in April 2025 and is being phased out following Shopify's standard API versioning cycle. You need to migrate to the Returns API before April 1, 2027. The app(s) impacted are: Acumatica ERP

Best answer by MichelleDowden62

As of 2026R1 (also implemented in 2025R1 and 2025R2) the Shopify connector uses the Shopify Order Returns API instead of the deprecated 
ExchangeV2 API to process POS returns and exchanges.

The new API consolidates returns, exchanges, and related refunds under a single return object. The connector retrieves all relevant data from the Order Returns API when the Refunds entity is processed, ensuring compatibility with future Shopify versions.

Required API access scopes:

  • read_returns
  • write_merchant_managed_fulfillment_orders 
  • write_third_party_fulfillment_orders or write_marketplace_fulfillment_orders

5 replies

Yuri Karpenko
Captain II
Forum|alt.badge.img+7

@cwise52 , Is this a question? 


As of 2026R1 (also implemented in 2025R1 and 2025R2) the Shopify connector uses the Shopify Order Returns API instead of the deprecated 
ExchangeV2 API to process POS returns and exchanges.

The new API consolidates returns, exchanges, and related refunds under a single return object. The connector retrieves all relevant data from the Order Returns API when the Refunds entity is processed, ensuring compatibility with future Shopify versions.

Required API access scopes:

  • read_returns
  • write_merchant_managed_fulfillment_orders 
  • write_third_party_fulfillment_orders or write_marketplace_fulfillment_orders

Forum|alt.badge.img+1
  • Author
  • Semi-Pro I
  • June 2, 2026

Spectacular! 2026 R1 it is!


Jeff96
Captain II
Forum|alt.badge.img+5
  • Captain II
  • June 8, 2026

As of 2026R1 the Shopify connector uses the Shopify Order Returns API instead of the deprecated 
ExchangeV2 API to process POS returns and exchanges.

The new API consolidates returns, exchanges, and related refunds under a single return object. The connector retrieves all relevant data from the Order Returns API when the Refunds entity is processed, ensuring compatibility with future Shopify versions.

Required API access scopes:

  • read_returns
  • write_merchant_managed_fulfillment_orders 
  • write_third_party_fulfillment_orders or write_marketplace_fulfillment_orders

Does this mean everyone will need to be on 26R1 by April 1st? 


@Jeff96 

Changes were backported to 2025R1 and 2025R2 as well. I have updated the original post.