
Página de configuración de información de integración
API Key
Puede consultar y gestionar la API key del proyecto.
Configuración de API Key
x-api-key en todas las solicitudes API.
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.- Webhook IP:
52.78.194.237(región US),43.202.228.115(región KR)
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:- Ingrese nombre y dirección de email.
- Haga clic en el botón agregar para registrar usuarios de notificación.
- Los usuarios registrados reciben información de webhooks enviados el día anterior vía email cada mañana.
Return URL
Los usuarios son redirigidos a la URL configurada cuando se completa el KYC o cuando acceden a una página de error.
Configuración de Return URL
errorCode se transmite junto con la URL para que el cliente pueda identificar el motivo del bloqueo.
Ejemplo de Return URL (finalización normal):
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
encrypted.
Ejemplo de Return URL cifrada:
Guía de cifrado
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
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.Campos Dinámicos
Puede seleccionar los elementos que se transmitirán como parámetros de consulta a la Return URL haciendo clic en las casillas de los Campos Dinámicos. Los valores configurados se reflejan automáticamente en la vista previa de la Return URL final en la parte inferior de la pantalla.errorCode)Al marcar Error Code en los Campos Dinámicos, los usuarios que accedan a una página de error podrán regresar al servicio del cliente a través del botón de Return URL. En ese momento, el valor errorCode se incluirá en el query string de la URL, permitiendo al cliente identificar el motivo del bloqueo (ej.: fallo en Device Verification, token expirado). Consulte el documento Códigos de error y páginas de error para el mapeo completo de códigos de error.Tipos de evento Webhook
Los principales tipos de evento enviados vía webhook son los siguientes:Casos de uso
Automatización del proceso de onboarding de clientes
Automatización del proceso de onboarding de clientes
Monitoreo y respuesta en tiempo real del equipo de operaciones
Monitoreo y respuesta en tiempo real del equipo de operaciones
Provisión de páginas de resultados personalizadas
Provisión de páginas de resultados personalizadas