With Stripe, you can manage tax IDs for both yourself and your customers. Both the account and customer tax IDs display in the header of invoice and credit note PDFs.
Account tax IDs
Displaying your tax IDs on invoice documents is a common regulatory requirement.
With Stripe, you can add up to 10 tax IDs to your account. You can see your tax IDs in the header of invoice and credit note PDFs. You can:
- Select a default tax ID to appear on every invoice and credit note PDF.
- Define a list of tax IDs to appear on a specific invoice.
Managing account tax IDs
You can add and delete tax IDs using the invoice template settings page in the Dashboard. After you add a tax ID in the Dashboard, you can set it as the default tax ID for every invoice and credit note PDF. Tax IDs are immutable—you can’t change the country and ID after you save the tax ID to your account.
To display multiple tax IDs on an invoice, you can use the API or the Invoice Editor to specify which tax IDs to show.
Adding and removing IDs
Visit the invoice template settings page. Scroll down to the Manage tax information section to add a new tax ID or remove an existing tax ID:
Setting a default tax ID
On the invoice template settings page, scroll down to Manage tax information and locate the tax ID you want to set as the default. Click the more (…) menu and select Set as default.
After you set a tax ID as the default, you can see a label in the tax information box:
Displaying multiple tax IDs on invoices
Using the Dashboard
You can set a list of tax IDs in the Dashboard using the Invoice Editor. You can’t modify account tax IDs after an Invoice has been finalized.
In the Invoice Editor, scroll down to the Advanced Options section. Click the checkboxes to toggle which tax IDs to display on that invoice. To remove tax IDs from the invoice, uncheck the boxes.
Using the API
After you add a tax ID to your account, you can use the API to specify up to 10 tax IDs for an individual invoice. You can add account tax IDs when creating a new invoice using the invoice create endpoint by passing a list of object IDs to the
You can remove, change, or add account tax IDs on an existing invoice using the invoice update endpoint by passing a list of object IDs to the
Customer tax IDs
Collecting and displaying a customer’s tax ID on an invoice is a common requirement for B2B sales. With Stripe, you can add up to five tax IDs to a customer. You can see a customer’s tax IDs in the header of invoice and credit note PDFs. You can collect a tax ID with Stripe Checkout, or pass us a tax ID directly.
Supported tax ID types
Currently, Stripe supports the following tax ID types in the following regions:
|Australia||Australian Business Number (AU ABN)||12345678912|
|Australia||Australian Taxation Office Reference Number||123456789123|
|Austria||European VAT number||ATU12345678|
|Belgium||European VAT number||BE0123456789|
|Brazil||Brazilian CNPJ number||01.234.456/5432-10|
|Brazil||Brazilian CPF number||123.456.789-87|
|Bulgaria||European VAT number||BG0123456789|
|Canada||Canadian GST/HST number||123456789RT0002|
|Canada||Canadian PST number (British Columbia)||PST-1234-5678|
|Canada||Canadian PST number (Manitoba)||123456-7|
|Canada||Canadian PST number (Saskatchewan)||1234567|
|Canada||Canadian QST number (Québec)||1234567890TQ1234|
|Croatia||European VAT number||HR12345678912|
|Cyprus||European VAT number||CY12345678Z|
|Czech Republic||European VAT number||CZ1234567890|
|Denmark||European VAT number||DK12345678|
|Estonia||European VAT number||EE123456789|
|Finland||European VAT number||FI12345678|
|France||European VAT number||FRAB123456789|
|Germany||European VAT number||DE123456789|
|Greece||European VAT number||EL123456789|
|Hong Kong||Hong Kong BR number||12345678|
|Hungary||European VAT number||HU12345678912|
|India||Indian GST number||12ABCDE3456FGZH|
|Indonesia||Indonesian NPWP number||12.345.678.9-012.345|
|Ireland||European VAT number||IE1234567AB|
|Italy||European VAT number||IT12345678912|
|Japan||Japanese Corporate Number (*Hōjin Bangō*)||1234567891234|
|Japan||Japanese Registered Foreign Businesses' Registration Number (*Tōroku Kokugai Jigyōsha no Tōroku Bangō*)||12345|
|Korea, Republic of||Korean BRN||123-45-67890|
|Latvia||European VAT number||LV12345678912|
|Liechtenstein||Liechtensteinian UID number||CHE123456789|
|Lithuania||European VAT number||LT123456789123|
|Luxembourg||European VAT number||LU12345678|
|Malaysia||Malaysian FRP number||12345678|
|Malaysia||Malaysian ITN||C 1234567890|
|Malaysia||Malaysian SST number||A12-3456-78912345|
|Malta||European VAT number||MT12345678|
|Mexico||Mexican RFC number||ABC010203AB9|
|Netherlands||European VAT number||NL123456789B12|
|New Zealand||New Zealand GST number||123456789|
|Norway||Norwegian VAT number||123456789MVA|
|Poland||European VAT number||PL1234567890|
|Portugal||European VAT number||PT123456789|
|Romania||European VAT number||RO1234567891|
|Russian Federation||Russian INN||1234567891|
|Russian Federation||Russian KPP||123456789|
|Saudi Arabia||Saudi Arabia VAT||123456789012345|
|Slovakia||European VAT number||SK1234567891|
|Slovenia||European VAT number||SI12345678|
|South Africa||South African VAT number||4123456789|
|Spain||Spanish CIF number||A12345678|
|Spain||European VAT number||ESA1234567Z|
|Sweden||European VAT number||SE123456789123|
|Switzerland||Switzerland VAT number||CHE-123.456.789 MWST|
|United Arab Emirates||United Arab Emirates TRN||123456789012345|
|United Kingdom||United Kingdom VAT number||GB123456789|
|United Kingdom||Northern Ireland VAT number||XI123456789|
|United States||United States EIN||12-3456789|
It’s your responsibility to make sure customer information is accurate (including their tax ID). Stripe displays a customer tax ID on an invoice, whether or not it is valid.
Stripe checks the format of the tax ID against the expected format, and validates the tax ID against the external tax authority system 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 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 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 the external tax authority system… Stripe will automatically handle VIES downtime and attempt 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 verifies that the tax ID is valid—you 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. Stripe automatically handles HMRC downtime and attempts retries for you.
Validation webhooks and Dashboard display
Because this validation process happens asynchronously, the customer.tax_id.updated webhook notifies you of validation updates.
The Dashboard displays the results of the validation while displaying the customer details, including those returned from the government databases and the registered name and address.
When automatic validation isn’t available, you need to manually verify these IDs.
Managing customer tax IDs
You can manage tax IDs in the Customers page on the Dashboard, in the Customer Portal, or with the API.
Using the Dashboard
To add a customer tax ID in the Dashboard, navigate to the Customers 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 the Add tax ID link adds a row to the tax ID list, where you can select the ID type and value. Removing the row removes a tax ID from a customer.
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.
You can delete a tax ID, as shown in the this example:
To update a tax ID, delete the old ID and create another.