Skip to content

Stripe API errorStripe: stripe_tax_inactive

Stripe returns stripe_tax_inactive when code asks Stripe to calculate tax, for example with automatic_tax.enabled=true on an invoice, subscription, payment link or Checkout Session, but Stripe Tax hasn’t been activated on the account the API key belongs to.

Rather hand it over? Stripe Billing Fix and Setup: Subscriptions, webhooks, customer portal and failed payments set up or fixed, tested in Stripe test mode.

Full refund if Simon can’t take it on once he sees your project, or if you cancel before work starts. Refund terms.

Short answer

Open the tax settings page in the Dashboard for the same account the secret key belongs to, click Get started, confirm the head office address, preset tax code and default tax behavior, and add a registration for each place the business is registered to collect tax. Then retry the request with automatic_tax.enabled=true. Existing invoices, subscriptions and payment links need automatic tax turned on one by one.

Rather not fix it yourself? Stripe Billing Fix and Setup handles it at a fixed price, agreed before work starts.

Why Stripe says Stripe Tax is inactive, and the fix

  1. 01

    Stripe Tax was never activated

    “Stripe Tax hasn’t been activated on your account. See the setup documentation to get started.” Stripe, Error codes (stripe_tax_inactive)

    Automatic tax only works after Stripe Tax is activated on the tax settings page. Check that the Dashboard you set it up in is the same account the server’s secret key belongs to.

  2. 02

    The code turns on automatic tax before setup is done

    “If you create invoices, subscriptions, payment links, or Checkout Sessions with the API, set automatic_tax.enabled=true when you create each object.” Stripe, Set up Stripe Tax

    Setting automatic_tax.enabled=true on an invoice, subscription, payment link or Checkout Session asks Stripe Tax to do the math. Finish setup first, or leave the flag off until it is.

    await stripe.checkout.sessions.create({
      // ...line items, mode, success_url
      automatic_tax: { enabled: true }, // needs Stripe Tax activated
    });
  3. 03

    Next step: add tax registrations

    “Before you start collecting tax from your customers, you must register with the local tax authority.” Stripe, Set up Stripe Tax

    Activation clears this error, but tax is only collected where a registration exists. Add one in the Locations tab for each region where the business is registered to collect tax. Without a registration in the customer’s location, the calculation returns zero tax.

  4. 04

    After activating: update existing objects

    “Enabling Stripe Tax doesn’t update your existing invoices, subscriptions, and payment links.” Stripe, Set up Stripe Tax

    Also check: invoices, subscriptions and payment links created before activation keep running without tax until each one is updated with automatic_tax.enabled=true.

Checked against the vendor’s docs on : Stripe docs: Error codes; Stripe docs: Set up Stripe Tax.

Rather hand it over?

Fixed scope, fixed price, paid upfront. The work happens in writing; no call needed.

“Working with Simon makes everything run so smoothly and better than I could ask for it. Amazingly communicative, extremely knowledgeable of coding and the backend processes. I strongly recommend.”
A buyer in the United States, January 2026. App development on Fiverr
All 127 Fiverr reviews

Related: Stripe customer tax location invalid · Stripe tax_id_invalid · Stripe works in test mode but not live · Stripe invoice_no_payment_method_types

Questions

More on this error

Does activating Stripe Tax start charging tax right away?

Only on new transactions created in the Dashboard, and only where a registration exists. Objects created through the API need automatic_tax.enabled=true, and existing invoices, subscriptions and payment links have to be updated one by one.

What about a Connect platform?

Stripe has a separate guide for platforms and marketplaces, Use Stripe Tax with Connect, linked from the Set up Stripe Tax page. See it before setting up Stripe Tax as a platform.

Can you fix it for me?

If one bug is the whole problem, the App Fix Ticket covers it: a written diagnosis first, then the fix. If the app has more going on, the Launch Check is a written check of the whole app. Each issue found is rated critical, high, medium or low, with where it is and how it was confirmed. No issues worth fixing, no charge. If the Launch Check finds nothing rated medium or higher, Simon refunds the full $450. You keep the report either way. This applies to the first 10 Launch Checks bought after October 30, 2026.

A different error?

Describe it and get a written quote

Send the error and what you were doing. You get a written scope, a fixed price and a timeline; Simon replies by email, usually within one business day.