Webhook
Een webhook is een automatisch notificatiemechanisme waarmee een systeem in real time gegevens kan versturen naar een ander systeem zodra een specifieke gebeurtenis plaatsvindt. In de context van documentverificatie informeren webhooks de clientapplicatie onmiddellijk over het resultaat van een verificatie, zonder dat deze voortdurend de server hoeft te raadplegen.
In tegenstelling tot het klassieke verzoek-antwoordmodel (polling), waarbij de clientapplicatie regelmatig de server moet raadplegen om te controleren of een verwerking is voltooid, keert de webhook deze logica om: de server stuurt de informatie actief naar de applicatie zodra deze beschikbaar is. Technisch gezien levert de client een callback-URL waaraan de server een HTTP POST-verzoek stuurt met de gebeurtenisgegevens in JSON-formaat.
In een KYC-verificatieworkflow spelen webhooks een cruciale rol bij asynchrone processen. Wanneer een document een diepgaande analyse vereist (geavanceerde echtheidsverificatie, handmatige beoordeling door een analist, raadpleging van externe databases), is het resultaat niet onmiddellijk beschikbaar. De webhook informeert de applicatie zodra de verificatie voltooid is, zodat het systeem de dossierstatus kan bijwerken en de eindgebruiker zonder vertraging kan informeren.
De webhooks van CheckFile bestrijken de volledige levenscyclus van een verificatie: indiening ontvangen, extractie voltooid, echtheidsanalyse afgerond, eindbeslissing (geaccepteerd/afgewezen/beoordeling vereist). Elke notificatie is cryptografisch ondertekend om de authenticiteit te garanderen en injectie-aanvallen te voorkomen. Het systeem beheert automatisch herhaalpogingen bij afleveringsfouten, met exponentiële backoff.
Praktijkvoorbeelden
- 1.Een neobank configureert een webhook om op de hoogte te worden gebracht zodra een identiteitsverificatie is voltooid: als het document is gevalideerd, wordt de rekening automatisch geactiveerd; als het wordt afgewezen, ontvangt de klant een e-mail met het verzoek om een nieuw bewijsstuk.
- 2.Een verzekeraar gebruikt webhooks om automatisch de volgende stap in het acceptatieproces te starten zodra identiteits- en adresbewijzen zijn geverifieerd, zonder menselijke tussenkomst.
- 3.Een vastgoed-crowdfundingplatform ontvangt een webhook-notificatie bij elke verificatie van beleggersdocumenten, waardoor het compliance-dashboard van het juridisch team in real time kan worden bijgewerkt.