Specify product tax codes and tax behavior

Stripe Tax uses product tax codes (PTCs) to associate products 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 product 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 activating Stripe Tax you can set two types of preset tax codes: one for products and one for shipping. You can set both in the Tax settings in the Dashboard.

The tax settings showing the preset tax codes, and the default shipping tax code.

Preset product tax code

The preset product tax code represents your product or service in Stripe Tax. We use the preset if you don’t explicitly specify a tax_code on your products or in product_data on your transactions. As you process payments, we also use the preset tax code to display the tax thresholds you might be approaching or have exceeded, under the Threshold monitoring section in your tax settings.

If you sell multiple different product types (for example, SaaS and e-books), you could use test mode to change your preset tax code and review the impact of different product types on the Monitor tab.

Preset shipping tax code

The preset shipping tax code represents the tax treatment for shipping fees when charged. We use this if you don’t explicitly specify a tax_code on a shipping rate. Stripe Tax allows you to change the default shipping treatment to Nontaxable if you don’t want to charge any tax on shipping fees. We recommend you leave the default as “Shipping” to ensure the correct tax is always charged.

To charge tax on shipping for recurring payments, you can create a Product or pass product_data for a line item called “shipping” and select the shipping tax_code.

The taxability of shipping can vary by US state and country.

Tax behavior

You must specify a tax_behavior on a price, or a default tax behavior in the tax settings in the Dashboard, which determines how tax is presented to the buyer. This allows you to localize your checkout depending on 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 set to inclusive, the amount your buyer pays never changes, even if the tax rate varies. This is common practice for B2C buyers in many markets outside the US.

Setting a default tax behavior (recommended)

You can define a default tax behavior that applies to every price that has no tax behavior defined. You can setup the default tax behavior in the Stripe Tax settings under the Include tax in prices section.

After you set the default tax behavior, all prices that don’t have a tax_behavior defined, use this setting and are ready for Stripe Tax. The options for the default tax behavior are:

• Automatic: The tax behavior is based on the currency that’s chosen for a product price. For the currencies USD and CAD the tax behavior is exclusive. For all other currencies the tax behavior is inclusive. This also works with multi-currency Prices.
• Inclusive: Inclusive tax is already included in the price. For example, a product has the price defined as 5.00 USD. The final price the customer pays is 5.00 USD.
• Exclusive: Exclusive tax is added on top of the price. For example, a product has the price defined as 5.00 USD. The tax charged on this product could be 10% and would result in a final price of 5.50 USD. (Tax rates might differ—this is only an explanatory example.)

To override this setting for an individual price, set a tax behavior on a price.

Setting tax behavior on a price (optional)

You can set the tax behavior for a Price when creating it with the Dashboard or the API. When creating a Price in the Dashboard, you can inspect the impact of your pricing model on your revenue.

To create a Price with tax_behavior through the API, it might look like this:

curl https://api.stripe.com/v1/prices \
 -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
 -d unit_amount=10000 \
 -d currency=usd \
 -d product=prod_q23fxaHasd \
 -d tax_behavior=exclusive \
 -d "recurring[interval]"=month

For a multi-currency Price, use the currency_options.<currency>.tax_behavior parameter to set different tax behaviors for different currencies.

In some cases, you might want to use a custom price that hasn’t been pre-configured. You can pass in price_data instead of a price ID. For example, accepting a one time payment for a custom price might look like this:

curl https://api.stripe.com/v1/checkout/sessions \
 -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
 -d success_url="https://example.com/success" \
 -d cancel_url="https://example.com/cancel" \
 -d "payment_method_types[0]"=card \
 -d "line_items[0][price_data][currency]"="usd" \
 -d "line_items[0][price_data][unit_amount]"=10000 \
 -d "line_items[0][price_data][tax_behavior]"="exclusive" \
 -d "line_items[0][price_data][product]"="prod_Jb3wOhvaIOZZTM" \
 -d "line_items[0][quantity]"=2 \
 -d mode=payment

Setting a tax code on a product (recommended)

When creating Products 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 on the Dashboard. 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.

To create a Product with tax_code using the API, it might look like this:

curl https://api.stripe.com/v1/products \
 -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
 -d name="Test Product" \
 -d tax_code=
txcd_10000000

In some cases, you might want to use a custom product that hasn’t been pre-configured. You can pass in product_data instead of a product ID. For example, accepting a one time payment for a custom product might look like this:

curl https://api.stripe.com/v1/checkout/sessions \
 -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
 -d success_url="https://example.com/success" \
 -d cancel_url="https://example.com/cancel" \
 -d "payment_method_types[0]"=card \
 -d "line_items[0][price_data][currency]"="usd" \
 -d "line_items[0][price_data][unit_amount]"=10000 \
 -d "line_items[0][price_data][tax_behavior]"="exclusive" \
 -d "line_items[0][price_data][product_data][name]"="Product name" \
 -d "line_items[0][price_data][product_data][tax_code]"=
txcd_10000000 \
 -d "line_items[0][quantity]"=2 \
 -d mode=payment

Creating a shipping rate with tax code (optional)

Checkout payment mode allows you to set shipping rates and charge tax on shipping. You can automatically calculate tax on shipping charges by setting the tax code on the shipping rate in the Dashboard or API.

curl https://api.stripe.com/v1/shipping_rates \
 -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
 -d display_name="Ground shipping" \
 -d type="fixed_amount" \
 -d "fixed_amount[amount]"=500 \
 -d "fixed_amount[currency]"=usd \
 -d tax_behavior="inclusive" \
 -d tax_code="txcd_92010001"