Webhook
Un webhook es un mecanismo de notificación automática que permite a un sistema enviar datos en tiempo real a otro sistema en cuanto se produce un evento específico. En el contexto de la verificación documental, los webhooks informan instantáneamente a la aplicación cliente del resultado de una verificación sin necesidad de consultar continuamente el servidor.
A diferencia del modelo clásico de solicitud-respuesta (polling), en el que la aplicación cliente debe consultar periódicamente el servidor para comprobar si un proceso ha finalizado, el webhook invierte esta lógica: es el servidor quien «empuja» la información hacia la aplicación en cuanto está disponible. Técnicamente, el cliente proporciona una URL de callback a la que el servidor envía una solicitud HTTP POST con los datos del evento en formato JSON.
En un flujo de trabajo de verificación KYC, los webhooks desempeñan un papel crucial para los procesos asíncronos. Cuando un documento requiere un análisis profundo (verificación avanzada de autenticidad, revisión manual por un analista, consulta a bases de datos externas), el resultado no es inmediato. El webhook notifica a la aplicación en cuanto la verificación se completa, permitiendo al sistema actualizar el estado del expediente e informar al usuario final sin demora.
Los webhooks de CheckFile cubren todo el ciclo de vida de una verificación: recepción de la presentación, extracción completada, análisis de autenticidad finalizado, decisión final (aceptado/rechazado/revisión necesaria). Cada notificación se firma criptográficamente para garantizar su autenticidad y prevenir ataques por inyección. El sistema gestiona automáticamente los reintentos en caso de fallo de entrega, con retroceso exponencial.
Ejemplos concretos
- 1.Un neobanco configura un webhook para ser notificado en cuanto se completa una verificación de identidad: si el documento es validado, la cuenta se activa automáticamente; si es rechazado, se envía un correo al cliente solicitando un nuevo justificante.
- 2.Una aseguradora utiliza webhooks para activar automáticamente el siguiente paso de su flujo de suscripción en cuanto se verifican los documentos de identidad y domicilio, sin intervención humana.
- 3.Una plataforma de crowdfunding inmobiliario recibe una notificación webhook por cada verificación de justificante de inversor, permitiendo actualizar en tiempo real el panel de cumplimiento del equipo jurídico.