Private preview

Specify tax codes and behavior on pricing plans Private preview

Add tax codes and tax behavior on pricing plans to automatically calculate tax.

Note

This page describes basic usage-based billing with Billing Meters. Unless you’re maintaining an existing Billing Meters integration, use Metronome, Stripe’s primary usage-based billing platform, which handles real-time metering, flexible pricing models, prepaid credits, enterprise contracts, and automated invoice generation. Compare your options to decide which approach fits your use case.

Tax codes

Stripe Tax uses product tax codes to associate pricing plan components with their applicable tax rates, which might be lower or higher in different cities or countries. Assign each of your products a tax code to automatically apply the rate and other taxability rules.

If a pricing plan component doesn’t fit any of the specific codes, use one of the codes with “General” in its name to apply the standard rate of the jurisdiction. See our list of available tax codes.

Preset tax codes

When you activate Stripe Tax you can set the preset tax code in the Tax settings in the Dashboard. We use the preset if you don’t explicitly specify a tax_code on your rate card. As you process payments, we also use the preset tax code to display the tax thresholds you might be approaching or have exceeded, in the Threshold monitoring section of your tax settings.

Set a tax code on a pricing plans

When you create pricing plans in the Dashboard you can set your tax code in the dropdown by searching for any available tax code. If you don’t, Stripe Tax uses the preset tax code defined in your Tax Settings. If a product could fit multiple codes, for example, a SaaS product used for personal or business use depending on the type of customer, we recommend creating two separate products in Stripe and assigning the appropriate code to each.

1. Go to the Pricing plans page and select your pricing plan.
2. Click Edit pricing plan .
3. Select the item you want to change the product tax code for.
4. Expand Advanced settings for your item, and specify a Product tax code .

• Click Save .

Turn on automatic tax on a pricing plan

To turn on automatic tax on your pricing plans, you need to configure your Billing Settings:

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

Command Line

cURL

Tax behavior

To determine how you present tax to the customer, you must specify either a tax_behavior on a pricing plan or a default tax behavior in your tax settings in the Dashboard. This allows you to localize your checkout to the market. When you set tax behavior to exclusive, it adds tax onto the subtotal amount you specify on your price. This is common in US markets and for B2B sales. When you set tax behavior to inclusive, the amount your customer pays never changes, even if the tax rate varies. This is common practice for B2C customers in many markets outside the US.

Set a default tax behavior

You can define a default tax behavior that applies to every pricing plan. Set up the default tax behavior in the Stripe Tax settings under the Include tax in prices section.