Descripción General
Nuestra solución alojada es una página segura y totalmente personalizable de KYC y verificación de identidad que te permite verificar a tus clientes rápidamente sin código. La página de onboarding alojada es la forma más rápida de comenzar con la verificación KYC.Diseño Mobile-Responsive: La página alojada es completamente responsive y optimizada para todos los dispositivos (escritorio, tablet y móvil). Tus usuarios tendrán una experiencia de verificación fluida sin importar el dispositivo que usen.
Cómo Funciona
Parámetros de Personalización
Puedes personalizar la página de onboarding usando estos parámetros:Personalización de Marca y Visual
La página web puede alojarse en tu propio dominio
El idioma predeterminado de la página. Valores soportados:
en, es, ptEl ícono de la página (favicon)
El logo principal mostrado en la página
Personalización de Colores
Todos los parámetros de color aceptan códigos hexadecimales (ej.,#6366f1):
Código hex para el color de los encabezados
Código hex para el color de los párrafos
Código hex para el color de los textos de soporte
Código hex para el color de fondo
Código hex para el color de las píldoras
Código hex para el color de la barra de progreso
Código hex para el color del botón primario
Código hex para el color del botón secundario
Código hex para el color del selector
Código hex para el color del texto del botón primario
Código hex para el color del texto del botón secundario
Radio del borde web. Número entre 0 y 50
Configuración de Reglas de Validación
Puedes personalizar las reglas de validación usando estos parámetros:Verificación de Edad
Rechaza automáticamente todas las sesiones realizadas por usuarios menores de cierta edad. Número entre 1 y 100
Captura de Documentos
Selecciona los métodos permitidos para las imágenes:
Camera- Solo captura con cámaraUpload- Solo carga de archivosBoth- Permitir ambos métodos
Detección de Duplicados
Cuando un usuario tiene documentos previamente aprobados de la misma aplicación, puedes establecer una regla automática:
Approve- Aprobar automáticamenteReview- Enviar a revisión manualDecline- Rechazar automáticamente
Reglas de Validación de Documentos
Si se esperaba un código de barras o QR en el documento pero no se pudo leer, puedes establecer una regla automática:
Approve- Aprobar automáticamenteReview- Enviar a revisión manualDecline- Rechazar automáticamente
Cuando se espera una Zona de Lectura Mecánica (MRZ) en el documento pero no se puede leer:
Approve- Aprobar automáticamenteReview- Enviar a revisión manualDecline- Rechazar automáticamente
Cuando se espera la fecha de vencimiento del documento pero no se puede leer o está en un formato inválido:
Approve- Aprobar automáticamenteReview- Enviar a revisión manualDecline- Rechazar automáticamente
Este problema surge cuando no podemos validar una fecha, detectar un número de documento o reconocer con precisión el documento:
Review- Enviar a revisión manualDecline- Rechazar automáticamente
Este problema surge cuando no podemos validar la vivacidad del documento:
Approve- Aprobar automáticamenteReview- Enviar a revisión manualDecline- Rechazar automáticamente
Este problema surge cuando la dirección en el documento no se pudo encontrar o geolocalizar, probablemente debido a una dirección inválida o faltante:
Approve- Aprobar automáticamenteReview- Enviar a revisión manualDecline- Rechazar automáticamente
Estos parámetros de validación deben ser comunicados al equipo de Gu1 a través de tu canal de soporte dedicado. Si necesitas hacer cambios o modificaciones a estos parámetros, por favor envía una solicitud a través de tu canal de soporte dedicado del cliente. En el futuro, estos parámetros serán editables en el panel de Gu1.
¿Cómo Obtener la URL de la Página de Onboarding?
Crear una Persona
Primero, crea una entidad de persona en Gu1 con la información básica de tu clienteAprende cómo crear una persona →
Crear una Sesión
Crea una sesión de validación KYC para esa personaAprende cómo crear una validación →
Obtener el sessionUrl
Recupera el
sessionUrl de la respuesta. Esta es la URL de la página alojada que puedes compartir con tu clienteEjemplo de Implementación
Mejores Prácticas
Personaliza para tu Marca
Personaliza para tu Marca
Configura el esquema de colores, logo e idioma para que coincida con la identidad de tu marca. Esto crea una experiencia fluida para tus usuarios.
Establece Reglas de Validación Apropiadas
Establece Reglas de Validación Apropiadas
Configura las reglas de validación basándote en tus requisitos de cumplimiento y tolerancia al riesgo. Reglas más estrictas proporcionan mejor seguridad pero pueden resultar en más revisiones manuales.
Monitorea el Estado de la Sesión
Monitorea el Estado de la Sesión
Usa webhooks para recibir notificaciones en tiempo real cuando se complete la verificación. Esto te permite actualizar inmediatamente el acceso del usuario en tu sistema.
Maneja la Expiración y Seguridad
Maneja la Expiración y Seguridad
Expiración de Sesiones: Las sesiones típicamente expiran después de 7 días. Si la sesión de un usuario expira, crea una nueva validación para generar una URL nueva.Mejores Prácticas de Seguridad:
- Nunca expongas el sessionUrl públicamente (no lo compartas en foros públicos, URLs públicas, etc.)
- Siempre genera URLs del lado del servidor - nunca expongas las API keys en código del lado del cliente
- Usa HTTPS cuando compartas URLs a través de tus propios sistemas
- Implementa autenticación adecuada antes de generar sesiones para usuarios
- Considera implementar rate limiting en la creación de sesiones para prevenir abuso
- Almacena los IDs de validación en tu base de datos vinculados a registros de usuarios para trazabilidad de auditoría