Collect customer tax IDs with Checkout
Learn how to collect VAT and other customer tax IDs with Checkout.
Displaying a customer’s tax ID and legal business name on invoices is a common requirement that you can satisfy by enabling tax ID collection. This guide assumes that you’ve already integrated Elements with the Checkout Sessions API. If you haven’t completed this integration, see the Accept a payment guide.
Enable Tax ID collectionServer-side
New Customers
To enable tax ID collection for new customers, set tax_id_collection[enabled] to true
when creating a Checkout Session.
Existing customers
Create a Checkout Session with an existing Customer to update the Customer with any tax ID information collected during checkout. The Checkout Session saves the collected business name as the Customer’s name and adds the collected tax ID to customer.tax_ids. Because the collection of a business name can override the Customer’s existing name, you must set customer_update.name to auto
when creating the Checkout Session.
If you don’t have the addresses of your existing customers saved, you can base their location on the billing or shipping address entered during checkout. To use the billing address entered during checkout to assess the customer’s location, set customer_update.address to auto
. Setting customer_update.address to auto
replaces any previously saved addresses on the customer with the address entered during checkout.
If you’re collecting shipping addresses for existing customers, you must base their location on the shipping address entered during checkout by setting customer_update.shipping to auto
. Setting customer_update.shipping to auto
replaces any previously saved shipping addresses on the customer with the shipping address entered during checkout.
This example creates a Session in payment
mode with tax ID collection enabled. For subscriptions, make the same changes with the mode set to subscription
.
Retrieve Customer Tax ID details after a Session
Checkout includes provided tax IDs on the resulting Session object. After each completed Session, Checkout emits a checkout.session.completed event that you can listen for in a webhook endpoint. If you want to retrieve the collected tax ID from the Session object, it’s available under the Session’s customer_details.tax_ids array:
{ "object": { "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y", "object": "checkout.session", ... "customer": "cus_id_of_new_customer", "customer_details": { ... "tax_ids": [ { "type": "eu_vat", "value": "FRAB123456789" } ] }, ... "tax_id_collection": { "enabled": true }, ... } }
Checkout also saves collected tax IDs and business names to the Customer object if one is associated with the Session. A tax ID collected during checkout is accessible under the Customer’s customer.tax_ids array. You can also retrieve all tax IDs saved to a Customer with the Tax IDs resource by specifying the owner.type parameter to customer
and owner.customer to the Customer’s ID. Every new tax ID includes an associated legal business name, which Checkout saves to the Customer’s name property. In doing so, the collected legal business name is always visible on any subscription invoices for that Customer.
Test your integration
In test mode, you can enter any alphanumeric string that is in the correct format of a supported tax ID type (for example, DE123456789
for eu_
). For a full list of example tax IDs you can reference our Customer Tax ID guide. You can also use our test tax IDs to test various verification state flows.
Validation 
Checkout performs checks during the Session to make sure that provided tax IDs are formatted correctly. We don’t verify that provided tax IDs are valid during the Session. You’re responsible for ensuring the validity of customer information collected during Checkout. To help, Stripe automatically performs asynchronous validation against government databases for Australian Business (ABN) numbers, European Value-Added-Tax (EU VAT) numbers, and United Kingdom Value-Added-Tax (GB VAT) numbers. You can read more on the validation we perform, and how to consume the status of those checks in our Customer Tax ID guide.
Supported Tax ID types 
The Checkout Session collects the following tax ID types in the given regions:
Country | Enum | Description | Example |
---|---|---|---|
Albania | al_ | Albania Tax Identification Number | J12345678N |
Angola | ao_ | Angola Tax Identification Number | 5123456789 |
Armenia | am_ | Armenia Tax Identification Number | 02538904 |
Australia | au_ | Australian Business Number (AU ABN) | 12345678912 |
Austria | eu_ | European VAT number | ATU12345678 |
Bahamas | bs_ | Bahamas Tax Identification Number | 123.456.789 |
Bahrain | bh_ | Bahraini VAT Number | 123456789012345 |
Barbados | bb_ | Barbados Tax Identification Number | 1123456789012 |
Belarus | by_ | Belarus TIN Number | 123456789 |
Belgium | eu_ | European VAT number | BE0123456789 |
Bosnia & Herzegovina | ba_ | Bosnia and Herzegovina Tax Identification Number | 123456789012 |
Bulgaria | eu_ | European VAT number | BG0123456789 |
Cambodia | kh_ | Cambodia Tax Identification Number | 1001-123456789 |
Canada | ca_ | Canadian BN | 123456789 |
Canada | ca_ | Canadian GST/HST number | 123456789RT0002 |
Canada | ca_ | Canadian PST number (British Columbia) | PST-1234-5678 |
Canada | ca_ | Canadian PST number (Manitoba) | 123456-7 |
Canada | ca_ | Canadian PST number (Saskatchewan) | 1234567 |
Canada | ca_ | Canadian QST number (Québec) | 1234567890TQ1234 |
Chile | cl_ | Chilean TIN | 12.345.678-K |
Congo - Kinshasa | cd_ | Congo (DR) Tax Identification Number (Número de Identificação Fiscal) | A0123456M |
Costa Rica | cr_ | Costa Rican tax ID | 1-234-567890 |
Croatia | eu_ | European VAT number | HR12345678912 |
Cyprus | eu_ | European VAT number | CY12345678Z |
Czech Republic | eu_ | European VAT number | CZ1234567890 |
Denmark | eu_ | European VAT number | DK12345678 |
Ecuador | ec_ | Ecuadorian RUC number | 1234567890001 |
Egypt | eg_ | Egyptian Tax Identification Number | 123456789 |
Estonia | eu_ | European VAT number | EE123456789 |
Finland | eu_ | European VAT number | FI12345678 |
France | eu_ | European VAT number | FRAB123456789 |
Georgia | ge_ | Georgian VAT | 123456789 |
Germany | eu_ | European VAT number | DE123456789 |
Greece | eu_ | European VAT number | EL123456789 |
Guinea | gn_ | Guinea Tax Identification Number (Número de Identificação Fiscal) | 123456789 |
Hungary | eu_ | European VAT number | HU12345678 |
Iceland | is_ | Icelandic VAT | 123456 |
India | in_ | Indian GST number | 12ABCDE3456FGZH |
Ireland | eu_ | European VAT number | IE1234567AB |
Italy | eu_ | European VAT number | IT12345678912 |
Kazakhstan | kz_ | Kazakhstani Business Identification Number | 123456789012 |
Kenya | ke_ | Kenya Revenue Authority Personal Identification Number | P000111111A |
Latvia | eu_ | European VAT number | LV12345678912 |
Liechtenstein | li_ | Liechtensteinian VAT number | 12345 |
Lithuania | eu_ | European VAT number | LT123456789123 |
Luxembourg | eu_ | European VAT number | LU12345678 |
Malta | eu_ | European VAT number | MT12345678 |
Mauritania | mr_ | Mauritania Tax Identification Number (Número de Identificação Fiscal) | 12345678 |
Mexico | mx_ | Mexican RFC number | ABC010203AB9 |
Moldova | md_ | Moldova VAT Number | 1234567 |
Montenegro | me_ | Montenegro PIB Number | 12345678 |
Morocco | ma_ | Morocco VAT Number | 12345678 |
Nepal | np_ | Nepal PAN Number | 123456789 |
Netherlands | eu_ | European VAT number | NL123456789B12 |
New Zealand | nz_ | New Zealand GST number | 123456789 |
Nigeria | ng_ | Nigerian Tax Identification Number | 12345678-0001 |
North Macedonia | mk_ | North Macedonia VAT Number | MK1234567890123 |
Norway | no_ | Norwegian VAT number | 123456789MVA |
Oman | om_ | Omani VAT Number | OM1234567890 |
Peru | pe_ | Peruvian RUC number | 12345678901 |
Poland | eu_ | European VAT number | PL1234567890 |
Portugal | eu_ | European VAT number | PT123456789 |
Romania | eu_ | European VAT number | RO1234567891 |
Russia | ru_ | Russian INN | 1234567891 |
Russia | ru_ | Russian KPP | 123456789 |
Saudi Arabia | sa_ | Saudi Arabia VAT | 123456789012345 |
Senegal | sn_ | Senegal NINEA Number | 12345672A2 |
Serbia | rs_ | Serbian PIB number | 123456789 |
Singapore | sg_ | Singaporean GST | M12345678X |
Slovakia | eu_ | European VAT number | SK1234567891 |
Slovenia | eu_ | European VAT number | SI12345678 |
South Africa | za_ | South African VAT number | 4123456789 |
South Korea | kr_ | Korean BRN | 123-45-67890 |
Spain | es_ | Spanish NIF number (previously Spanish CIF number) | A12345678 |
Spain | eu_ | European VAT number | ESA1234567Z |
Suriname | sr_ | Suriname FIN Number | 1234567890 |
Sweden | eu_ | European VAT number | SE123456789123 |
Switzerland | ch_ | Switzerland VAT number | CHE-123.456.789 MWST |
Taiwan | tw_ | Taiwanese VAT | 12345678 |
Tajikistan | tj_ | Tajikistan Tax Identification Number | 123456789 |
Tanzania | tz_ | Tanzania VAT Number | 12345678A |
Thailand | th_ | Thai VAT | 1234567891234 |
Turkey | tr_ | Turkish Tax Identification Number | 0123456789 |
Uganda | ug_ | Uganda Tax Identification Number | 1014751879 |
Ukraine | ua_ | Ukrainian VAT | 123456789 |
United Arab Emirates | ae_ | United Arab Emirates TRN | 123456789012345 |
United Kingdom | eu_ | Northern Ireland VAT number | XI123456789 |
United Kingdom | gb_ | United Kingdom VAT number | GB123456789 |
Uruguay | uy_ | Uruguayan RUC number | 123456789012 |
Uzbekistan | uz_ | Uzbekistan TIN Number | 123456789 |
Uzbekistan | uz_ | Uzbekistan VAT Number | 123456789012 |
Zambia | zm_ | Zambia Tax Identification Number | 1004751879 |
Zimbabwe | zw_ | Zimbabwe Tax Identification Number | 1234567890 |