Tax ID ElementPublic preview

The Tax ID Element is an embeddable UI component that collects customer tax ID information. For details about how to enable the Tax ID Element, see the integration guide.

If you don’t see the demo, try viewing this page in a supported browser.

Supported regions

The Tax ID Element supports tax ID collection in the following countries and regions. When using auto mode, the element automatically displays only for customers in these supported locations. Each region has specific tax ID types and format requirements.

When you use the Tax ID Element and the Address Element together, Stripe automatically determines the tax ID type and element visibility based on the customer’s address. This ensures the correct tax ID format is displayed for the customer’s location.

Visibility of the Tax ID Element

You can collect Tax IDs for a number of reasons but the most common reasons are to help calculate sales tax or to display on invoices.

The Tax ID Element adapts to the location of a customer by default, and it only shows if tax ID collection is common in their country. To determine if the tax ID is relevant, the Tax ID Element checks the customer’s IP address and country from the Address Element (in either shipping or billing mode). If the Address Element isn’t present, we use the customer’s IP address. If you want to make sure that you always show the Tax ID Element (even for countries that don’t typically collect tax IDs), you can set the visibility to always.

Create a Tax ID Element

Here’s how you can use the Stripe Tax ID Element to collect tax IDs:

<div class="tax-id-form">
  <div id="tax-id-element"></div>
</div>

const stripe = window.Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: [
    'custom_checkout_tax_id_1',
  ],
});
const appearance = { /* appearance */ };
const elementsOptions = { appearance };

const clientSecret = fetch('/create-checkout-session', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
  })
    .then((res) => res.json())
    .then((res) => {
      return res.clientSecret;
    });

const checkout = stripe.initCheckout({
  clientSecret,
  elementsOptions
});

const taxIdElementOptions = {
  visibility: 'always',
};
const taxIdElement = checkout.createTaxIdElement(taxIdElementOptions);
taxIdElement.mount('#tax-id-element');

For more information about using the Tax ID Element, see the integration guide.