Saltar al contenido principal

¿Qué son los Webhooks?

Los webhooks son una funcionalidad que le permite recibir notificaciones en tiempo real cuando ocurren eventos específicos. Envían alertas automáticamente a una URL designada cada vez que los datos KYC cambian o se agrega nueva información.

1. ¿Cuándo se envían los webhooks?

Se envía un webhook a la URL de webhook registrada cada vez que ocurre uno de los eventos siguientes, como la creación, aprobación, rechazo, actualización o eliminación de un envío. Reciba actualizaciones en tiempo real a través de los webhooks de ARGOS Identity.
  • “webhook_trigger”: “created” → Cuando la solicitud es creada
  • “webhook_trigger”: “retry” → El solicitante procedió y se produjo el reintento
  • “webhook_trigger”: “approved” → La solicitud es aprobada como resultado de la revisión
  • “webhook_trigger”: “rejected” → La solicitud es rechazada como resultado de la revisión
  • “webhook_trigger”: “submit” → La solicitud pasa a estado pendiente.
  • “webhook_trigger”: “updated” → La solicitud es actualizada (incluidos los cambios de estado KYC realizados mediante la API PATCH/Submission o el panel)
  • “webhook_trigger”: “delete” → Se procede a la eliminación de la solicitud
  • “webhook_trigger”: “token_expired” → El Token ID ha expirado
  • “webhook_trigger”: “injection” → Se procede a la inyección de datos en la solicitud
  • “webhook_trigger”: “aml” → Se procede al proceso aml
  • “webhook_trigger”: “aml_monitor” → Se procede al proceso aml_monitor
Webhook DescriptionWebhook Description Dark

Aprobado

Rechazado

Actualizado

Eliminación

Envío

Token expirado

Inyección de datos

Resultado de búsqueda AML

Resultados del monitoreo continuo AML

Al utilizar webhooks, puede monitorear todas las etapas del proceso KYC en tiempo real y tomar medidas inmediatas cuando sea necesario, lo que permite una gestión más eficiente de su proceso de incorporación de clientes.

2. ¿Dónde se registra la URL del webhook?

La URL del webhook se registra en el campo Webhook URL de Settings > Access Management en el dashboard. Campo Webhook URL en la configuración del dashboard
1

Iniciar sesión en el Dashboard

Inicie sesión en el Dashboard de ID check.
2

Acceder al menú de configuración

Haga clic en el menú Settings en la barra de navegación superior del dashboard.
3

Navegar a Access Management

Seleccione Access Management de la sección General en la barra lateral izquierda.
4

Ingresar la URL del webhook

Encuentre la sección Webhook URL e ingrese la dirección de webhook deseada en el campo de entrada. La URL debe usar el protocolo HTTPS y tener un formato válido.
5

Guardar configuración

Haga clic en el botón Save en la parte inferior de la página para aplicar los cambios.

3. Activar la opción de cifrado para la transferencia segura de datos

ARGOS Identity proporciona una opción de cifrado para proteger los datos KYC sensibles transmitidos a través de webhooks. Cuando esta función está activada, todos los datos del webhook se cifran automáticamente, lo que permite un intercambio de información más seguro.

a. ¿Cómo se ven los datos de webhook cifrados?

Las respuestas de webhook cifradas se entregan en el siguiente formato: { "data": "encrypted-string" }, donde encrypted-string es el resultado de cifrar los datos originales.
data-encrpyted.json
Aquí, encrypted-string es el resultado de cifrar los datos originales.

b. Configure fácilmente la opción de cifrado

Opción Secure Data Transfer en la configuración del dashboard
1

Iniciar sesión en el Dashboard

Inicie sesión en el Dashboard de ID check.
2

Acceder al menú de configuración

Haga clic en el menú Settings en la barra de navegación superior del dashboard.
3

Navegar a Access Management

Seleccione Access Management de la sección General en la barra lateral izquierda.
4

Habilitar Secure Data Transfer

Active la opción “Secure Data Transfer”.
5

Guardar configuración

Haga clic en el botón Save en la parte inferior de la página para aplicar los cambios.
Ahora que todos los datos del webhook están cifrados durante la transmisión, puede intercambiar información importante generada en cada etapa del proceso KYC de manera más segura.

Documentos relacionados

Primeros Pasos

La API de ID check es una solución diseñada para ayudar a los clientes empresariales a gestionar los procesos de KYC (Know Your Customer) y AML (Anti-Money Laundering) de manera más sistemática y eficiente. Esta API soporta integración fluida con sistemas existentes y proporciona funciones para manejar y gestionar datos de usuarios de forma segura.

GET/Submission

Esta API le permite consultar datos de envíos de ID check. Puede obtener información detallada de un envío específico o filtrar y consultar una lista de múltiples envíos.

Campos de Respuesta de GET/Submission

Definiciones detalladas de todos los campos incluidos en las respuestas de la API GET/Submission

Create and Retry

El webhook se activará en la creación inicial de la solicitud. Adicionalmente, el evento se activará si ocurre durante el reintento del proceso de solicitud KYC.