Collect taxesBeta

Activate Stripe Tax in the Stripe Dashboard.

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 behavior 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 behavior

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

• 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 behavior.