VAT Number/Tax ID Number Validation

Recurly supports a wide array of customer tax ID number validations for merchants who are B2B, to reduce the risk of merchants being responsible for paying taxes on a purchase with a business consumer who falsely entered a tax ID number.

Enable or disable Tax ID validation on your Recurly site

VAT/Tax ID validation can be enabled or disabled for any merchant on any site by contacting Recurly Support. Recurly supports tax ID number validation via government lookups for some countries, and format validation checks for others. This page outlines the type of validation provided for each country where VAT/Tax ID number validation is supported on Recurly.

When VAT Numbers are Validated

VAT numbers are validated whenever a VAT number is added or updated to an account, at each billing event, or if an invoice is created more than six months from the last time the VAT number was validated. Here are the validation points:

  • Adding or editing Billing Information
  • Adding or editing Account Information
  • Creating or renewing Subscriptions
  • Creating one-time charges

EU VAT Validation

Recurly provides validation for European Union VAT numbers to keep merchants collecting VAT compliant in their B2B customer interactions.

How VAT Numbers Affect VAT Collection

VAT numbers are business tax registration numbers in countries that collect VAT (value-added tax). All 27 member states of the EU fall under one coordinated VAT system. EU businesses with a VAT number only pay VAT on purchases within their country. If an EU business makes a purchase from a different EU country, the business does not pay VAT on the transaction and instead delays VAT payment to their own tax filing in their own country. Due to this exemption at time of purchase rule, it is important that merchants validate whether a VAT number is real before issuing an invoice without VAT.

Validation Through VIES

Recurly is integrated with the European Commission's VAT Information Exchange System (VIES) for validating EU VAT numbers. This is the only means of validating a VAT number for an EU member state. All other services and tools that do VAT number validation are using the VIES system. It is not possible to access the individual country VAT number databases directly. You can access the VIES website here:

VIES VAT number validation is a separate feature from Recurly's EU VAT collection and is on by default for sites in production mode. The VAT number validation response (valid/invalid) is stored in Recurly, along with the date/time of the validation response, but Recurly does not currently capture or store the VIES consultation number (also called request identifier) for these responses that would tie them back to the VIES system.

Invalid VAT Numbers

A VAT number is invalid if we get a response from VIES explicitly saying the number is invalid, which means the number is not in their database. If a VAT number is invalid, we will not save it on the customer's account and will block any sign-up attempts with that invalid VAT number. We will not revalidate an invalid VAT number for 1 hour, so a customer attempting a sign-up with an already invalid VAT number will need to wait an hour before making another attempt. This may happen if your customer was recently issued their VAT number and the VIES database is not yet up to date.

If a VAT number becomes invalid while it's already on an account, the VAT number will remain on the account, but subscription renewals will go through with VAT applied.

If you have a customer claiming their VAT number is correct and VIES is showing that it is invalid, please consult the European Commission's FAQ question #13 on how the customer can fix the official record of their VAT number.

VIES Downtime and Country Maintenance Windows

VIES is a validation endpoint that aggregates the 28 different EU country databases. Some of the 28 countries have regular downtime for maintenance. Unfortunately, VAT numbers for those countries cannot be validated at those times. You can see their maintenance windows here:

If we are unable to determine the validity of a VAT number, we will not save it on the customer's account and will block any sign-up attempts. We will re-validate a VAT number at subscription renewal if the VAT number has not been validated for six months. If the re-validation comes back without a valid or invalid response, meaning VIES or the individual country is down, we will fallback to the last validation status of the VAT number and will let the subscription renewal go through without VAT applied if the last status was valid, or VAT applied if the last status was invalid.

You can view the status of each state's VIES validator at Recurly uses the VIES SOAP API, which is represented in the right column, titled "Ws Access Status".

Disable VAT Number Validation

Please contact Recurly support if you'd like to disable VAT number validation on your Recurly site.

Test Validation

VAT numbers are not validated in sandbox mode in order to allow merchants to test what a real VAT number would do. If you would like to simulate an invalid VAT number, you can use the number 000000000 with any EU country.

Sample Invalid VAT Number Error

If you are planning on transitioning from sandbox mode to production mode, then it may be useful to know ahead of time the response Recurly will generate with invalid VAT numbers. Below is a sample XML error response that would occur when creating an account with an invalid VAT number:

Accept: application/xml
Content-Type: application/xml; charset=utf-8
  <email>[email protected]</email>
  <error field="account.vat_number" symbol="invalid">is invalid</error>

UK VAT Validation

Similar to the European Union, there is a VAT ID validation government lookup system available for businesses registered in the United Kingdom. Support for customer VAT ID/tax ID numbers out of the UK being validated for UK-based customers is automatically enabled for all merchants on all sites. This integration provided is via the HRMC. Recurly integrates with this site via API for UK VAT ID lookups.

Australia ABN Validation

Recurly maintains an integration with the Australian Business Register (ABR) for tax ID number lookups with their government's business register for Australian Business Numbers (ABNs).

Format Validation

There is a set of countries that Recurly provides customer VAT/tax ID number format checks for that do not leverage integrations with local government business registers, but are supported by a ensuring the VAT/tax ID number entered on a customer's account follows the given country's specific format guidelines. Upon account creation, or updating a customer accounts' VAT/tax ID number, Recurly will use parameters to ensure the number entered is adequate based on the given country's specifications.

LocationLocal Tax Id Type(s)Accepted Format
Åland IslandsYT; ALV8 or 9 numeric digits with or without a dash; 8 numeric digits with the optional prefix of FL
AlbaniaNIPT10 characters with the additional optional prefix of AL, the 10 characters should be in the format "A NNNNNNNN A", where A=alphanumeric character and N=numeric character
AlgeriaNIF15 numeric digits
AngolaTIN; NIF9-10 numeric digits
ArmeniaINN8 numeric digits
CanadaBN9 numeric digits; 9 numeric digits followed by 2 alphanumeric characters and 4 numeric digits
ChinaUSSC15 numeric digits; 18 characters where sometimes alphanumeric characters appear in the last 10 characters
ColombiaNIT10 numeric digits
Costa RicaCPJ; NITE9-12 numeric digits
EcuadorRUC13 characters where 3rd digit is aways "6" or "9", the 4th-9th digit are numeric, and the last three digits are "001"
IndiaGSTN15 characters in the format "NNAAAAANNNNAXAX" where the the first 2 characters are numeric digits, the next ten characters are a combination of alphanumeric and numeric characters, 13th character is a numeric digit, and the 14th character is the letter Z, and the 15th character is alphanumeric
IsraelCN9 numeric digits
JapanCN1st digit is a number 1-9, followed by 12 numeric digits
KazakhstanBIN12 numeric digits
KosovoNIB; NUI; NIF8-9 numeric digits
KyrgyzstanTIN14 numeric digits
LiechtensteinPEIN; PEID; TIN5 numeric digits; 11-12 numeric digits
MacedoniaEDB13 numeric digits with the option prefix of MK
MexicoRFC9 numbers; 13 numbers; FR followed
MoldovaIDNO; VAT13 numeric digits; 7 numeric digits with the optional prefix of MD
NorwayORGNR; MVA9 numeric digits; 9 numeric digits followed by the letters MVA, may have an additional optional prefix of NO
SerbiaPIB9 numeric digits
South AfricaTRN10 numeric digits where the first digit is 0,1,2,3, or 9
South KoreaBRN10 digit code where the first 3 digits are between 101-999, the second 2 digits are 01-89 excluding 80, followed by 4 numeric digits greater than "0000", ending in any numeric digit
SwitzerlandUID; VAT12 characters in length where the format should follow the pattern: CHE-NNN.NNN.NNN, where there are 9 numeric digits following a prefix of "CHE"; 15-16 characters in length where the format should follow the pattern: CHE-NNN.NNN.NNN AAA, where there are 9 numeric digits, with a prefix of CHE, and a suffix of either MWST, TVA, or IVA
TaiwanBAN8 numeric digits
ThailandTIN13 numeric digits
TogoNIF10 numeric digits
TurkeyVKN10 numeric digits
Untied Arab EmiratesTRN15 numeric digits
UkraineEDRPOU8 numeric digits
VietnamMST10-13 numeric digits