Swap integrates with Mintsoft to automate Quality Control (QC) and improve returns processing efficiency. This article outlines the setup process and key behaviours of the integration.
This article is for users of Returns V2. For the Returns V1 version, click here.
Requirements
Before connecting:
All products in Shopify must have a SKU defined.
Mintsoft returns are only retrieved using the Mintsoft order number.
Connecting Mintsoft
To connect Mintsoft, you must provide a permanent API key. This enables automatic synchronisation between Mintsoft and Swap.
⚠️ Note: Linking via username and password is not supported.
Open the Returns drop-down menu
Go to "Integrations"
Under "Mintsoft", click "Connect"
Enter your API key and Client ID
Click "Connect"
You now need to map the conditions
For more information, please refer here.
Finally, select manual or automatic processing
Return Processing Delay
Returns are processed on a one-day delay. For example:
Returns received in Mintsoft on 27 May will be automatically updated in Swap on 28 May.
If a return is manually processed by the brand before Swap’s nightly update, it will be skipped in the automated workflow.
Integration Features
1. Add Tracking Number to Mintsoft
Swap can populate the ExternalOrderReference field in Mintsoft with the tracking number. This allows warehouse staff to scan the return label on arrival and quickly find the corresponding return.
2. Sync QC Data from Mintsoft to Swap
Condition Mapping: Once the Mintsoft API key is connected, QC conditions are pulled automatically into Swap.
Condition names must remain unchanged in Swap to ensure they stay in sync with Mintsoft.
If QC conditions aren't appearing, verify the API key and check the condition setup in Mintsoft