/ /

Magento Tax Engine Installation Guide

Integrate Magento with the Kintsugi tax engine: enter your store name and REST API domain, generate API credentials, and grant sales, catalog, customer access.
Updated 12 days ago

Follow these steps to establish a seamless data integration between both platforms.


Prerequisites

  • Admin access to your Magento account

  • A valid Kintsugi account

  • Permissions to create integrations and access API credentials in Magento


Step-by-Step: Integrate Magento with Kintsugi

1. Log In to Magento

  • Go to your Magento Admin URL

  • Enter your username and password

  • Click Sign In

  • Screenshot 2026-09-01 at 9.02.33 AM.png

2. Get Your Store Name

  • Navigate to: Stores > All Stores

Screenshot 2026-09-01 at 9.03.14 AM.png

  • Select your store (e.g., "Main Website Store")

Screenshot 2026-09-01 at 9.11.21 AM.png

  • Copy the store name for later use

Screenshot 2026-09-01 at 9.11.53 AM.png

3. Start Magento Integration in Kintsugi

  • Log in to your Kintsugi account

    kintsugi login.png

  • Go to Data Sources

    data sources.png

  • Click Browse for Integration

    browse integration.png

  • Look for Magento and click Connect

    ds23.png

You’ll see a form requiring six key fields:

  • Shop Name

  • Magento REST API Domain

  • Consumer Key

  • Consumer Secret

  • Access Token

  • Access Token Secret

Screenshot 2026-09-01 at 9.17.09 AM.png

4. Fill in the First Two Fields

  • Shop Name: Paste the name of your Magento store

  • Magento REST API Domain: Copy the base URL of your Magento site (e.g., https://818659c132.nxc.li.io) and paste it here

Screenshot 2026-09-01 at 9.25.11 AM.png

5. Generate Magento API Credentials

  • In Magento, go to: System > Extensions > Integrations

Screenshot 2026-09-01 at 9.26.34 AM.png

  • Click Add New Integration

Screenshot 2026-09-01 at 9.26.48 AM.png

  • Fill out the form:

    • Name: Example “Kintsugi Integration”

    • Email: A valid email (e.g., you@domain.com)

    • Password: Your Magento admin password

Screenshot 2026-09-01 at 9.28.05 AM.png

  • Click the API tab

  • Under Resource Access, check the following:

    • Sales

    • Catalog

    • Customers

Screenshot 2026-09-01 at 9.28.50 AM.png

  • Click Save

Screenshot 2026-09-01 at 9.29.04 AM.png

6. Activate the Integration

  • After saving, locate your integration in the list (e.g., "test dev")

  • Click Activate

Screenshot 2026-09-01 at 9.31.21 AM.png

  • Confirm API permissions again (Sales, Catalog, Customers)

  • Click Allow

Screenshot 2026-09-01 at 9.50.28 AM.png

7. Copy API Credentials

You will now see the following Integration Tokens on screen:

  • Consumer Key

  • Consumer Secret

  • Access Token

  • Access Token Secret

Copy and paste each value into the corresponding field in Kintsugi:

  1. Consumer Key

  2. Consumer Secret

  3. Access Token

  4. Access Token Secret

Screenshot 2026-09-01 at 9.52.21 AM.png

8. Complete the Setup

  • Once all fields are filled, click Save in Kintsugi

  • You should see a success message: "Successfully connected to Magento"

Screenshot 2026-09-01 at 9.53.26 AM.png

  • To confirm:

    • Refresh your Kintsugi page

    • Go to Data Sources and check Manage Integrations

    • Magento should now appear as one of your Active integrations

KINTSUGI APP UI (3).png


Next Step: Turn On Tax Calculation

Connecting your store brings your Magento transaction data into Kintsugi, which is what powers your nexus tracking and filings. It does not yet calculate tax at checkout.

To collect tax on Magento orders, install the Kintsugi Sales Tax plugin on your store. That step needs command line access to your Magento server, so loop in whoever manages your Magento environment before you start.

Before you do, check that your Magento and PHP versions are supported. The plugin works on Magento Open Source and Adobe Commerce 2.4.6 through 2.4.9, and Magento 2.4.9 specifically requires plugin version 1.1.0 or later. Versions 2.4.5 and earlier are not support targets.

Full walkthrough, including the complete version table and troubleshooting: Installing Kintsugi Sales Tax Plugin for Magento


Need Help?

For further concerns, we're always here to help. Click the chat bubble in the bottom-right corner to speak with our support team.

Was this article helpful?