Kennisbank › Btw-nummer controleren in je webshop of checkout

Btw-nummer controleren in je webshop of checkout

Bijgewerkt: 1 november 2026 · Klik&Shop

Verkoop je zakelijk aan EU-klanten via je webshop? Laat het btw-nummer dan automatisch controleren, zodat je zonder handwerk btw kunt verleggen.

Wanneer controleer je?

In de checkout, zodra een zakelijke klant uit een ander EU-land een btw-nummer invult. Is het geldig, dan toon je de prijs zonder btw.
Bij het aanmaken van een klant in je CRM of boekhouding.
Voor het factureren, vooral als de vorige controle mislukte door een storing.
Periodiek bij vaste klanten, bijvoorbeeld elk kwartaal, met een batch-controle.

Controleer server-side

Roep de API aan vanaf je server, niet vanuit de browser: zo blijft je API-key geheim. Voorbeeld in JavaScript (Node.js):

const res = await fetch("https://api.klik-shop.nl/v1/vat/" + encodeURIComponent(vat), {
  headers: { "X-API-Key": process.env.BTW_API_KEY }
});
const data = await res.json();
if (res.status === 200 && data.valid) {
  // geldig: btw verleggen, naam/adres opslaan met data.checked_at
} else if (res.status === 200) {
  // ongeldig: btw rekenen of klant vragen het nummer te corrigeren
} else if (res.status === 503) {
  // VIES-storing: voorlopig accepteren, later opnieuw controleren
}

Meer voorbeelden (curl, PHP) staan in de documentatie.

Maak je checkout robuust

Valideer eerst het formaat in het formulier, zodat typfouten direct opvallen (zie formaat per land).
Weiger klanten niet bij een storing. Bij 503 accepteer je de bestelling voorlopig. Zie VIES storing.
Gebruik een time-out van ongeveer 15 seconden, zodat je checkout niet blijft hangen.
Bewaar het resultaat: nummer, geldig/ongeldig, naam, adres en tijdstip. Dat helpt bij je administratie en een eventuele controle.

Kosten

De BTW-check API heeft 5 gratis checks per maand, daarna prepaid tegoed: €5 voor 2.000 checks of €15 voor 10.000 checks, zonder abonnement. Herhaalde controles van hetzelfde nummer binnen 24 uur komen uit de cache en zijn snel. Maak een gratis API-key en probeer het direct. Eerst één nummer handmatig testen? Gebruik de gratis check.

Veelgestelde vragen

Mag ik de API-key in mijn front-end gebruiken?

Nee. Iedereen kan dan je key uitlezen en je tegoed verbruiken. Roep de API aan vanaf je server of via een serverless functie.

Wat doe ik als VIES niet bereikbaar is tijdens de checkout?

Accepteer de bestelling voorlopig, eventueel met btw, en controleer het nummer opnieuw voordat je de factuur definitief maakt.

Direct een btw-nummer controleren

Eenmalig 5 gratis controles via VIES, of automatisch met de API (5 gratis checks per maand).

Gratis check Bekijk de API