This guide walks you through setting up the Chargebee Tax Engine integration to Kintsugi to enable automated sales tax calculations and address validation.
Step-by-Step Integration Guide for Kintsugi and Chargebee
Step 1: Connect Kintsugi to Chargebee
Log in to the Chargebee site
Go to Apps > Go to Marketplace > Tax Management > Kintsugi Tax.
On the Kintsugi Tax configuration page:
Click Get Started if you already have a Kintsugi account.
Click Sign up to create a new account if you don't have one yet.
Step 2: Authenticate Your Kintsugi Account
Enter your Kintsugi credentials by specifying the Kintsugi API Key.
Check the box to confirm "I understand Kintsugi…" and click Authenticate.
Step 3: Confirm Organization Address
Confirm your organization address. Chargebee automatically pulls in your business address from the settings; update it if needed or click Proceed.
Step 4: Enable Shipping Address Validation
In Shipping Address Validation, enable the toggles and click Proceed. You can update your toggle choices later if necessary.
Note: After you have completed this integration process, you can run address validation checks when required. After enabling Kintsugi, the Chargebee-Kintsugi integration validates the taxable address for all new customers who subscribe to you. All the existing subscriptions' taxable addresses get validated during the first validation check run after the integration is configured.
Step 5: Configure Sync Rules
In Configure Sync Rules, enable the toggle button to allow Chargebee to sync invoices and credit notes to Kintsugi.
Select Sync all invoices & credit notes from the dropdown.
Click Proceed.
Note: You can update your toggle choices later if necessary.
Step 5: Add Tax Regions
Click Go to Taxes to add tax regions to Chargebee.
Select a region twhere you want Kintsugi to calculate sales tax.
NOTE: Kintsugi currently supports automated tax calculation for the United States, Canada, Europe, and Australia.
Choose Kintsugi as your configuration mode.
That's it. Your Kintsugi account is now integrated with Chargebee!
If you want to learn more about how to validate addresses and sync product catalogs to Kintsugi, you can check this page.
When Sales Tax Collection Begins
IMPORTANT: Chargebee Tax-Engine Integration's sales tax collection begins as soon as a registration enters one of the following statuses:
Processing
Validating
Registered
This applies whether you create the registration directly from Kintsugi or import it into your account.
Clicking "Register" in the Kintsugi app is submitting a request for registration. A successful submission of the request moves the state's status into Processing/Validating/Registered).
Imported registrations also begin collecting tax once they appear in one of these statuses.
The effective date and click date do not control when tax collection starts — it’s entirely based on the registration status.
To confirm tax is being collected, go to Registrations tab and check if the state's registration status shows Processing, Validating, or Registered.
Unlinking the Integration
To disconnect the Kintsugi integration from Chargebee:
Go to Apps > Apps Connected > Kintsugi
Click Unlink integration.
Important Reminder
The address features in Kintsugi (validation, addition, updates, etc.) only affect data inside Kintsugi. They won’t sync back to your source system in Chargebee.
If you see missing or incorrect addresses, be sure to update them in the source system as well.
Also adjust your source system settings to make sure future transactions capture full address data.
⚠️ Chargebee Auto-Cancel Behavior
Chargebee automatically cancels any subscription renewal that has an invalid address.
To prevent unexpected cancellations, ensure all renewals have a valid address before enabling tax calculation with Kintsugi.
If you want to disable this auto-cancel feature, contact the Chargebee Support Team before turning on tax calculation.
Need help?
For further concerns, we're always here to help. If you can't find the answer you're looking for, please reach out to us using the chat bubble in the bottom right corner.