Saltar al contenido principal
La configuración de información de integración permite la integración de datos en tiempo real con los sistemas del cliente. Puede construir una integración fluida con sistemas de negocio mediante gestión de API keys, configuración de webhooks, configuración de return URL, configuración de dynamic fields, etc.
Configuración de información de integración

​
API Key

Puede consultar y gestionar la API key del proyecto.
Configuración de API key
La API key es una clave única utilizada para autenticación al llamar a la ARGOS ID Check API. Debe incluirse en el header x-api-key en todas las solicitudes API.
Seguridad de la API KeyTenga cuidado de no exponer las API keys externamente. Si una API key se filtra, se pueden acceder a todos los datos del proyecto, por lo que debe gestionarse de forma segura.
Uso de la API KeyPuede usar diversas funciones API como consulta de submissions, procesamiento de aprobación/rechazo, gestión de tokens, etc. usando la API key.

​
Configuración de Webhook

La función Webhook permite la integración de datos en tiempo real con sistemas del cliente. Cuando ocurren eventos específicos, envía solicitudes HTTP POST al endpoint (Endpoint URL) configurado por el cliente, permitiendo notificaciones y procesamiento de datos en tiempo real sin llamadas API separadas.
Configuración de webhook

​
Configuración de Webhook URL

Configure la endpoint URL donde el sistema del cliente recibirá los datos del webhook. Las solicitudes HTTP POST se envían a la URL configurada cuando ocurren eventos de webhook.
Seguridad y estabilidad del WebhookLos endpoints de webhook deben usar HTTPS para asegurar la transmisión segura de datos. También se recomienda implementar mecanismos de verificación de firma para verificar la autenticidad de las solicitudes de webhook.
Se requiere configuración de firewallLa dirección IP usada por ARGOS al enviar webhooks es 52.78.194.237. Para recibir webhooks normalmente, debe configurar el firewall para permitir solicitudes desde esta dirección IP.
Método de configuración del firewallAgregue la siguiente dirección IP a la allow list en la configuración del firewall o security group del cliente:
  • Webhook IP: 52.78.194.237
Si no se permiten las solicitudes HTTP POST desde esta dirección IP, los webhooks serán bloqueados y no podrán recibirse.
Gestión de IP y URL de WebhookLas IPs fijas de webhook para cada proyecto solo pueden consultarse en esta página, y el historial de cambios de URL de webhook no se almacena, así que tenga cuidado con la gestión de URLs de webhook.

​
Gestión de usuarios de notificación

Al agregar nombres y emails mediante la gestión de usuarios de notificación, puede recibir información sobre webhooks enviados el día anterior vía email a la mañana siguiente. Método de configuración:
  1. Ingrese nombre y dirección de email.
  2. Haga clic en el botón agregar para registrar usuarios de notificación.
  3. Los usuarios registrados reciben información de webhooks enviados el día anterior vía email cada mañana.
Reporte diario de WebhookUn resumen de todos los eventos webhook enviados el día anterior (00:00 ~ 23:59 UTC) se envía vía email a los usuarios de notificación registrados cada mañana. Esto le permite monitorear el estado de transmisión de webhooks.

​
Return URL

Los usuarios son redirigidos a la URL configurada cuando se completa el KYC.
Configuración de return URL
Cuando se completa el proceso KYC y el remitente selecciona el botón “Ok” o espera 5 segundos, es redirigido a la return URL con valores de parámetros pre-especificados en dynamic fields. Ejemplo de Return URL: 
https://yourapp.com/verification-complete?userid=user123&email=user@example.com&kycStatus=approved&submissionId=sub_abc123&cf1=campaign_summer

​
Cifrado de Return URL

Cuando se activa la función de cifrado de return URL, los parámetros de la return URL se cifran y entregan.
Configuración de cifrado de return URL
Cuando el cifrado de return URL está activado, los parámetros seleccionados en dynamic fields se cifran e incluyen en el parámetro encrypted. Ejemplo de Return URL cifrada: 
https://yourapp.com/verification-complete?encrypted={encrypted_data}
Uso del cifrado de Return URLCuando usa return URLs que contienen información sensible (email, user ID, etc.), puede reforzar la seguridad activando la función de cifrado. Se usa el método AES-256-ECB para el descifrado.

Guía de cifrado

Aprenda a descifrar datos de cifrado de return URL.
Uso de Return URLDespués de completar el KYC, los usuarios pueden ser redirigidos automáticamente a la página de servicio del cliente, proporcionando páginas de guía personalizadas según el estado de aprobación/rechazo.

​
Skip Result Page

Puede omitir que los usuarios vean los resultados de KYC y redirigirlos a la URL deseada. Cuando se activa la función skip result page, se omite la página de resultados de KYC y se mueve directamente a la return URL. Escenarios de uso:
  • Cuando los clientes quieren proporcionar su propia página de resultados
  • Cuando desea proporcionar resultados de forma flexible mediante parámetros de dynamic fields en la return URL
Combinación de Skip Result Page y Dynamic FieldsCuando activa la función skip result page y selecciona parámetros como kycStatus, submissionId en dynamic fields, la información del resultado KYC se incluye en la return URL. Esto permite a los clientes configurar sus propias páginas de resultados.

​
Dynamic Fields

Puede hacer clic en campos en dynamic fields para establecer los campos deseados que se agregarán a la URL. Mediante dynamic fields, los clientes pueden recibir la siguiente información en la return URL:
CampoDescripción
kycStatusEstado del resultado KYC (approved, pending, rejected)
useridUser ID
emailDirección de email del usuario
submissionIdSubmission ID
cf1, cf2, cf3Custom fields 1, 2, 3
Método de configuración:
  1. Haga clic y seleccione los campos que desea pasar en la pantalla de configuración de dynamic fields.
  2. Los campos seleccionados se agregan automáticamente como parámetros de consulta a la return URL.
Ejemplo de Return URL (Dynamic Fields aplicados): 
https://yourapp.com/verification-complete?kycStatus=approved&userid=user123&email=user@example.com&submissionId=sub_abc123&cf1=campaign_summer
Uso de Dynamic FieldsUsando dynamic fields, puede incluir información del resultado KYC en la return URL. Esto permite a los sistemas del cliente procesar resultados KYC inmediatamente sin llamadas API separadas.
Precauciones de Dynamic FieldsEl parámetro kycStatus sigue camelCase, por lo que las mayúsculas y minúsculas deben distinguirse con precisión. Se devuelve uno de approved, pending o rejected dependiendo del resultado.

​
Tipos de evento Webhook

Los principales tipos de evento enviados vía webhook son los siguientes:
EventoDescripción
approvedOcurre cuando la autenticación KYC es aprobada
rejectedOcurre cuando la autenticación KYC es rechazada
pendingOcurre cuando el estado cambia a requerir revisión manual
retryOcurre cuando hay un reintento
updatedOcurre cuando se actualiza la información del submission
deleteOcurre cuando se elimina un submission
submitOcurre cuando se completa un nuevo submission
tokenCuando ocurren eventos relacionados con token
injectionCuando ocurre inyección de datos
amlCuando ocurren resultados de comprobación AML
aml-ongoingCuando ocurren resultados de ongoing monitoring AML

​
Casos de uso

Cuando se completa la autenticación KYC de un nuevo cliente de una institución financiera, pueden recibir notificaciones inmediatas vía webhook y proceder automáticamente con procesos de seguimiento como apertura de cuenta, emisión de tarjeta y activación de servicio. Usando return URLs y dynamic fields, se pueden proporcionar páginas de guía personalizadas según el estado de aprobación/rechazo.
Cuando los submissions KYC son rechazados o se detectan factores de riesgo específicos, se pueden enviar notificaciones inmediatas al equipo de operaciones vía webhook para respuesta rápida. Puede verificar el estado de transmisión de webhooks del día anterior cada mañana mediante la función de gestión de usuarios de notificación.
Los clientes pueden configurar sus propias páginas de resultados usando la función skip result page y dynamic fields. Como la información del resultado KYC se incluye en la return URL, los resultados pueden procesarse inmediatamente sin llamadas API separadas.

​
Documentación relacionada

Información del proyecto

Consulte la configuración de información básica del proyecto.

Descripción general de eventos Webhook

Consulte la descripción general completa de eventos webhook.

Guía de Return URL

Aprenda a usar return URLs en detalle.

Webhook aprobado

Consulte el payload del webhook aprobado.

Webhook rechazado

Consulte el payload del webhook rechazado.

Referencia de API

Aprenda a usar las APIs.