Enable cancellation sync from Marketplacer to Shopify

The Shopify integration with Marketplacer via MConnect allows sellers to sync cancellations and returns from Marketplacer to Shopify. When an item is cancelled in Marketplacer, the update is automatically sent to Shopify to keep order and inventory records aligned.  

Refund statuses from Marketplacer also sync to Shopify to help sellers manage returns more efficiently. By default, Shopify restocks items that are refunded in Marketplacer. Sellers can disable this behavior in MConnect. This helps manage stock more accurately, since Marketplacer does not currently restock refunded items.

How cancellation sync works

Once cancellation sync is enabled:

• Cancellations and returns marked as REFUNDED in Marketplacer are retrieved by MConnect.
• Full order cancellations are synced when all line items are cancelled.
• Partial cancellations are synced when only some items or quantities are cancelled.
• Custom line items (like shipping) are not supported.
• Only new refunds are synced and past refund requests are not retrieved.

Enable cancellation sync (Shopify integration)

Sellers can sync cancellations between Shopify and Marketplacer using MConnect. This article explains how to enable this feature.

Before you start

To sync cancellations, you need to:

• Update permissions to add the required API scopes in their custom Shopify app
• Enable the sync in MConnect
• Enable refund syncing settings in MConnect

Update Shopify app permissions

The Marketplacer app in Shopify needs additional permissions to support this feature. 

1. Log in to your Shopify account.
2. Go to Settings > Apps and Sales Channels.
3. Click Develop apps.
4. Select the custom app used to connect to your marketplace. The app name will depend on your earlier setup.
5. In the custom app's page, click the Configuration tab.
6. In the Admin API integration field, click Edit.
7. Make sure the app has the following scopes to enable cancellation sync:
   • Read_merchant_managed_fulfillment_orders
   • read_locations
   • write_returns
   • read_returns
8. Save changes. 
   Tip: If the integration is already set up, You may need to re-authorize it to apply the updated permissions.

Turn on sync in MConnect

In the MConnect or Operator Portal, turn on the setting for cancellation sync.

1. Sign in to the Seller Portal.
2. From the side nav, click Extensions > MConnect.
3. Select Shopify.
4. In MConnect, go to Settings.
5. Scroll down to Order Settings and ensure that these settings are selected:
   • Sync invoices from <Vertical name> to Shopify
   • Sync completed refunds from <Vertical name> to Shopify

Once enabled, order and line item cancellations will sync automatically between Shopify and Marketplacer.

Additional resources