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.

The tax ID validation for this location is automatically turned on for all sites. If you would like to disable it, please contact Recurly support.

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: http://ec.europa.eu/taxation_customs/vies/.

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. http://ec.europa.eu/taxation_customs/vies/faq.html

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: http://ec.europa.eu/taxation_customs/vies/help.html

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 http://ec.europa.eu/taxation_customs/vies/technicalInformation.html. 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:

Request

Accept: application/xml
Content-Type: application/xml; charset=utf-8

<account>
  <account_code>1</account_code>
  <email>[email protected]</email>
  <first_name>verena</first_name>
  <last_name>example</last_name>
  <vat_number>INVALID_VAT_1234</vat_number>
  <address>
    <zip>28070</zip>
    <country>ES</country>
  </address>
</account>

Response

<errors>
  <error field="account.vat_number" symbol="invalid">is invalid</error>
</errors>

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.

To turn on tax ID validation for this location on your Recurly site, please contact Recurly support.

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).

To turn on tax ID validation for this location on your Recurly site, please contact Recurly support.

Belarus UNP validation

Recurly maintains an integration with the Belarus government business register lookup.

To turn on tax ID validation for this location on your Recurly site, please contact Recurly support.

Dominican republic RNC validation

Recurly maintains an integration with the government business register lookup in the Dominican Republic.

To turn on tax ID validation for this location on your Recurly site, please contact Recurly support.

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.

To turn on format validation for all of the locations below, please contact Recurly support.

Please Note: All locations below except for the United States are grouped together under 1 enablement option. If you would like to enable format validation for the United States, please call that out specifically in your Support ticket.