Sign in
Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Overview
Customers
Customer credit balance
Customer tax IDs
Products and Prices
Invoice customers
How invoicing works
Create an invoice
Integrate with Invoicing
Customize invoices
Hosted invoice page
Additional features
Testing
invoicing
·
HomePaymentsInvoicingCustomers

Customer tax IDs

Storing, validating, and rendering customer tax ID numbers with Stripe Invoicing.

Missing Tax ID support?

Need another tax ID type? Request additional tax ID types by emailing support@stripe.com.

Displaying a customer’s tax ID on invoice documents is a common requirement.

With Stripe, you can add multiple tax IDs to a customer. They display in the header of invoice and credit note PDFs.

Supported tax ID types

Stripe Invoicing supports the following tax ID types in the following regions:

CountryEnumDescriptionExample
United Arab Emiratesae_trnUnited Arab Emirates TRN123456789012345
Australiaau_abnAustralian Business Number (AU ABN)12345678912
Brazilbr_cnpjBrazilian CNPJ number01.234.456/5432-10
Brazilbr_cpfBrazilian CPF number123.456.789-87
Canadaca_bnCanadian BN123456789
Canadaca_qstCanadian QST number1234567890TQ1234
Switzerlandch_vatSwitzerland VAT numberCHE-123.456.789 MWST
Chilecl_tinChilean TIN12.345.678-K
Spaines_cifSpanish CIF numberA12345678
Austriaeu_vatEuropean VAT numberATU12345678
Belgiumeu_vatEuropean VAT numberBE0123456789
Bulgariaeu_vatEuropean VAT numberBG0123456789
Cypruseu_vatEuropean VAT numberCY12345678Z
Czech Republiceu_vatEuropean VAT numberCZ1234567890
Germanyeu_vatEuropean VAT numberDE123456789
Denmarkeu_vatEuropean VAT numberDK12345678
Estoniaeu_vatEuropean VAT numberEE123456789
Spaineu_vatEuropean VAT numberESA1234567Z
Finlandeu_vatEuropean VAT numberFI12345678
Franceeu_vatEuropean VAT numberFRAB123456789
Greeceeu_vatEuropean VAT numberEL123456789
Croatiaeu_vatEuropean VAT numberHR12345678912
Hungaryeu_vatEuropean VAT numberHU12345678912
Irelandeu_vatEuropean VAT numberIE1234567AB
Italyeu_vatEuropean VAT numberIT12345678912
Lithuaniaeu_vatEuropean VAT numberLT123456789123
Luxembourgeu_vatEuropean VAT numberLU12345678
Latviaeu_vatEuropean VAT numberLV12345678912
Maltaeu_vatEuropean VAT numberMT12345678
Netherlandseu_vatEuropean VAT numberNL123456789B12
Polandeu_vatEuropean VAT numberPL1234567890
Portugaleu_vatEuropean VAT numberPT123456789
Romaniaeu_vatEuropean VAT numberRO1234567891
Swedeneu_vatEuropean VAT numberSE123456789123
Sloveniaeu_vatEuropean VAT numberSI12345678
Slovakiaeu_vatEuropean VAT numberSK1234567891
United Kingdomeu_vatNorthern Ireland VAT numberXI123456789
United Kingdomgb_vatUnited Kingdom VAT numberGB123456789
Hong Konghk_brHong Kong BR number12345678
Indonesiaid_npwpIndonesian NPWP number12.345.678.9-012.345
Indiain_gstIndian GST number12ABCDE3456FGZH
Japanjp_cnJapanese Corporate Number (*Hōjin Bangō*)1234567891234
Japanjp_rnJapanese Registered Foreign Businesses' Registration Number (*Tōroku Kokugai Jigyōsha no Tōroku Bangō*)12345
Korea, Republic ofkr_brnKorean BRN123-45-67890
Liechtensteinli_uidLiechtensteinian UID numberCHE123456789
Mexicomx_rfcMexican RFC numberABC010203AB9
Malaysiamy_frpMalaysian FRP number12345678
Malaysiamy_itnMalaysian ITNC 1234567890
Malaysiamy_sstMalaysian SST numberA12-3456-78912345
Norwayno_vatNorwegian VAT number123456789MVA
New Zealandnz_gstNew Zealand GST number123456789
Russian Federationru_innRussian INN1234567891
Russian Federationru_kppRussian KPP123456789
Saudi Arabiasa_vatSaudi Arabia VAT123456789012345
Singaporesg_gstSingaporean GSTM12345678X
Singaporesg_uenSingaporean UEN123456789F
Thailandth_vatThai VAT1234567891234
Taiwantw_vatTaiwanese VAT12345678
United Statesus_einUnited States EIN12-3456789
South Africaza_vatSouth African VAT number4123456789

Validation

You’re responsible for the accuracy of customer information (including their tax identification number). Stripe displays a customer tax ID on an invoice, regardless of whether or not it’s valid.

Stripe Invoicing provides automatic validation to help determine ​​if the formatting is correct. Stripe also provides automatic validation with government databases for the tax ID types below.

Australian Business Numbers (ABN)

Stripe automatically validates all Australian Business Numbers (ABNs) with the Australian Business Register (ABR).

European Value-Added-Tax (EU VAT) Numbers

Stripe also automatically validates all European Value-Added-Tax (EU VAT) numbers with the European Commission’s VAT Information Exchange System (VIES). This process only validates whether or not the tax ID is valid—you’ll still need to verify the customer’s name and address to make sure it matches the registration information.

VIES validation usually takes only a few seconds but may take longer, depending on the availability of various government databases. Stripe automatically handles VIES downtime and attempts retries for you.

United Kingdom Value-Added-Tax (GB VAT) Numbers

Stripe automatically validates all UK Value-Added-Tax (GB VAT) numbers with the United Kingdom’s Revenue & Customs (HMRC). This process only validates whether or not the tax ID is valid—you’ll still need to verify the customer’s name and address to make sure it matches the registration information.

HMRC validation usually takes only a few seconds but may take longer, depending on the availability of various government databases. Stripe automatically handles HMRC downtime and attempts retries for you.

Validation webhooks and Dashboard display

Because this validation process happens asynchronously, you’re notified of validation updates via the customer.tax_id.updated webhook.

Tax validation tooltip in the Dashboard

Hover over a customer’s EU VAT number to display their VIES information.

You can see the results of the validation in the Dashboard along with other customer information, including details returned from the government databases, and the registered name and address.

​​If automatic validation isn’t available, you should manually verify these IDs.

Managing

You can manage Tax IDs using the Customer page on the Dashboard, or using the Tax ID API.

The Customer detail page and Tax ID field.

Navigate to the Customer page and click Update details in the top of the Details panel.The Update customer invoice details modal opens, with the tax ID section visible.

Clicking Add another ID adds a row to the tax ID list, where you can select the ID type and value.

You can remove a tax ID from a customer by removing the row.

Using the API

You can add or delete tax IDs using the API.

The following example shows how to create a new tax ID on a Customer, storing their VAT number.

Terminal
curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/tax_ids \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "value"="DE123456789" \ -d "type"="eu_vat"

You can delete a Tax ID, as shown in the this example:

Terminal
curl https://api.stripe.com/v1/customers/cus_Euql8T6KrknXwN/tax_ids/txi_123456789 \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -X "DELETE"

To update a tax ID, delete the old ID and create ​​another one.

Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
You can unsubscribe at any time. Read our privacy policy.
On this page
Supported tax ID types
Validation
Managing
Using the API