VIES Is Down: What Your WooCommerce Checkout Should Do

Eu vat: banner

When the EU VIES service cannot be reached, should your checkout charge VAT or accept the number? Fail-closed vs fail-open, worked through.

Sooner or later, a business customer types a VAT number at your checkout and the EU's VIES service does not answer. Your checkout has to decide what to do in that moment, with no human involved. This post walks through the two options and what each one costs.

Not legal or tax advice. Ask your accountant how your tax authority treats sales where the customer's VAT number could not be checked.

Why VIES is sometimes unavailable

VIES does not hold the data itself. The Commission's VIES site explains that each check is passed on to the database of the member state that issued the number. So VIES is only as available as each of those national systems, plus the network in between.

Its help pages list routine maintenance windows by country — several are offline for a few minutes every night, and some for longer at weekends. VIES also turns requests away when too many arrive at once, with messages such as "the maximum number of concurrent requests has been reached". And its FAQ says plainly that parts of the system may be unavailable at certain times while member states back up their databases.

When that happens, VIES answers "Service unavailable" or "Member State service unavailable" — not "invalid". Nobody has said the number is bad. Nobody has said it is good either.

The two choices

Fail closed: charge the VAT

Treat an unavailable answer as not confirmed. The customer pays VAT on this order. Once the number can be checked and turns out valid, you refund the VAT.

  • Cost if the number is valid: a refund, some admin, and a customer who paid more up front than they expected.
  • Cost if the number is not valid: nothing. You charged the right tax.

Fail open: accept the number

Treat an unavailable answer as probably fine and take the VAT off, provided the number at least looks like a VAT number.

  • Cost if the number is valid: nothing.
  • Cost if the number is not valid: the VAT you did not charge. You still owe it, and you have no VIES answer to show you checked.

Comparing them

Number is valid Number is not valid
Fail closed You refund the VAT later Correct
Fail open Correct You owe VAT you never collected

The asymmetry is the whole argument. Failing closed puts a small, fixable cost on a customer whose number is valid. Failing open puts an unbounded, hard-to-recover cost on you whenever a number is not. It is much easier to give money back than to ask for it later.

The Commission's VIES FAQ points the same way: if you believe your customer is not a taxable person, you should not exempt the supply but should charge VAT.

A worked example

Brouwer Koffie, an example shop in the Netherlands, sells a €1,000 espresso machine to a bar in Lyon. The French database is offline for maintenance. Assume a 21% rate for the arithmetic.

  • Fail closed: the bar pays €1,210. The next morning Brouwer checks the number on the VIES website, it is valid, and Brouwer refunds €210 with a corrected invoice.
  • Fail open: the bar pays €1,000. If the number is valid, nothing more happens. If it was mistyped or belongs to another business, Brouwer owes €210 on a sale it already invoiced without VAT.

What a good checkout does, either way

  • Keep "unavailable" separate from "invalid" on the order, so you can tell later which orders need a second look.
  • Do not reject the order just because VIES is slow. The customer can still buy; the only question is whether VAT is on it.
  • Keep the timeout short. Waiting thirty seconds for a database that is offline only makes the checkout look broken.
  • Do not ask VIES again on every keystroke. Remember the answer for the session; the service is rate-limited.

How the Gatemi plugins handle it

Both editions treat an unreachable VIES — a network error, a non-200 reply, or VIES reporting its own error — as unavailable, record it on the order as "VIES could not be reached, so the number was not confirmed", and let the order go through.

  • Gatemi EU VAT Number (free) always fails closed: an unavailable answer never takes the VAT off. There is no setting to change that.
  • Gatemi VAT Number for WooCommerce (full edition) also fails closed by default. It has a setting, "Accept a number when VIES cannot be reached", off by default, which takes the VAT off for a well-formed number during an outage. The order still records the answer as "unavailable", so you can find those orders afterwards.

In both editions you set how long the checkout waits for VIES (3 to 30 seconds, 10 by default). The answer is remembered for the customer's session, keyed on the number — but an "unavailable" answer is kept for one minute at most, so once VIES is back the next checkout refresh asks again and the VAT can come off. (The full edition keeps a valid or invalid answer for an hour by default, adjustable with the gmvat_cache_ttl filter.)

Both editions also have a setting for the sentence to show when VIES cannot be reached, and both show it without blocking the order: on the classic checkout as a notice when the check comes back unavailable, and on the order-received page — classic or the block Order Confirmation template — for an order recorded as unavailable whose VAT stayed on. That page is where a Checkout block customer reads it. Use the sentence to tell business customers, in your own words, what you will do — for example, refund the VAT once their number is confirmed.

For the rest of the rules, see WooCommerce EU VAT numbers and reverse charge, explained.

Next step

Install Gatemi EU VAT Number from wordpress.org and your checkout fails closed from the first order.

Shopping Cart
Scroll to Top