TaxJar Integration
Connect TaxJar to calculate sales tax in real time at checkout, and to record each order so your filings reconcile against what you actually charged.
Features
| Feature | Description |
|---|---|
| Real-time calculation | Tax calculated at checkout from the shipping destination |
| Transaction recording | Completed orders committed to TaxJar for reporting |
| Refunds | Refunds sent to TaxJar so filings stay accurate |
| Voids | Voided orders removed from TaxJar |
| Sandbox mode | Test against TaxJar’s sandbox before going live |
TaxJar is one of two tax providers FirearmCart supports. Only one can be active at a time — activating a second tax plugin is refused until the first is deactivated. See Avalara for the alternative, and Taxes for the built-in manual tax zones if you do not need a provider.
No separate settings page. Unlike Avalara, TaxJar has no entry in the sidebar. Everything — credentials, settings and the API activity log — lives in the Configure modal on the TaxJar card in the marketplace.
Prerequisites
Before connecting, you need:
- An active TaxJar account
- Your TaxJar API key
- Nexus configured in TaxJar for the states you collect in
Setting Up
- Navigate to Plugins > Marketplace
- Find TaxJar
- Click Activate
- Enter your API Key
- Tick or clear Enable Sandbox Mode
- Optionally click Test Connection to verify, then click Activate Plugin
Your credentials are verified against TaxJar before the plugin activates — if they fail, activation is blocked and the error appears under the API Key field.
Sandbox mode points at TaxJar’s sandbox environment (api.sandbox.taxjar.com) instead of production. Use it to verify the connection and calculations without recording real transactions, then turn it off before taking live orders.
How Tax Is Calculated
At checkout, FirearmCart sends the order’s origin and destination addresses and its line items to TaxJar, which returns the tax due. That amount is what the customer is charged.
Shipping, including FFL transfer shipping and the hazmat fee, is sent to TaxJar as shipping rather than as an item, so TaxJar applies each state’s own rules for taxing it. A discount comes off the items it applies to before they’re taxed, and the orders recorded in TaxJar show the same discounted amounts.
Each product can carry a TaxJar product tax code, which tells TaxJar what kind of item it is. Pick it from the Tax Code list on the product page’s Tax Information card; a product without one is taxed as general merchandise. The AI assistant can also set codes, on one product or on many at once, after you confirm how many change.
The origin address comes from your store address in Settings > General — not from TaxJar. The destination is the customer’s shipping address; if it has no state, no calculation is attempted and tax is left at zero.
Your nexus settings live in TaxJar, not in FirearmCart — if tax is not being collected for a state you expect, that is where to check first.
TaxJar does not offer address validation through FirearmCart. The Validate Address button on customer addresses only works with Avalara.
Recording, Refunds and Voids
Orders are recorded in TaxJar once completed, so your TaxJar reports reflect real sales rather than quotes. A post-purchase upsell added to an order is recorded as a transaction of its own, holding just the items it added.
- Refunding an order in FirearmCart posts a matching refund transaction to TaxJar, dated the day of the refund. A partial refund returns the same share of the tax as of the order
- Voiding an order deletes the recorded order transaction from TaxJar rather than posting a reversal, so it disappears from your reports entirely
Because refunds and voids flow through automatically, your TaxJar filings stay in step with your order history without manual reconciliation.
Troubleshooting
TaxJar Is Rejecting Your Credentials
If TaxJar turns down your API key at checkout, the customer can still pay. Checkout charges tax from your manual tax zones instead, or no tax if you have none, and orders placed in the meantime aren’t recorded in TaxJar.
When this happens:
- Settings > Taxation shows TaxJar is rejecting your credentials in place of the TaxJar notice
- Everyone on your team gets the Tax or shipping connection rejected alert, in the dashboard and by email. See Notifications.
To fix it:
- Check that your TaxJar account is active and in good standing
- If your API key changed, click Configure on the TaxJar card under Plugins > Marketplace and enter the new one
- Add any orders placed while the warning was showing to TaxJar yourself, so your filings include them
The warning clears the next time TaxJar calculates tax at checkout.
Connection Fails
- Verify the API key is correct and has not been rotated in TaxJar
- Confirm you are using the right key for the mode you selected — sandbox and production keys are not interchangeable
Tax Is Not Being Collected
- Check Settings > Taxation for a TaxJar is rejecting your credentials warning
- Confirm nexus is configured in TaxJar for the destination state
- Confirm the customer’s shipping address has a state — without one, no calculation is attempted
- Confirm TaxJar is the active tax provider (only one tax plugin can be active at a time)
- Turn on Enable client-side logging in the Configure modal, then check the Activity tab for the failing request
Amounts Do Not Match TaxJar Reports
Check whether the order was refunded or voided after completion. A refund posts a matching refund transaction; a void deletes the original order transaction outright, so a report with no trace of the order is expected.
Related Documentation
- Integrations Overview - All integrations
- Avalara - The alternative tax provider
- Taxes - Manual tax zones
- Refunds - Processing refunds

