How do I connect TaxJar to report sales tax on completed orders?
Send every completed order's collected tax to TaxJar for filing. TaxJar reports what Stripe Tax already collected — it doesn't calculate tax at checkout.
TaxJar keeps your sales-tax filings accurate by receiving a copy of every completed order — the buyer's destination, the order amount, shipping, and the tax that was already collected. It's a reporting connector, not a tax calculator: Stripe Tax still computes and collects tax at checkout.
Installing the plugin and the general troubleshooting checklist are shared by every integration and covered in the shared integrations guide. This article stays with TaxJar's own settings and rules.
Step 1 — Get your TaxJar API token
Log in to TaxJar, open Account → SmartCalcs API, and copy your API token.
Step 2 — Fill in the TaxJar panel
Open Admin → Plugins → TaxJar and paste the API token. Then enter your nexus / ship-from address, the place TaxJar treats as the origin of your sales: street address, city, state or region, ZIP or postal code, and a two-letter country code. Only the ZIP and country are required for the address to be sent along with each order. You can also set a default product tax code, which is applied to any line item that doesn't carry its own; TaxJar lists the codes under Product Tax Codes.
Finally, switch on Enable TaxJar and click Save Settings. The toggle starts off, and while it is off no order is sent. Test Connection checks the settings you last saved, so save first. It asks TaxJar for a zero-amount tax estimate between your nexus address and itself; nothing is filed.
Treat your TaxJar API token like a password. VeloCMS stores it encrypted, never displays it back to you in full, and never logs it.
What gets sent for each order
- The VeloCMS order ID, used as the TaxJar transaction ID, and the order date.
- The amount before tax, the shipping charge and the sales tax that was collected.
- The buyer's shipping address as the destination, and your nexus address as the origin when its ZIP and country are filled in.
- Every line item with its name, SKU, quantity and unit price, plus your default product tax code when you set one.
When an order is not sent
Some orders are deliberately left out rather than filed with a guess. An order with no shipping address that has both a country and a postal code, which is typical for digital-only purchases, has no destination to file, so it is skipped quietly. If Stripe Tax is switched on but the tax it collected was not recorded on a particular order, that order is marked Skipped with the reason and you will see the note on the order, because filing a made-up tax figure would be worse than filing nothing. If Stripe Tax is off and no tax was recorded, the order is filed with zero sales tax.
Sending an order twice is harmless. TaxJar treats the transaction ID as unique and rejects a repeat, and VeloCMS reads that rejection as already filed rather than as an error. Real failures, such as a rejected token, are listed under Admin → Integrations → Sync activity.
TaxJar does not decide how much tax a buyer pays at checkout — that's Stripe Tax's job, if you have it enabled. This connector only reports what was already collected, so your TaxJar transaction history matches your real sales.
Turning it off
Switch Enable TaxJar off in the same panel to stop sending orders. Existing transactions already sent to TaxJar are not deleted.