Webhook
Un webhook est un mécanisme de notification automatique qui permet à un système d'envoyer des données en temps réel vers un autre système dès qu'un événement spécifique se produit. Dans le contexte de la vérification documentaire, les webhooks permettent d'informer instantanément l'application cliente du résultat d'une vérification sans que celle-ci ait besoin d'interroger le serveur en continu.
Contrairement au modèle classique de requête-réponse (polling), où l'application cliente doit régulièrement interroger le serveur pour savoir si un traitement est terminé, le webhook inverse cette logique : c'est le serveur qui « pousse » l'information vers l'application dès qu'elle est disponible. Techniquement, le client fournit une URL de callback à laquelle le serveur envoie une requête HTTP POST contenant les données de l'événement au format JSON.
Dans un workflow de vérification KYC, les webhooks jouent un rôle crucial pour les traitements asynchrones. Lorsqu'un document nécessite une analyse approfondie (vérification d'authenticité avancée, revue manuelle par un analyste, consultation de bases de données externes), le résultat n'est pas immédiat. Le webhook notifie l'application dès que la vérification est complète, permettant au système de mettre à jour le statut du dossier et d'informer l'utilisateur final sans délai.
Les webhooks de CheckFile couvrent l'ensemble du cycle de vie d'une vérification : soumission reçue, extraction terminée, analyse d'authenticité complète, décision finale (accepté/rejeté/revue nécessaire). Chaque notification est signée cryptographiquement pour garantir son authenticité et prévenir les attaques par injection. Le système gère automatiquement les tentatives de renvoi en cas d'échec de livraison, avec un backoff exponentiel.
Exemples concrets
- 1.Une néobanque configure un webhook pour être notifiée dès qu'une vérification d'identité est complète : si le document est validé, le compte est automatiquement activé ; si le document est rejeté, un email de demande de nouveau justificatif est envoyé au client.
- 2.Un assureur utilise les webhooks pour déclencher automatiquement l'étape suivante de son workflow de souscription dès que les documents d'identité et de domicile sont vérifiés, sans intervention humaine.
- 3.Une plateforme de crowdfunding immobilier reçoit une notification webhook à chaque vérification de justificatif d'investisseur, permettant de mettre à jour en temps réel le tableau de bord de conformité des équipes juridiques.