Tax ID ElementVersion bêta publique
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.
Remarque
The Tax ID Element is only available when using Elements with the Checkout Sessions API.
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.
For instance, choose the “flat” theme and override the primary text style.
const stripe = Stripe(); const appearance = { theme: 'flat', variables: { colorPrimaryText: '#262626' } }; const elementsOptions = { appearance }; const checkout = stripe.initCheckout({ clientSecret, elementsOptions });'pk_test_TYooMQauvdEDq54NiTphI7jx'
For more information about using the Tax ID Element, see the integration guide.