The Bandcamp integration imports unshipped Bandcamp merch orders into Mintsoft at a configurable frequency and sends shipment confirmations (including carrier and tracking number) back to Bandcamp when orders are despatched in Mintsoft.
Note: This integration does not sync product catalogue or stock levels between Mintsoft and Bandcamp. Orders already marked as shipped in Bandcamp will not be imported.
Before you start
You must contact Bandcamp to obtain your integration credentials:
Client ID (client_id).
Client Secret (client_secret).
Add your Bandcamp account
Once you have your credentials, follow these steps:
Go to Connect, then click Order Integrations.
Click BandCamp.
Click Add Account.
Select the Client.
Select the Warehouse where orders should be created.
Select BandCamp as the Channel.
Enter the Client Secret from Bandcamp.
Enter the Client ID from Bandcamp in the BandCamp Client ID field.
Set Valid Payment Statuses to 'paid' (or multiple statuses separated by semicolons, such as 'paid;pending').
Only orders matching these payment states will be imported.
Set Frequency to your preferred interval in minutes (minimum 15, maximum 1440).
15 minutes is recommended for most use cases.
Click Update.
Obtain your BandID
After adding your account, you need to retrieve your BandID:
Click Edit on your Bandcamp integration.
Look at the URL in your browser's address bar. It will look like: https://om.mintsoft.co.uk/bandcamp/EditAccount/1
The number at the end (1 in this example) is your Mintsoft ID for the Bandcamp integration.
In the URL, replace 'EditAccount' with 'getbands'. Your URL should now read: https://om.mintsoft.co.uk/bandcamp/getbands/1
Press Enter to load the page.
The page will display JSON data containing your band information. Look for the band_id field (a numeric value) in the first band entry and copy this number.
Return to the Edit Account screen.
Enter the BandID in the BandID field.
Click Update.
Configure optional settings
You can configure additional settings to customise how orders are imported:
Group Orders By Payment ID - When enabled, all Bandcamp items sharing the same payment ID are grouped into a single Mintsoft order. When disabled, each Bandcamp sale item creates its own order. Enable this if you want combined shipping per Bandcamp payment.
Activate the integration
Ensure Active is ticked to start importing orders. You can untick this later to pause the integration without deleting it.
Your Bandcamp integration is now complete and will synchronise orders according to your frequency settings.
Connection settings reference
For reference, here are all available fields on the Bandcamp connection page:
Client - Select which Mintsoft client the Bandcamp orders should import into.
Warehouse - Select which warehouse the orders should be created in.
Channel - Should be set to BandCamp.
BandID - Your Bandcamp band/store ID (obtained via the getbands step above).
Client Secret - The client_secret from Bandcamp.
BandCamp Client ID - The client_id from Bandcamp.
Valid Payment Statuses - Payment states to import (such as 'paid'). Multiple values can be separated by semicolons.
Group Orders By Payment ID - When enabled, items with the same payment ID are combined into one Mintsoft order.
Frequency (Minutes) - How often Mintsoft checks for new orders (15-1440 minutes; 15 recommended).
Active - Tick to enable the integration; untick to pause without deleting.
Note: The RefreshToken, LastRun and OrderImportCount fields are system-managed and cannot be edited.