---
title: Customer tax IDs
subtitle: Store, validate, and render customer tax ID numbers with Stripe Invoicing.
route: /invoicing/customer/tax-ids
---

# Customer tax IDs

Store, validate, and render customer tax ID numbers with Stripe Invoicing.

Need another tax ID type? Request additional Tax ID types
by emailing [stripe-tax@stripe.com](mailto:stripe-tax@stripe.com?subject=Request).

Displaying a customer’s tax ID on *invoice* documents is a common requirement that you can satisfy by adding tax IDs to customers. A customer’s tax IDs display in the header of invoice and credit note PDFs.

## Supported Tax ID types 

Currently, Stripe supports the following Tax ID types in the following regions:

## Validation 

You’re responsible for the accuracy of customer information including their tax ID number. The invoice includes the customer tax ID whether or not it’s valid.

Stripe provides automatic validation to help determine ​​if the formatting is correct when you add the ID to our system. 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. However, we don’t continue to validate them over time. ​​If automatic validation isn’t available, you must manually verify these IDs.

### Australian Business Numbers (ABN) 

Stripe automatically validates all Australian Business Numbers (ABNs) with the [Australian Business Register (ABR)](https://abr.gov.au/).

### 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)](http://ec.europa.eu/taxation_customs/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 depending on the availability of various government databases, might take longer. Stripe automatically handles VIES downtime and attempts retries.

### 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)](https://www.gov.uk/). 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.

HMRC validation usually takes only a few seconds, but depending on the availability, might take longer. Stripe automatically handles HMRC downtime and attempts retries.

### Testing customer tax ID verification 

Use these magic tax IDs to trigger certain verification conditions in testing environments. The tax ID type must be either the EU VAT Number or Australian Business Number (ABN).

| Number                                                     | Type                                      |
| ---------------------------------------------------------- | ----------------------------------------- |
| {{testModeMagicValues.tax_id.successful_verification}}     | Successful verification                   |
| {{testModeMagicValues.tax_id.unsuccessful_verification}}   | Unsuccessful verification                 |
| {{testModeMagicValues.tax_id.always_pending_verification}} | Verification remains pending indefinitely |

### Validation webhooks and Dashboard display 

Because this validation process happens asynchronously, the [customer.tax_id.updated](https://docs.stripe.com/api/events/types.md#event_types-customer.tax_id.updated) webhook notifies you of validation updates.

![Tax validation tooltip in the Dashboard](images/billing/tax/validation-tooltip.png)
Hover over a customer’s EU VAT number to display their VIES information.


The Dashboard displays the results of the validation within the customer details, including information returned from the government databases, and the registered name and address.

When automatic validation isn’t available, you must manually verify these IDs.

## Managing 

You can manage tax IDs in the Dashboard, with the [customer portal](https://docs.stripe.com/customer-management.md), or the [Tax ID API](https://docs.stripe.com/api/customer_tax_ids.md).

To add a tax ID:

1. Navigate to the [Customers](https://dashboard.stripe.com/customers) page, and select the applicable customer.
1. Click the pencil icon next to **Details** on the right.
1. Scroll down to **Tax Status** and **Tax ID** fields.
1. Click **Add another ID** to add a row to the tax ID list, where you can select the ID type and value.

The following example shows how to [create a new tax ID](https://docs.stripe.com/api/tax_ids/create.md) on a customer storing their VAT number:

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

To [delete a tax ID](https://docs.stripe.com/api/tax_ids/delete.md):