/ /

WooCommerce Tax Engine Integration Guide

Connect your WooCommerce store to Kintsugi for real-time tax calculation and compliance.
Updated 3 months ago

Overview

The WooCommerce tax-engine integration ensures that every order in your store is taxed accurately and in compliance with state rules. Once connected, your transactions will automatically sync to Kintsugi, where you can review, approve, and manage them.

Step 1: Generate API Keys in WooCommerce

  1. Log in to your WooCommerce Admin.

  2. Go to Settings > Advanced > REST API.

  3. Click Add Key and set permissions to Read/Write.

  4. Copy the Consumer Key (starts with ck_) and Consumer Secret (starts with cs_). You’ll need these later.

Step 2: Connect WooCommerce to Kintsugi

1. Log in to your Kintsugi account.

kintsugi login.png

2. Click Data Sources from the left navigation panel.

data sources.png

3. Click Browse Integration to proceed with he process.

browse integration.png

4. Look for WooCommerce and click Connect.

ds16.png

  1. A modal window will open, enter the following details:

  • Shop Domain (your WooCommerce store domain).

  • Admin URL (your WooCommerce admin panel URL).

  • Consumer Key (ck_...).

  • Consumer Secret (cs_...).

  • Click Save.

Step 3: Install the Kintsugi Plugin in WooCommerce

  1. Get the Kintsugi WooCommerce Plugin. Click HERE to download the latest version of the SalesTax plugin (it will be a ZIP file).

  2. In WooCommerce, go to Plugins > Add Plugin.

  3. Click Upload Plugin and select the Kintsugi WooCommerce plugin .zip file.

  4. Wait for the plugin to finish installing and activating.

Step 4: Activate the API key

  1. Generate your API key in Kintsugi, you may refer to this help article: Mastering API Keys: Creation, Management, and Security

  2. After generating the API key in the Kintsugi app, copy and paste it into the Kintsugi plugin settings within WooCommerce.

  3. Go to WooCommerce > Kintsugi to access plugin settings.

  4. Click Connect to Kintsugi.

You’ll see a green confirmation message:

“Connected to Kintsugi

Your store is connected to Kintsugi and you can disconnect at any time.”

Step 5: Enable Tax Collection and Webhooks

In the plugin settings, check the box Enable Kintsugi Tax Collection and Webhook Processing.

  • When enabled, tax calculations and webhooks will run automatically.

  • When disabled, tax processing will stop.

Confirm the connection status shows:

Step 6: Verify Integration in Kintsugi

  1. Go to Data Sources and check Manage Integrations. You should see WooCommerce under the "Active" tab.

    KINTSUGI APP UI (18).png

  2. Go to the Transactions tab in Kintsugi.

  3. Review your synced WooCommerce transactions, including:

    • Transaction ID and date

    • Customer details

    • Jurisdiction

    • Tax liability

    • Collected tax

    • Transaction status

  4. Click a transaction to see detailed order, product, and payment information.

    Orb-Transactions.png

Step 7: Test Tax Calculation in WooCommerce

  1. Add products to your cart and proceed to checkout.

  2. The cart totals will show subtotal, shipping, tax, and total.

  3. Complete checkout with your preferred payment method.

  4. Refresh the Transactions tab in Kintsugi—your order will appear instantly with all tax details.

Next Steps

  • To categorize products correctly, see our guide: Updating Product Category and Subcategory.

  • Once connected, your WooCommerce sales are automatically tracked in Kintsugi, ensuring compliance without manual effort.

✅ Your WooCommerce store is now fully connected to Kintsugi’s tax engine. Tax calculations, transaction syncing, and reporting are handled automatically—so you can stay focused on growing your business.

Was this article helpful?