Checkout Champ Tax Engine Integration Guide

This guide walks you through activating the Kintsugi tax plugin in CheckoutChamp, connecting it to your Kintsugi account, and applying it to your campaigns to enable automated sales tax calculation at checkout.

How it works

This integration has two parts that work together:

• The Kintsugi tax plugin in Checkout Champ sends each checkout to Kintsugi and returns the calculated tax in real time.

• The Checkout Champ read-only connection in Kintsugi imports your orders, products, customers, and refunds so Kintsugi can track liability and prepare filings.

You need both. The plugin calculates tax at checkout; the read-only connection brings the completed orders into Kintsugi.

Prerequisites

Before you begin, make sure the following are in place:

• Checkout Champ read-only connection. Connect Checkout Champ to Kintsugi and let the first import finish. Follow the Checkout Champ Read-Only Integration Guide. Kintsugi needs your products synced to calculate tax correctly at checkout.

• Primary business address saved in Kintsugi.

• At least one tax registration in Kintsugi. Kintsugi only calculates tax for jurisdictions where you are registered to collect.

• Your Kintsugi Organization ID and API key. You will enter these in the plugin. [PENDING: confirm the exact navigation path in Kintsugi to find the Organization ID and generate an API key, and link to the relevant help article if one exists.]

• Admin access in Checkout Champ to activate plugins and edit campaigns.

Step 1: Activate the Kintsugi tax plugin

• Click on the Admin section from the navigation sidebar.

• Click on the Plugins page (Admin→Plugins)

• Click on the Tax Services tab.

• Click on the Kintsugi tile.

• Click + Activate.

Step 2: Connect your Kintsugi account

Type in the required fields organizationId and apiKey from Kintsugi.

• Enter an optional FriendlyName to differentiate multiple Kintsugi plugins

• sendTransactions: We recommend leaving this unchecked. Your orders are already imported through the read-only connection, so this option is not needed to get transactions into Kintsugi. If you check it, Checkout Champ pushes each sale to Kintsugi immediately at checkout, and Kintsugi matches those sales to the same orders when the read-only sync imports them, so you will not see duplicates either way.

• calculateShippingTax: We recommend checking this. Kintsugi will calculate tax on shipping charges in jurisdictions where shipping is taxable.

• excludeTestCards: We recommend checking this on live accounts. Kintsugi will skip tax calculation on checkouts made with test cards, so your test orders do not affect your tax records.

When finished, click the Connect button.

Step 3: Apply the plugin to campaigns

Go to CRM > Campaigns, then click the blue Edit button next to the Campaign.

This will take you to the Campaign Edit page.

• In the “General Details” Section under "Billing options”. Below Tax Service, click on the drop-down and select Kintsugi. Then, click on the blue "Update."

• Check the box next to “Auto Tax Calculation” if you want it to automatically calculate the sales tax and then click "Update".

Note: Kintsugi automatically determines the sales tax rates at checkout. Kintsugi makes setting up and calculating sales tax for your online store much easier to manage.

Step 4: Test and verify

1. In Checkout Champ, go to Customer > Order Entry and start a test order on a campaign where Kintsugi is the Tax Service.

2. Enter a shipping address in a jurisdiction where you are registered and add a taxable product.

3. With Auto Tax Calculation enabled, the sales tax updates automatically as soon as you add quantity or change the address. You do not need to click a calculate button.

4. Complete the order.

5. In Kintsugi, wait for the next sync and confirm the order appears once under Transactions with the same tax amount shown at checkout.

If the tax at checkout matches the transaction in Kintsugi, your setup is complete.

What to Expect at Checkout

To avoid $0 tax on new products, add them in Checkout Champ and allow the read-only sync to import them before selling them.

FAQs

Q: Do I need to click "Enable Tax Collection" in Kintsugi?

A: No. For Checkout Champ, tax calculation is turned on by activating the plugin and setting Kintsugi as the Tax Service on your campaigns. There is no separate Enable Tax Collection step in Kintsugi for this integration.

Q: Why is tax showing as $0 on a product?

A: The most common causes are: the product has not yet synced to Kintsugi, or the ship-to address is in a jurisdiction where you have no registration in Kintsugi. Check that the product appears under Products in Kintsugi and that the jurisdiction appears under Registrations.

Q: I have multiple stores in Checkout Champ. Do I need multiple plugins?

A: Each plugin points to one Kintsugi organization. If all your stores belong to the same Kintsugi organization, one plugin is enough; assign it to each campaign in Step 3. Use the optional FriendlyName field if you activate more than one Kintsugi plugin.

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.