You can enable the return workflow sync from Marketplacer to Shopify using MConnect. This feature allows refund requests created in Marketplacer to sync automatically to your Shopify admin, so sellers can review and action returns directly in Shopify.
Note: This feature is currently available only for limited number of operators.
Before you enable return sync
This feature is only available if:
- Advanced refunds are enabled.
- Refund requests do not use the PENDING_APPROVAL status.
- Refund requests do not include more than one status type in the same request (for example, AWAITING_RETURN and REFUND_ACCEPTED).
Your Shopify custom app must also include the following Admin API scopes:
- read_merchant_managed_fulfillment_orders
- read_third_party_fulfillment_orders
- read_locations
- read_returns
- write_returns
If any of these scopes are missing, account setup in MConnect will fail when you verify access scopes. For help updating these settings, see the article How to update your Shopify permissions.
Enable return workflow sync in MConnect
- Sign in to the Seller portal.
- Go to Extensions > MConnect.
- Navigate to Settings.
- Under Orders, find the setting Sync returns workflow from [Marketplace name] to Shopify and turn it on.
Once enabled:
- Refund requests for orders processed via MConnect will start to sync from Marketplacer to Shopify.
- Refund requests will appear in the Refunds section in MConnect and will show a sync status across Marketplacer, MConnect, and Shopify.
- In Shopify, sellers can accept or deny returns. These actions will match the actions taken in Marketplacer.
Processing returns per line item in Shopify
In Shopify, sellers can select the quantity to process per line item. The table below shows how Shopify actions sync to Marketplacer return statuses:
| Action taken in Shopify | Status synced to Marketplacer |
| Process and refund for all quantities of a line item | Line item is marked as Accepted |
| Process and refund for partial quantities of a line item | Line item is marked as Denied Note: Marketplacer does not support partial acceptance. |
| Close return with all quantities processed |
Line item is marked as Accepted
|
| Close return with 0 quantities processed | Line item is marked as Denied |
| Cancel return (no quantities processed) | All line items are marked as Denied |
Notes:
- Sellers can process refunds multiple times for the same return in Shopify.
- Once all quantities for a return are processed, Shopify automatically closes the return.
- If no quantities are processed, sellers can cancel the return in Shopify. This will sync all line items as Denied in Marketplacer.
- Do not use Reopen return, as this action is not supported in the Marketplacer workflow.
Related articles