Tax ID ElementPublic preview

Collect business tax IDs for invoices and VAT refunds.

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.

Note

Tax ID Element is only available when using Elements with the Checkout Sessions API.

Theme

Size

Customer Location

Visibility

Business name

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

Option	Description
Theme	Use the dropdown to choose a theme or customize the theme with the Elements Appearance API.
Desktop and mobile size	Use the dropdown to set the max pixel width of the parent element that the Tax ID Element is mounted to. You can set it to 750px (desktop) or 320px (mobile).
Customer location	Use the dropdown to choose a location for collecting tax ID information. Changing the location updates the tax ID type and format requirements, and controls element visibility in auto mode.
Visibility	Use the dropdown to choose a visibility mode. In auto mode, the Tax ID Element only displays for countries that support tax ID collection.
Business name	Enable this option to collect the business name. The collected business name appears as the customer name on invoices.

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.

North America

South America

Europe

Asia

Oceania

Africa

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.

Appearance

Use the Appearance API to control the style of all elements. Choose a theme, or update specific details.

Currency Selector toggle UI showing three variations of EU (€625.51) and US ($665.00) buttons with labeled design elements.

For instance, choose the “flat” theme and override the primary text style.

const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'
);

const appearance = {
  theme: 'flat',
  variables: { colorPrimaryText: '#262626' }
};
const elementsOptions = { appearance };
const checkout = await stripe.initCheckout({
  fetchClientSecret,
  elementsOptions
});

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