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 entidad persona

Crea una entidad de tipo persona en Gu1 con la API de Entidades (nombre, taxId, countryCode).Aprende cómo crear una entidad →
2

Crear una validación KYC

Crea una sesión de validación KYC para esa entidad con POST /api/kyc/validations usando el ID de la entidad y integrationCode (ej. global_gueno_validation_kyc).Aprende cómo crear una validación →
3

Obtener el providerSessionUrl

Recupera el providerSessionUrl de la respuesta de la validación. Es la URL de la página alojada que compartes con tu cliente.
4

Compartir con tu cliente

Comparte el providerSessionUrl con tu cliente por correo, SMS o incrustado en tu aplicación.

Ejemplo de Implementación

// 1. Crear una entidad persona (API de Entidades)
const entityRes = await fetch('https://api.gu1.ai/api/entities', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    type: 'person',
    name: 'Juan Pérez',
    taxId: '12345678900',
    countryCode: 'AR',
    entityData: { person: { email: 'juan@ejemplo.com' } }
  })
});
const entityData = await entityRes.json();
const entityId = entityData.entity?.id ?? entityData.id;

// 2. Crear una sesión de validación KYC
const validationRes = 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,
    integrationCode: 'global_gueno_validation_kyc'
  })
});
const validationData = await validationRes.json();

// 3. Obtener la URL de la página alojada (providerSessionUrl)
const hostedPageUrl = validationData.providerSessionUrl;
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 providerSessionUrl 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

Crear Entidad

Aprende cómo crear una entidad de persona

Crear Validación

Crea una sesión de validación KYC

Integración de Webhooks

Recibe actualizaciones de estado en tiempo real

Integración de Cliente

Incrusta en tu aplicación móvil o web