This guide will walk you through the simple steps to integrate Kintsugi with your Shopware store.
Step 1: Download and Install the Extension
Download the extension:
Get the latest Kintsugi zip file from the Shopware Plugins File Index. Always choose the most recent version to ensure you’re installing the most updated version.
Extract the file:
Unzip the downloaded zip file. You’ll find another zip file inside named Kintsugi.zip.
Upload to Shopware:
In your Shopware admin panel
Go to Extensions → My Extensions
Click Upload Extension (at the top right corner)
Select Kintsugi.zip to upload
Activate the app:
Once uploaded, activate the Kintsugi app.
✅ Success! If the extension is active, you’ve successfully installed it.
Step 2: Obtain Shopware Credentials
You have two options to add Kintsugi as an integration.
Option A: Quick Setup (Administrator Switch)
This method is recommended for ease of setup, as Kintsugi primarily reads data.
Go to Integrations:
In your Shopware admin, go to Settings → Integrations.Add Integration:
Click “Add Integration”.Enter Name:
Type “Kintsugi” to the integration’s name box
Enable Administrator:
Simply turn on the Administrator switch.Save Credentials:
Copy and securely save the following credentials; you’ll need them later:Access Key ID (Client ID)
Secret Access Key (Client Secret)
Click “Save Integration”
Option B: Custom Role Setup:
If you prefer not to use the Administrator switch, you can create a custom role with specific permissions.
Create Role:
In your Shopware admin, go to Settings → System → Users & Permissions → Roles. Click Create role.Set Permissions:
Check the permissions listed below:Categories – View
Custom Products – View
Products – View
Customers – View
Orders – View, Edit
Refunds – View, Edit
Order – Create credit items
Promotion – View
Select “All” Checkbox:
To avoid confusion, select the "All" checkbox.Confirm with Password:
Upon saving your changes, you will be prompted to confirm with your password.
Setup the Integrations:
Go back to Settings → Integrations.
Click “Add Integration”.
Type “Kintsugi” to the integration’s name box.
Select the role
Save Credentials:
Copy and securely save the following credentials; you’ll need them later:Access Key ID (Client ID)
Secret Access Key (Client Secret)
Click “Save Integration”
Step 3: Configurations & Mandatory Settings
Before connecting Kintsugi, ensure these settings are applied:
1. Set Customer Group to “Net”
Go to Settings → Customer Groups → Standard Customer Group.
Select Net as the tax display.
Click Save and refresh the page.
2. Enable Kintsugi as a Tax Provider
Go to Settings → Tax.
Ensure Kintsugi appears as a tax provider. If not, toggle the switch to activate it.
Click Edit details.
Set Priority to 1 (so Kintsugi calculates taxes first).
Under “Availability,” select All customers or Customers from USA, depending on your use case.
Click Save.
Step 4: Connect Shopware with Kintsugi
Go to Extensions → My Extensions.
Find Kintsugi, click the three-dot menu (⋮) on the right, and select Open Extension.
If prompted, sign in to your Kintsugi account.
If the pop-up is blocked, click the provided link to open it manually.
Select your organization.
Go to Data Sources → Browse Integrations in Kintsugi.
Find Shopware and click Connect.
In the pop-up card, enter the credentials you saved earlier:
Shop Domain (your store’s main domain, e.g., myshop.com, without slashes)
Client ID
Client Secret
Click Save, then Authorize.
Once connected, the card will display as Active, confirming the integration was successful. 🎉
Step 5: Verify Your Connection
Refresh your Kintsugi screen, navigate to Data Sources → select Shopware.
If the connection status shows Active, you’re all set!
Important Notes
Kintsugi calculates taxes during the checkout process.
If an address change is needed after checkout, you need to cancel and re-create the order as Shopware won’t recalculate taxes post-checkout.
Orders are committed to Kintsugi only when the order status is “Done.”
Tax-engine features (such as tax estimation and webhook services) are exclusively available to premium customers.