Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
OpenCart

TaxJar Sales Tax for OpenCart — US sales tax in the cart and checkout, reports to TaxJar

TaxJar Sales Tax for OpenCart 4.x, 3.x, 2.3 (US): a sales tax line in the cart and checkout; Pro adds orders and refunds to TaxJar, tax codes, exempt customers, a journal. A licence for life.

Pro · lifetime licence Staging copies are included. The more sites, the cheaper each one
Compatibility
OpenCart 4.0.2.0–4.1.x, 3.0.x, 2.3.0.2 · module language: English
PHP
7.0 or newer
Version
v1.0.0 (OpenCart 4)
v1.0.0 (OpenCart 3.x)
v1.0.0 (OpenCart 2.3)
Licence
a site + a staging copy, lifetime
Trial
7 days, no card, one per site
Updated
15.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Connecting with a TaxJar token, a connection check, nexus states and product tax categories ✔ ✔
TaxJar test and live environment ✔ ✔
A ship-from address for the states that tax by the place of shipping ✔ ✔
A "Sales Tax (CA)" line in the totals in place of the "Taxes" lines ✔ ✔
Cart, mini cart, checkout and orders created from the admin ✔ ✔
Nexus states only: no request to TaxJar for the others ✔ ✔
Discounts by line, fees as separate lines, products without a tax class ✔ ✔
Cached answers, an 8 s timeout, a fallback to the OpenCart tax rates ✔ ✔
Shop currency to USD and back ✔ ✔
The calculation kept with the order and a log ✔ ✔
Orders sent to TaxJar by status and with buttons — ✔
Refunds to TaxJar and removal of an order — ✔
A queue with retries and an ID prefix for several shops — ✔
Adding past orders of a period — ✔
Product tax codes per category and product — ✔
Exempt customer groups and customer sync — ✔
Address validation (ZIP+4) — ✔
A journal with filters and a retry of the stopped — ✔

What it looks like

The tax line at the checkout
The order totals: a product, a fee, shipping, the “Sales Tax (CA)” line from TaxJar and the total.
Connecting TaxJar
The “Connection” tab: the status, the token, the environment, the connection check with the nexus states and the ship-from address.

Key points

What the seller gets

The buyer enters a US address and the totals get a tax line whose title can show the state (“Sales Tax (CA)”).

What is in the admin

Extensions → Extensions → Order Total → TaxJar Sales Tax. Tabs: “Connection”, “Calculation”, “Reports”, “Product tax codes”, “Exempt customers”, “Log”, “Licence”.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • OpenCart 4.0.2.0–4.1.x, 3.0.x or 2.3.0.2; PHP 7.0+ for 2.3, the cURL extension.
  • A TaxJar account with an API token (Account → TaxJar API). Every calculation and every order sent counts toward your TaxJar plan, so the module caches answers and calls only the nexus states.
  • The shop needs a currency with the code USD (System → Localisation → Currencies): TaxJar works in dollars.
  • The sort order among the totals must be higher than “Taxes”; the module sets 6 on install. If the order is changed, the module adds no tax and writes the reason to the log.
  • TaxJar calculates only US addresses with a state and a 5-digit ZIP code; other countries keep the OpenCart rates.
  • If the shop still has US tax rates set up and “Display Prices With Tax” is on, product prices in the storefront show the shop tax: turn that display off or remove those rates.
  • A refund goes to TaxJar for the whole order: partial refunds are not sent.
  • Address validation in the TaxJar API is available from the Professional plan, according to the TaxJar documentation.

Version history

v1.0.0 Current 15.11.2026

For OpenCart 4.x, 3.x and 2.3: US sales tax from TaxJar in the cart, the mini cart, the checkout and orders from the admin, the ship-from address, nexus states, cached answers, a fallback…

Frequently bought with TaxJar Sales Tax

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

TaxJar Sales Tax for OpenCart 4.x, 3.x and 2.3 calculates US sales tax through TaxJar: for a cart going to a US address with a state and a ZIP code the module asks TaxJar and shows one tax line in the totals, for example “Sales Tax (CA)”, in place of the “Taxes” lines of OpenCart. The same works in the mini cart, at the checkout and in orders created from the admin.

What the seller gets

The buyer enters a US address and the totals get a tax line whose title can show the state (“Sales Tax (CA)”). TaxJar calculates the line from the shipping address, and the module puts it in place of the “Taxes” lines OpenCart added before. Discounts (coupon, reward points) are spread over the product lines, fees such as “Handling Fee” stay as separate lines, and gift vouchers and credit are left alone. Product prices in the storefront stay as the shop is set up: TaxJar calculates the tax line in the totals.

The module calls TaxJar only for US addresses with a state and a ZIP code, and, if you choose, only for the states where your account has nexus: no request goes out for the other states. Addresses in other countries keep the OpenCart tax rates. A product without a tax class is either not taxed, as in OpenCart, or left to TaxJar: the seller chooses.

Every order keeps its own calculation: the order page shows what calculated it, the tax amount, the rate, the jurisdiction and the sourcing (destination or origin). If TaxJar does not answer in 8 seconds or rejects the token, the buyer still checks out with the shop tax rates and the reason goes to the log; after an error the module waits a minute (10 minutes for a rejected token) before calling again.

What is in the admin

Extensions → Extensions → Order Total → TaxJar Sales Tax. Tabs: “Connection”, “Calculation”, “Reports”, “Product tax codes”, “Exempt customers”, “Log”, “Licence”. In TaxJar open Account → TaxJar API, copy the token and paste it on the “Connection” tab: the token is stored encrypted and is never shown again. Press “Check connection”: the module shows which environment it connected to and loads the nexus states and the product tax categories of your account. The ship-from address is set here too: for the states that tax by the place of shipping (Texas and others) it goes into the request.

The “Calculation” tab holds the line title (with or without the state), showing a zero line, nexus states only, how products without a tax class are treated, the cache lifetime in minutes (60 by default) and the position among the totals: the module sets 6 itself on install and does not add tax when the order stands before “Taxes”.

Pro opens three tabs. “Reports” has the statuses at which an order goes to TaxJar, the statuses for a full refund and for removal, an order ID prefix for several shops and the address validation. “Product tax codes” holds the TaxJar tax codes per category and per product, with a list of codes from your account. “Exempt customers” holds the customer groups exempt from tax (wholesale, government, other), with the customers sent to TaxJar. The order gets a “Reports in TaxJar” box with the buttons “Update in TaxJar”, “Send a refund”, “Remove from TaxJar” and “Validate the address”.

The journal lists all orders with the filters “Waiting”, “Stopped”, “Done” and “Shop rates used”, the buttons “Send what is waiting now” and “Retry the stopped ones”, and “Send past orders”: adding the orders of a period to the queue, up to 200 a click.

How it works, step by step

  1. Install the archive for your OpenCart version, then in Extensions → Extensions choose the type “Order Total”, install “TaxJar Sales Tax” and open its settings.
  2. Paste the token from TaxJar (Account → TaxJar API), fill in the ship-from address and press “Check connection”: the nexus states appear.
  3. Make sure the shop has the USD currency: TaxJar works in dollars, and the module converts amounts in another currency at the shop rate and back.
  4. Switch the status on, save, and add a product with a tax class to the cart with a US address.
  5. The totals get a “Sales Tax (state)” line; after the checkout the calculation is on the order page.
  6. In Pro choose the statuses at which orders and refunds go to TaxJar and, if needed, set the tax codes and the exempt customer groups.
  7. Watch the queue in the journal: stopped records can be retried with one button.

Under the hood

  • TaxJar REST API: the tax for an order (POST /taxes), nexus states, product tax categories, orders and refunds (transactions), customers, address validation.
  • Bearer token authorisation, the token is encrypted and never shown in the settings; the API version is pinned.
  • The calculation does not block the checkout: the shared waiting budget at the checkout is about 7 seconds, the address check takes no more than 3 of it, and after a timeout the module stays away from the API for a while.
  • Answers 400, 401, 403, 422, 429 and 5xx are shown next to the calculation in words, with no raw JSON; a rejected token pauses calls for 10 minutes.
  • The cache is keyed by the cart content and the address: identical requests are not sent twice.
  • Orders go out through a queue with retries (up to 6 attempts with a growing pause); setting the same status again does not make a second sale, and after a refund the order is not sent to TaxJar as a sale again.
  • In Free all three Pro tabs are locked, and a forged request does not change Pro values.
  • The interface is in English. Amounts are shown in the shop format.

Installation

  1. OpenCart 4: Extensions → Installer, upload cc_taxjar.ocmod.zip without renaming it.
  2. OpenCart 3.x: Extensions → Installer, upload cc_taxjar-oc3.ocmod.zip, then Extensions → Modifications → Refresh.
  3. OpenCart 2.3: Extensions → Installer, upload cc_taxjar-oc23.ocmod.zip (the FTP settings in System → Settings → FTP are needed; otherwise unzip the archive and copy the upload/ folder into the shop root by hand), then Extensions → Modifications → Refresh.
  4. Extensions → Extensions → Order Total → TaxJar Sales Tax: install it and open the settings.
  5. Paste the TaxJar token, fill in the ship-from address, press “Check connection” and save.
  6. For Pro: enter the licence key or start the trial on the “Licence” tab.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this an official TaxJar module?

No, it is an independent integration through the public API. TaxJar is a trademark of its owner.

Where do I get the token?

In TaxJar: Account → TaxJar API. Paste it on the "Connection" tab and press "Check connection".

What do the requests to TaxJar cost?

They are paid under your TaxJar plan. The module keeps their number down: answers are cached, requests go out only for the nexus states, and when TaxJar is unavailable the shop tax rates apply.

What about product prices in the storefront?

TaxJar calculates the tax line in the totals. Product prices in the storefront stay as the shop is set up, so it is best to remove the US tax rates or turn off the display of prices with tax.

What happens if TaxJar does not answer?

The buyer checks out with the OpenCart tax rates, the reason is written to the log, and the next attempt comes in a minute.

Does the module calculate tax outside the US?

No: TaxJar is called only for US addresses with a state and a ZIP code. Other countries keep the OpenCart rates.

Does the free version work without Pro?

Yes: the connection, the calculation in the cart and checkout, nexus states, the cache and the log work in the free version. Sending orders and refunds, product tax codes, exempt customers, address validation and the journal are in Pro.

Which OpenCart versions are supported?

OpenCart 4.0.2.0–4.1.x, 3.0.x and 2.3.0.2: three separate archives in one product.

Is the licence for life?

Yes, for OpenCart it is one payment and a licence for life, for two sites.

What happens after the trial?

Pro switches off, the orders in the queue stop with a reason, and the free part keeps working.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module