Collect taxes in Checkout

Log in or sign up for Stripe to activate Stripe Tax.

Configure your Stripe Tax registrations in the Stripe Dashboard. You’ll see zero tax amounts for anywhere you’re not registered to collect tax.

Check our tax guide for more information on registrations.

To start collecting tax:

1. Pass automatic_tax[enabled]=true.
2. Specify a tax_code for each line item or set a preset tax code in the Dashboard.
3. Specify a tax_behavior for each line item or set a default tax behaviour in the Dashboard.

const session = await stripe.checkout.sessions.create({
  line_items: [
    {
      price_data: {
        currency: 'usd',
        product_data: {
          name: 'T-shirt',
          tax_code: 'txcd_99999999',
        },
        unit_amount: 2000,
        tax_behavior: 'exclusive',
      },
      quantity: 1,
    },
  ],
  mode: 'payment',
  ui_mode: 'custom',
  return_url: '{{RETURN_URL}}',
  automatic_tax: {enabled: true}
});

Tax codes

Tax codes associate products with tax rates. Choose the tax code that best fits your product from the list of available tax codes. If a product doesn’t fit any of the specific codes, use one of the codes with “General” in its name.

Tax behaviour

The tax behaviour determines how tax is presented to the buyer. There are two options for tax behaviour:

• Exclusive: The product price doesn’t include tax. Tax is added as a separate amount.
• Inclusive: The product price includes any tax amount.

Learn more about tax behaviour.