Specify tax codes and behavior on rate cardsPrivate preview

Tax codes

Stripe Tax uses product tax codes to associate rate card rates 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 rate card rate 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 in your tax settings.

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

Set a tax code on a rate card (recommended)

Dashboard

API

When you create rate cards 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 Rate cards page. Select your rate card.
2. Click Edit rate card.
3. Select the item you want to change the product tax code.
4. Expand Advanced settings for your item, and specify a Product tax code.
   • Click Save.

Tax behavior

To determine how tax is presented to the buyer, you must specify either a tax_behavior on a rate card or a default tax behavior in your tax settings in the Dashboard. 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 tax behavior 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.

Set a default tax behavior (recommended)

You can define a default tax behavior that applies to every rate card (that has no tax behavior defined otherwise). Set up the default tax behavior in the Stripe Tax settings under the Include tax in prices section.

Rate cards that don’t otherwise have the tax_behavior defined use the default tax behavior. The options for the default tax behavior are:

• Automatic: The tax behavior is based on the currency that’s chosen for a rate card. 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 USD. The final price the customer pays is 5 USD.
• Exclusive: Exclusive tax is added on top of the price. For example, a product has the price defined as 5 USD. The tax charged on this product could be 10% and would result in a final price of 5.5 USD. (Tax rates might differ—this is only an explanatory example.)

Override default tax behavior on a rate card

To override this setting for an individual rate card:

curl -X POST https://api.stripe.com/v2/billing/rate_cards \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-03-31.preview" \
  --json '{
    "display_name": "Alpaca AI",
    "service_interval": "month",
    "service_interval_count": 1,
    "currency": "usd",
    "tax_behavior": "exclusive"
  }'