Ir al contenido principal

¿Qué son los Webhooks?

Matthew avatar
Escrito por Matthew
Actualizado hace más de una semana

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 PEP y Sanciones, es importante tener en cuenta que se envía cuando se han realizado las verificaciones de PEP y Sanciones. Este webhook proporciona notificaciones automáticas de actualizaciones en el cribado de PEP, sanciones y medios adversos, e incluye detalles técnicos como totalHits, datos de sanciones/PEP y advertencias. Se envía de forma independiente de los Webhooks de Evento y Decisión descritos anteriormente. Para detalles sobre la carga útil, consulte nuestra documentación del webhook de análisis de listas.

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 al tanto.

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!##

Configurando el Webhook de PEP y Sanciones

Para configurar el Webhook de PEP y Sanciones (webhook de cribado de listas de seguimiento), sigue estos pasos:

  1. Inicia sesión en tu Portal de Clientes de Veriff

  2. Ve a la página "Todas las integraciones".

  3. Selecciona la integración (de prueba o en vivo) donde deseas activar la función.

  4. Navega a la pestaña "Configuración" dentro de la integración que seleccionaste.

  5. Configura la "URL del webhook para cribado de listas" en el endpoint que hayas preparado para recibir las notificaciones.

  6. Asegúrate de que el endpoint esté preparado para analizar campos técnicos clave como matchStatus y totalHits y gestionar las respuestas del webhook adecuadamente.

Probando el Webhook en el Entorno de Pruebas (Sandbox) de Veriff

Veriff ofrece un entorno de desarrollo de prueba gratuito (sandbox) para que los desarrolladores puedan probar integraciones, incluyendo la funcionalidad del Webhook PEP y Sanciones. Puedes acceder a tu integración de prueba a través del Portal de Clientes de Veriff en "Todas las integraciones" y configurar la URL del webhook en la pestaña Configuració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 verse en el Back Office en la vista de sesión de verificación. Desde allí, si es necesario, todos los webhooks también se pueden reenviar. Puedes recibir una decisión específica con un webhook de decisión al probar nuestros servicios (en la integración de prueba).
Para la prueba, simplemente ingresa la decisión que deseas recibir junto con el webhook de decisión al lado del 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.
El Webhook PEP y Sanciones asegura que seas notificado cuando haya actualizaciones o cambios en el estado de una persona en la base de datos de Veriff, agilizando tus flujos de trabajo de cumplimiento.

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.

Puede leer más sobre los webhooks en nuestra documentación de la API.

Te animamos a usar SSL para endpoints de webhook en el ambiente en vivo, ya que se están transmitiendo datos sensibles.

¿Ha quedado contestada tu pregunta?