Skip to main content

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

domain
string
La página web puede alojarse en tu propio dominio
lang
string
default:"en"
El idioma predeterminado de la página. Valores soportados: en, es, pt
icon
string
El í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):
headersColor
string
Código hex para el color de los encabezados
paragraphsColor
string
Código hex para el color de los párrafos
supportTextsColor
string
Código hex para el color de los textos de soporte
backgroundColor
string
Código hex para el color de fondo
pillsColor
string
Código hex para el color de las píldoras
progressBarColor
string
Código hex para el color de la barra de progreso
primaryButtonColor
string
Código hex para el color del botón primario
secondaryButtonColor
string
Código hex para el color del botón secundario
selectorColor
string
Código hex para el color del selector
primaryButtonTextColor
string
Código hex para el color del texto del botón primario
secondaryButtonTextColor
string
Código hex para el color del texto del botón secundario
borderRadius
number
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

Exclude By Age
number
Rechaza automáticamente todas las sesiones realizadas por usuarios menores de cierta edad. Número entre 1 y 100

Captura de Documentos

Capture Method
string
Selecciona los métodos permitidos para las imágenes:
  • Camera - Solo captura con cámara
  • Upload - Solo carga de archivos
  • Both - Permitir ambos métodos

Detección de Duplicados

Duplicated users
string
Cuando un usuario tiene documentos previamente aprobados de la misma aplicación, puedes establecer una regla automática:
  • Approve - Aprobar automáticamente
  • Review - Enviar a revisión manual
  • Decline - Rechazar automáticamente

Reglas de Validación de Documentos

QR / barcode
string
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áticamente
  • Review - Enviar a revisión manual
  • Decline - Rechazar automáticamente
MRZ not valid
string
Cuando se espera una Zona de Lectura Mecánica (MRZ) en el documento pero no se puede leer:
  • Approve - Aprobar automáticamente
  • Review - Enviar a revisión manual
  • Decline - Rechazar automáticamente
Expiration date
string
Cuando se espera la fecha de vencimiento del documento pero no se puede leer o está en un formato inválido:
  • Approve - Aprobar automáticamente
  • Review - Enviar a revisión manual
  • Decline - Rechazar automáticamente
Invalid validation
string
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 manual
  • Decline - Rechazar automáticamente
Invalid document liveness
string
Este problema surge cuando no podemos validar la vivacidad del documento:
  • Approve - Aprobar automáticamente
  • Review - Enviar a revisión manual
  • Decline - Rechazar automáticamente
Address not processed
string
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áticamente
  • Review - Enviar a revisión manual
  • Decline - 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?

1

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 →
2

Crear una Sesión

Crea una sesión de validación KYC para esa personaAprende cómo crear una validación →
3

Obtener el sessionUrl

Recupera el sessionUrl de la respuesta. Esta es la URL de la página alojada que puedes compartir con tu cliente
4

Compartir con tu Cliente

Puedes compartir el sessionUrl con tu cliente por correo electrónico, SMS o incrustarlo en tu aplicación

Ejemplo de Implementación

// 1. Crear una persona
const person = await fetch('https://api.gu1.ai/api/person', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Juan Pérez',
    email: 'juan@ejemplo.com',
    taxId: '12345678900',
    type: 'person'
  })
});

const personData = await person.json();

// 2. Crear una sesión de validación KYC
const validation = await fetch('https://api.gu1.ai/api/kyc/validations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entityId: personData.id,
    workflowId: 'tu-workflow-id'
  })
});

const validationData = await validation.json();

// 3. Obtener la URL de la página alojada
const hostedPageUrl = validationData.sessionUrl;
console.log('Comparte esta URL con tu cliente:', hostedPageUrl);

// 4. Compartir con el cliente (por correo, SMS, etc.)
await sendEmail({
  to: 'juan@ejemplo.com',
  subject: 'Completa tu Verificación de Identidad',
  body: `Por favor completa tu verificación aquí: ${hostedPageUrl}`
});

Mejores Prácticas

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

Próximos Pasos