Webhooks en términos simples, son la forma en que todas las decisiones y eventos son comunicados por Veriff.
Aunque hay más por venir en el futuro, actualmente tenemos 4 tipos diferentes de webhooks, y son:
Webhook de eventos - donde publicamos eventos durante el ciclo de vida de una verificación
Webhook de decisiones - donde publicamos decisiones sobre las verificaciones
Webhook de verificación de lista de vigilancia - donde publicamos eventos relacionados tanto con los resultados iniciales como monitoreados de las verificaciones de PEP, sanciones y medios adversos.
Webhook del Registro de Transporte (si aplica) - donde enviamos el resultado de la respuesta del registro de licencia de un conductor (válido, inválido, no soportado, inconcluso)
Para el Webhook de PEP y Sanciones, es importante notar que se envía cuando se han realizado verificaciones de PEP & Sanciones. Este webhook se envía de manera independiente a los Webhooks de Eventos y Decisiones descritos anteriormente. Para detalles del payload, por favor consulta nuestra documentación de Webhook de verificación de lista de vigilancia.
Configura Webhooks
¿Quieres entender cómo configurar los webhooks y recibir actualizaciones de verificación en tiempo real?
💡 Mire este video para aprender cómo:
✅ Configurar Webhooks. Configura Veriff para enviar respuestas de eventos y decisiones a tu sistema automáticamente.
✅ Personaliza notificaciones. Elige entre webhooks de eventos, decisiones y PEP & sanciones para mantenerte informado.
✅ Optimiza tu flujo de trabajo. Envía actualizaciones en tiempo real a tu equipo o integra directamente con tu plataforma.
Este video te guía a través del proceso de configuración de webhooks en Veriff Station.
🎥 ¡Mira ahora y comienza a automatizar tu proceso de verificación!
¿Cuándo se activan los Webhooks?
Si el estado de una sesión de verificación cambia, se enviará un webhook de eventos. Cuando se toma la decisión final, se envía un webhook de decisiones con todos los datos relacionados. Algunos servicios, como PEP y Sanciones tienen un webhook separado.
Los webhooks también pueden ser visualizados en la Oficina de Back en la vista de sesión de verificación. Desde ahí, si es necesario, todos los webhooks también pueden ser reenviados.
Puedes recibir una decisión específica con un webhook de decisiones al probar nuestros servicios (en Integración de Prueba). Para la prueba, simplemente ingresa la decisión que deseas recibir junto con el webhook de decisiones junto al campo "Nombre" en el payload al crear una sesión. Puedes ingresar "Aprobado", "Reenvío" o "Declinado" dependiendo de la decisión que quieras obtener.
Códigos de Webhook
El código del webhook de eventos puede ser uno de los siguientes:
7001 - Comenzado: la sesión de verificación ha sido accedida por el cliente pero aún no se ha enviado para revisión.
7002 - Enviado: la sesión de verificación ha sido enviada a Veriff y estamos en proceso de verificar al cliente
El código del webhook de decisiones puede ser uno de los siguientes:
9001 - Positivo: el cliente fue verificado, el proceso se completó correctamente y la decisión es "Aprobado".
9102 - Negativo: el cliente no fue verificado, el proceso se completó pero la verificación es "Declinado".
9103 - Reenviado: se le pidió al cliente que hiciera un reenvío, ya que faltaba algo y Veriff no pudo dar una decisión concluyente.
9104 - Negativo: la sesión de verificación ha caducado. Si el cliente ha accedido a la sesión de verificación pero no ha terminado el proceso, el estado será "Abandonado". En caso de que el cliente nunca llegó a nuestro entorno, el estado será "Caducado".
Los datos de Comprobante de dirección siempre se proporcionan dentro del webhook de decisiones.
Reenvío de Webhooks
Cuando no recibimos una respuesta exitosa del backend del cliente. Este es típicamente un comportamiento de webhook no entregado. → En tales casos, reenviaremos el webhook fallido durante hasta una semana. El reenvío se detiene automáticamente tan pronto como hay una respuesta exitosa.
Puedes leer más sobre webhooks en nuestra documentación de API.
Te animamos a usar SSL para endpoints de webhook en el ambiente en vivo, ya que se están transmitiendo datos sensibles.