Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseUse Managed Payments
Use Payment Links
Use a prebuilt checkout page
Build a custom integration with Elements
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
    Overview
    Payment Element
    Express Checkout Element
    Address Element
    Currency Selector Element
    Link Authentication Element
    Payment Method Messaging Element
    Tax ID Element
In-app Payments
Payment scenarios
Handle multiple currencies
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
Beyond payments
Incorporate your company
Crypto
Agentic commerce
Financial Connections
Climate
Understand fraud
Radar fraud protection
Manage disputes
Verify identities
HomePaymentsWeb Elements

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

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

Theme
Size
Customer Location
Visibility

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

OptionDescription
ThemeUse the dropdown to choose a theme or customize the theme with the Elements Appearance API.
Desktop and mobile sizeUse 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 locationUse 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.
VisibilityUse the dropdown to choose a visibility mode. In auto mode, the Tax ID Element only displays for countries that support tax ID collection.
Business nameEnable 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

Aruba
Bahamas
Barbados
Canada
Costa Rica
Mexico

South America

Chile
Ecuador
Peru
Suriname
Uruguay

Europe

Albania
Armenia
Austria
Azerbaijan
Belarus
Belgium
Bosnia & Herzegovina
Bulgaria
Croatia
Cyprus
Czech Republic
Denmark
Estonia
Finland
France
Georgia
Germany
Greece
Hungary
Iceland
Ireland
Italy
Latvia
Liechtenstein
Lithuania
Luxembourg
Malta
Moldova
Montenegro
Netherlands
North Macedonia
Norway
Poland
Portugal
Romania
Russia
Serbia
Slovakia
Slovenia
Spain
Sweden
Switzerland
Ukraine
United Kingdom

Asia

Bahrain
Bangladesh
Cambodia
India
Kazakhstan
Kyrgyzstan
Laos
Nepal
Oman
Philippines
Saudi Arabia
Singapore
South Korea
Taiwan
Tajikistan
Thailand
Turkey
United Arab Emirates
Uzbekistan

Oceania

Australia
New Zealand

Africa

Angola
Benin
Burkina Faso
Cameroon
Cape Verde
Congo - Kinshasa
Egypt
Ethiopia
Guinea
Kenya
Mauritania
Morocco
Nigeria
Senegal
South Africa
Tanzania
Uganda
Zambia
Zimbabwe

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 = stripe.initCheckout({ clientSecret, elementsOptions });

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

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc