Skip to content

External tax providers

Most stores tax an order from a rate table they author themselves: a list of regions and percentages you keep up to date. That works until the rules stop being a table — until the correct rate depends on the exact pair of addresses an order runs between, and changes more often than anyone can maintain by hand.

External tax providers is where you hand that calculation to a service that does maintain it.

Connecting a provider changes where the rate comes from, not what tax is. Your own rate table under Taxes stays exactly where it is. The provider is asked first; your table is what the order falls back to.

That fallback is the important half of the design, and it is worth reading twice:

🔴 When a connected provider cannot answer, checkout does not stop and it does not tax at zero — it falls back to the rate table you authored. A provider outage therefore shows up as slightly different tax, not as a failed checkout and not as an obvious alarm. If your own table is stale, the outage is the day it starts being charged to customers.

Keep the fallback table current even after you connect a provider. It is not a leftover.

The pair of addresses is the whole calculation

Section titled “The pair of addresses is the whole calculation”

Sales tax is a function of two addresses: where the goods ship from, and where they ship to. The buyer supplies the second. You supply the first, once, as the place of business on this screen.

  • The origin is an address, not a country code. A United States origin also needs a state — TaxJar refuses a US origin without one, so an origin saved without it produces a provider that looks connected and answers nothing.
  • If you ship from more than one place, the origin recorded here is the one every quote is computed from. That is a real limitation to know before you rely on the number.

The API token you paste is stored encrypted and never shown again. When you come back to the screen the field is blank with a note that a token is saved; leaving it blank keeps the stored one, and typing a new value replaces it.

This has one practical consequence worth planning for: you cannot read your token back out of CIQRA. Keep it wherever you keep your other credentials. If it is lost, it is regenerated at the provider, not recovered here.

Removing a credential deletes the token and the address rather than switching them off. There is no “disconnect but keep the key” state — reconnecting means pasting a new token.

Sandbox and live are two switches, not one

Section titled “Sandbox and live are two switches, not one”

Two independent toggles govern a provider:

Switch What it decides
Use this provider at checkout Whether real orders are taxed by it at all. Off, the provider is connected but idle.
Sandbox mode Whether it talks to the provider’s test environment instead of live calculation.

A provider can be connected, enabled, and still in sandbox — which is exactly the state you want while you are checking that the numbers look right, and exactly the state you must remember to leave. The screen shows the combination as a status, so read the badge rather than assuming from the toggles.

  • It does not name which providers are available to you. That list is what the screen loads; it depends on your plan and region rather than on this article, and an article that named them would go false the first time the list changed.
  • It does not tell you whether a provider’s answer is correct for your business. CIQRA can show you what the provider returned and when it last failed. Whether that figure satisfies your obligations is a question for your accountant, and no software should answer it for you.
  • It does not cover authoring your own rates. That is the Taxes screen, and it remains the fallback for every order this screen cannot price.