Glossary
Stripe Customer Tax Location Status
A Stripe customer’s tax location status is the automatic_tax value on the customer’s tax details, shown as Tax location status in the Dashboard, which says whether Stripe Tax can calculate tax for that customer from the location information on file: supported, not_collecting, unrecognized_location or failed.
Also called: Tax location status, customer.tax.automatic_tax
14-day free trial · card required · cancel anytime
Definition
Stripe Tax needs to know where a customer is before it can work out what to charge them. Every customer record carries a short verdict on that question. In the API it is the automatic_tax field inside the customer’s tax details. In the Dashboard it is labelled Tax location status. Stripe’s API reference describes it as a field that “surfaces if automatic tax computation is possible given the current customer location information.”
There are four values. Supported means the customer is somewhere you collect tax. Not collecting means Stripe recognised the location, but you are not registered to collect there. Unrecognized location means Stripe could not work out where the customer is from the address it has. Failed means Stripe hit an error while checking, which Stripe describes as usually temporary.
The status matters because it predicts the next invoice. A customer marked supported gets tax calculated. A customer marked not collecting gets an invoice with zero tax, on purpose. A customer marked unrecognized location is the one that causes trouble: depending on how the invoice is created, Stripe either finalizes it with no tax at all or refuses to finalize it.
None of this is visible on the invoice itself until it is too late, which is why checking the status before you bill is worth the habit.
Key points
- +The API field is automatic_tax inside the customer’s tax details. The Dashboard calls it Tax location status.
- +The tax details are not returned by default. Retrieve the customer with expand set to tax to see them.
- +Four values: supported, not_collecting, unrecognized_location and failed.
- +Not collecting means a recognised location where you have no active registration. Stripe Tax assesses no tax there.
- +Unrecognized location means the address on file is not good enough to place the customer.
- +Subscription invoices for an unrecognized customer finalize without tax, and automatic tax is switched off on the subscription.
- +One-off invoices for an unrecognized customer stay in draft with the error customer_tax_location_invalid.
The four values, one at a time
Supported. Stripe’s Dashboard shows this as Valid. The customer is located in a country or state where you are collecting tax, and Stripe describes it as “Automatic tax fully supported.” Nothing to do.
Not collecting. The Dashboard shows this as Not registered. Stripe says the address “is recognized and resolved to a location that you haven’t set up a collection location for.” The API reference adds that it is also returned when automatic tax calculation is not supported in the customer’s location. Stripe’s guidance is that the right response depends on your tax obligations: “If you proceed, Stripe Tax doesn’t assess any taxes. If you want it to assess tax, add an active registration for the jurisdiction the customer is based in.”
Unrecognized location. Stripe says “The address isn’t valid for determining a tax location.” The fix is a better address: ask the customer for one, then update the customer’s address in the Dashboard or through the API.
Failed. Stripe describes this as an error on its side, “usually caused by a temporary issue,” and says to retrieve the customer again. Its migration guide calls it rare and suggests contacting support if it persists.
The first two are both healthy states in a sense. Not collecting is not an error. It is Stripe correctly declining to charge tax where you have not told it you are registered. The status to chase is unrecognized location.
Where Stripe gets the location from
Stripe Tax uses a single address as the customer’s location, picked from a fixed order. For invoices and subscriptions on the classic Customer object, Stripe uses the first of these that exists: the customer’s shipping address, then the customer’s billing address, then the billing details of the most specific payment method (the invoice’s default payment method, then the subscription’s, then the customer’s), then the customer’s IP address.
The order has a trap in it. If a shipping or billing address is present but invalid, Stripe does not fall back to the next source. It raises customer_tax_location_invalid instead. So a customer with a half-typed shipping address and a perfect billing address can still be unrecognized, because the shipping address is checked first.
What counts as valid depends on the country. For the United States, Stripe can calculate from a full address or from a country and postal code, but not from a country and state alone, and not from a country alone. For Canada, a country and province is enough. Stripe’s customer locations guide lists the accepted formats country by country.
The resolved result is stored with the customer. The tax location records the country, the state or region where relevant, and the source Stripe used: billing_address, shipping_destination, payment_method or ip_address. If the status looks wrong, the source usually tells you why.
What each status does to the next invoice
Supported is the ordinary case. Stripe Tax calculates tax on the invoice and the tax lines appear on it.
Not collecting produces an invoice with zero tax. That is a correct result, not a failure, and Stripe’s documentation on zero tax amounts lists not being registered as one of the standard reasons a calculation returns nothing.
Unrecognized location behaves differently depending on how the invoice is finalized. For subscription invoices, Stripe says the invoices “continue to finalize automatically but without calculating taxes.” Stripe then sets automatic tax to disabled on the subscription and the invoice, records the disabled reason (finalization_requires_location_inputs on the invoice, requires_location_inputs on the subscription), sends invoice.updated and customer.subscription.updated events, and collects payment as usual. The invoice “won’t contain any tax amounts.” Automatic tax stays off on that subscription until someone turns it back on, so every later renewal goes out untaxed too.
For invoices you finalize yourself, in the Dashboard or through the API, Stripe returns an error with the code customer_tax_location_invalid and leaves the invoice in draft. Standalone invoices that finalize automatically also stay in draft, and Stripe sends an invoice.finalization_failed event with the same code.
So the same bad address produces two opposite symptoms: an invoice that went out quietly without tax, or an invoice that never went out at all.
How to check a customer’s status
In the Dashboard, open the customer on the Customers page and expand their details. The tax location status is shown there.
For a bulk check, export customers from the Customers page with All columns selected. Stripe says the export includes a column named Tax Location Recognized, a true or false flag for whether the customer has a valid address. Filtering that column is the quickest way to find every customer who would be billed without tax.
Through the API, retrieve the customer and expand tax. The response includes the automatic_tax status and the resolved location with its source. For customers on Stripe’s newer Accounts objects, the same information sits in the account’s customer configuration and has to be requested with include.
To stop bad addresses reaching the customer record in the first place, Stripe recommends setting tax validate_location to immediately when you create or update a customer. The default is deferred, which waits until Stripe Tax needs the location, usually at invoice time. With immediately, an invalid address is rejected with customer_tax_location_invalid when you save it, and the customer is not created or updated.
Fixing an unrecognized location after the fact
Stripe’s recovery steps depend on whether you can get a usable address.
If you can, update the customer with the new address, setting tax validate_location to immediately so Stripe checks it straight away, then finalize the draft invoice manually.
If you cannot, Stripe’s instruction is to turn automatic tax off on the invoice and on its subscription, then finalize the invoice manually, which bills it without tax.
Subscriptions that already lost automatic tax need a separate step. Stripe says you can find them by filtering the Subscriptions page by Automatic tax not enabled, and that to switch automatic tax back on you need at least one valid customer location and then reactivate it through the Stripe Tax Dashboard. Stripe describes that reactivation as its own step, so plan for it after the address is fixed.
Invoices that already finalized without tax stay that way. A finalized invoice’s amounts can’t be changed, so the tax that should have been charged on them is a separate decision about what you owe and whether you can collect it.
How the status shows up in QuickBooks with Acodei
Acodei’s Tax feature carries the tax Stripe calculated into QuickBooks. Its documentation says that when a Stripe invoice is finalized or paid, Acodei reads each individual tax line. With the Tax Product approach, generally the workable choice for US QuickBooks companies, the total tax becomes one line on a non-inventory product mapped to a liability account. With QuickBooks Tax Rate mapping, used by non-US companies, each Stripe tax rate is mapped to a QuickBooks tax code. Acodei’s documentation also says that tax tracking from Stripe requires either Stripe Tax, so the rates and amounts can be retrieved, or tax applied afterwards in QuickBooks.
That makes the tax location status visible on the QuickBooks side. Acodei’s Invoice Sync creates a QuickBooks invoice when a Stripe invoice is finalized, reproducing its line items and tax lines as your mapping settings allow. A subscription invoice that finalized without tax because the customer’s location was unrecognized has no tax line to carry, so it reaches QuickBooks with no tax on it, and so do the renewals after it until automatic tax is switched back on in Stripe. The same is true of not collecting invoices, where zero tax is the correct result.
A one-off invoice stuck in draft has not been finalized, which is the point at which Acodei’s documentation says the QuickBooks invoice is created. Once you fix the address and finalize it, Invoice Sync handles it like any other finalized invoice.
Acodei’s guidance is to correct synced records by resyncing from its Data Feed rather than editing them by hand in QuickBooks.
Want to see this on your own Stripe data?
Start a free trial14-day free trial · card required · cancel anytime
Frequently asked questions
What does unrecognized_location mean in Stripe?
It means Stripe Tax could not determine the customer’s tax location from the address information on file. Stripe says the address isn’t valid for determining a tax location. Update the customer with an address in one of Stripe’s supported formats for that country.
What does not_collecting mean on a Stripe customer?
The customer’s address was recognised, but it resolves to a location where you have no active tax registration in Stripe. Stripe Tax assesses no tax for that customer. If you should be collecting there, add the registration in your Stripe Tax settings.
How do I see a customer’s tax location status in Stripe?
In the Dashboard, open the customer and expand their details. Through the API, retrieve the customer with expand set to tax and read the automatic_tax value. For a bulk check, export customers with All columns and use the Tax Location Recognized column.
Why did a Stripe subscription invoice go out without tax?
A common cause is an unrecognized customer location. Stripe finalizes subscription invoices without calculating tax in that case and switches automatic tax off on the subscription, so later renewals are untaxed too until you fix the address and reactivate automatic tax.
How do I stop invalid customer addresses in Stripe?
Set tax validate_location to immediately when creating or updating customers. Stripe then rejects an invalid address with customer_tax_location_invalid at the time you save it, instead of discovering the problem when an invoice is finalized.
What customers say about running Stripe through Acodei

“If you're testing out all the different Stripe/QuickBooks integration apps right now, let me save you some time. This one is the best one by far.”
“Works well and is really helpful for massive transactions. The support is really fast and helpful. 100% recommended.”
Related reading
- Stripe Tax
- Stripe taxability reason
- Stripe tax registration
- Stripe invoice status
- Stripe invoice finalization failed because of tax
- Stripe Tax for existing subscriptions and QuickBooks
More glossary terms
- Undeposited Funds
- Stripe Balance Transaction
- Available vs Pending Balance
- Stripe Dispute
- Stripe Dispute Evidence
- Stripe Fee
- Stripe Balance Adjustment
- QuickBooks Credit Memo
- Stripe Tax
- QuickBooks Tax Code
- Stripe Reserve
- Stripe Tax Rate
- Stripe Fee Credit
- Stripe Credit Note
- QuickBooks Product/Service Item
- Stripe Payout
- QuickBooks Sales Receipt
- QuickBooks Bank Deposit
- QuickBooks Transfer
- Stripe Authorization Hold
- QuickBooks Refund Receipt
- QuickBooks Payment
- QuickBooks Expense
- QuickBooks Journal Entry
- Stripe Financial Account
- Holding Account
- Accounts Receivable
- Bank Feed
- Deferred Revenue
- Stripe PaymentIntent
- Stripe Checkout Session
- Stripe SetupIntent
- Stripe PaymentMethod
- Stripe Charge
- Stripe Refund
- QuickBooks Invoice
- QuickBooks Class Tracking
- QuickBooks Location Tracking
- QuickBooks Project
- QuickBooks Closing Date
- Stripe Invoice Line Item
- Stripe Proration
- Stripe Invoice Status
- Stripe Shipping Rate
- Stripe Transfer
- Stripe Mandate
- Stripe on_behalf_of
- Stripe Invoice Item
- QuickBooks Estimate
- Stripe Invoice Payment
- Stripe Invoice Payment Settings
- Stripe Billing Meter
- Stripe Invoice Template
- Stripe Price
- Stripe Subscription Schedule
- Stripe Subscription Item
- QuickBooks Recurring Transaction
- QuickBooks Sub-Customer
- QuickBooks Audit Log
- QuickBooks Bank Rule
- Stripe Subscription Status
- Stripe Mixed Interval Subscription
- Stripe Trial Settings
- QuickBooks Payment Terms
- Stripe Pending Update
- QuickBooks Tags
- QuickBooks Credit Card Credit
- QuickBooks Vendor Credit
- QuickBooks Bill
- QuickBooks Delayed Charge
- Stripe Billing Mode
- QuickBooks Billable Expense
- Stripe Customer Cash Balance
- QuickBooks Purchase Order
- QuickBooks Opening Balance
- QuickBooks Account Type
- QuickBooks Sales Tax Center
- Stripe Webhook
- Stripe Metadata
- Stripe Outbound Payment
- Stripe Received Credit
- Stripe Outbound Transfer
- Stripe Inbound Transfer
- Stripe Received Debit
- Stripe Payout Method
- Stripe Financial Account Transaction
- Stripe Financial Address
- Stripe Application Fee
- Stripe Connected Account
- Stripe Destination Charge
- Stripe Separate Charges and Transfers
- Stripe Direct Charge
- Stripe Payment Method Configuration
- Stripe Dynamic Payment Methods
- Stripe Payment Method Rules
- QuickBooks Bundle
- Stripe Account Capability
- Stripe Merchant of Record
- Stripe Data Pipeline
- Settlement Currency
- Hosted Invoice Page
- Stripe Customer
- Stripe Product
- QuickBooks Home Currency
- QuickBooks Exchange Gain or Loss
- QuickBooks Trial Balance
- QuickBooks General Ledger Report
- QuickBooks Retained Earnings
- QuickBooks Profit and Loss Report
- QuickBooks Balance Sheet Report
- QuickBooks Account Register
- QuickBooks Reclassify Transactions
- QuickBooks A/R Aging Report
- QuickBooks Sales Tax Liability Report
- QuickBooks Sales Tax Payable
- Stripe Tax Transaction
- Stripe Tax Location Report
- Stripe Tax Summarized Export
- Stripe Tax Itemized Export
- Stripe Product Tax Code
- QuickBooks Vendor
- Economic Nexus
- Reverse Charge
- Stripe Statement Descriptor
- Stripe Taxability Reason
- Stripe Tax Filing Currency
- Stripe Tax Cross-Border Goods Option
- Stripe Tax Threshold Monitoring
- QuickBooks Uncategorized Income
- QuickBooks Sales by Product/Service Report
- QuickBooks Sales by Customer Report
- QuickBooks Group Tax Rate
- Form 1099-NEC
- SEPA Direct Debit
- Bacs Direct Debit
- Canadian Pre-Authorized Debit (PAD)
- Australia BECS Direct Debit
- Stripe PayTo
- Stripe Test Clock
- QuickBooks Customer Display Name
- Backup Withholding
- QuickBooks Multicurrency
- Form 1042-S
- Form W-8BEN
- Form W-9
- Form 8233
- Form 1042
- Form 1099-K
- Form W-8BEN-E
- Stripe Tax Behavior
- Stripe Customer Tax ID
- Form 945
- ITIN (Individual Taxpayer Identification Number)
- Form 1099-MISC
- Stripe Customer Tax Exempt Status
- EFTPS (Electronic Federal Tax Payment System)
- Tax Representative (Fiscal Representative)
- Nil Return
- Sales Tax Exemption Certificate
- EU One Stop Shop (OSS)
- Place of Supply
- Simplified Tax Invoice
- Input VAT (Input Tax)
- Streamlined Sales Tax (SST)
- Fixed Establishment (VAT)
- VIES VAT Number Validation
- E-Invoicing Mandate
- Tax Point (Time of Supply)
- Sales Tax Holiday
- Digital Services Tax
- VAT Invoice (Full Tax Invoice)
- Output VAT (Output Tax)
- VAT Bad Debt Relief
- Sales Tax Sourcing
- Gross Receipts Tax
- VAT Cash Accounting Scheme
- Reduced VAT Rate
- VAT Flat Rate Scheme (UK)
- VAT Annual Accounting Scheme (UK)
- EU VAT SME Scheme
- Making Tax Digital for VAT
- VAT Payments on Account (UK)
- Stripe Tax Registration
- Non-Established Taxable Person (NETP)
- VAT Group Registration (UK)
- Zero-Rated vs Exempt Supply
- Electronically Supplied Services (ESS)
- Zero-Decimal Currency
- UK VAT Registration Threshold
- QuickBooks Deposit Detail Report
- Payment Settlement Entity (PSE)
- QuickBooks Reconcile
- QuickBooks Bad Debt Write-Off
- Stripe Radar
- Stripe Smart Retries
- Stripe Decline Code
- QuickBooks Voided Transaction
- Stripe Minimum Charge Amount
- Stripe 3D Secure
- Stripe Preview Invoice
- Stripe Quantity Transformation (transform_quantity)
- Stripe Customer-Chosen Price (custom_unit_amount)
- Stripe Adjustable Quantity (adjustable_quantity)
- Stripe Inline Price (price_data)
- Stripe Default Payment Method
- Stripe Multi-Currency Price
- QuickBooks Automatic Application
- QuickBooks Open Invoices Report
- QuickBooks Customer Balance Detail Report
Ready to try Acodei?
Connect Stripe to QuickBooks Online in minutes and let the fees, refunds, and payouts land where your accountant expects them.
14-day free trial · card required · cancel anytime