Manual de Integración - JAAK KYC

Manual Completo para Implementar Solución Know Your Client

⏱️ Tiempo estimado: 45-60 minutos para implementación completa


🎯 ¿Qué lograrás con este manual?

Al finalizar esta guía habrás implementado un sistema completo de verificación de identidad KYC en tu negocio, permitiendo validar la identidad de tus clientes de forma segura y automatizada.

📋 Antes de Empezar - Requisitos

Información Necesaria:

  • Nombre oficial de tu empresa
  • Correo electrónico empresarial
  • Países donde opera tu negocio
  • URL de redirección (página web donde regresar a los usuarios)
  • Método de notificación preferido (Email, WhatsApp, SMS)

Accesos Técnicos:

  • Acceso a la Plataforma JAAK
  • Credenciales de administrador
  • (Opcional) Acceso al código de tu sitio web para integraciones avanzadas

🗂️ Índice de Contenidos

SecciónActividadTiempo
Configuración InicialPreparar tu cuenta y empresa15 min
Implementación BásicaCrear y enviar verificaciones20 min
PersonalizaciónAdaptar mensajes a tu marca10 min
PruebasValidar funcionamiento10 min
OperaciónGestionar verificaciones diarias5 min

CONFIGURACIÓN INICIAL

Paso 1: Configurar Información de Empresa

🎯 Objetivo

Establecer los datos básicos de tu empresa en la plataforma JAAK.

📍 Navegación

Dashboard → Ajustes → Mi Compañía → Editar

✅ Acciones requeridas

1.1 Información Empresarial

Complete los siguientes campos obligatorios:

CampoDescripciónEjemplo
NombreRazón social de la empresa"Fintech ABC S.A. de C.V."
CorreoEmail oficial de contacto"[email protected]"
TeléfonoNúmero principal"+52 55 1234 5678"
DominioSitio web empresarial"fintechabc.com"

1.2 Configuración Operativa

Países Aceptados:

  • Seleccione únicamente los países donde opera su negocio
  • Esta configuración determina qué documentos se pueden validar
  • Recomendación: Menos países = mayor precisión en validación

Usuarios del Sistema:

  • Defina cuántos colaboradores usarán la plataforma
  • Asigne roles apropiados (Administrador, Manager, Lector)

1.3 Configuración KYC

Configure los parámetros operativos:

ParámetroValor RecomendadoPropósito
Edad mínima18 añosCumplimiento legal
Edad máxima100 añosRango operativo
URL WebhookSu endpointRecibir resultados automáticamente

Guarde los cambios para continuar.


Paso 2: Gestión de Usuarios

🎯 Objetivo

Crear cuentas para su equipo de trabajo.

📍 Navegación

Dashboard → Ajustes → Accesos → Generar nuevo acceso

Tipos de Roles Disponibles

RolPermisosIdeal para
ADMINISTRADORConfiguración completa + OperaciónGerentes, responsables TI
MANAGERGestión de sesiones + ConsultasSupervisores, coordinadores
LECTORSolo visualizaciónAnalistas, auditores

Información Requerida por Usuario

  • Nombre completo
  • Correo electrónico corporativo
  • Rol asignado

IMPLEMENTACIÓN BÁSICA

Paso 3: Crear Sesión de Verificación

🎯 Objetivo

Generar enlaces de verificación para sus clientes.

📍 Navegación

Dashboard → KYC → Sesiones → Crear nueva Sesión KYC

✅ Configuración de Sesión

3.1 Información del Cliente

CampoDescripciónEjemplo
Nombre del contactoNombre completo del cliente"María González Pérez"
Nombre del flujoIdentificador interno único"Cliente-001-Onboarding"
País de documentaciónPaís del documento a validar"México"

3.2 Configuración de Proceso

CampoOpcionesRecomendación
Tipo de flujoKYC TradicionalPara validación completa
Medio de notificaciónEmail / WhatsApp / SMSSegún preferencia del cliente
URL de redirecciónSu página webDonde regresar al cliente

3.3 Métodos de Envío

Opción A: Notificación Automática

  • Configure verificationType como "email", "whatsapp" o "sms"
  • Proporcione el contacto del cliente
  • JAAK enviará el enlace automáticamente

Opción B: Envío Manual

  • Deje verificationType vacío
  • Copie la URL generada
  • Envíe por sus propios canales

Resultado

El sistema generará una sessionUrl como:
https://sandbox.kyc.jaak.ai/session/ABC123X


Paso 4: Proceso del Cliente

🎯 Objetivo

Entender el flujo que experimentará su cliente.

4.1 Flujo de Verificación

El cliente pasará por estas etapas:

  1. Bienvenida - Mensaje personalizado de su empresa
  2. Permisos - Autorización para usar cámara y geolocalización
  3. Documento (Frente) - Captura del anverso del documento
  4. Documento (Reverso) - Captura del reverso (si aplica)
  5. Biometría - Video-selfie para prueba de vida
  6. Procesamiento - Validación automática de información
  7. Resultado - Confirmación y redirección

4.2 Tiempo Promedio

  • Total: 3-5 minutos
  • Captura: 2-3 minutos
  • Procesamiento: 1-2 minutos

4.3 Requisitos Técnicos para Cliente

  • Navegador compatible (Chrome, Safari, Firefox)
  • Cámara funcional
  • Buena iluminación
  • Conexión a internet estable

PERSONALIZACIÓN

Paso 5: Personalizar Mensajes

🎯 Objetivo

Adaptar la experiencia a su marca empresarial.

📍 Navegación

Dashboard → KYC → Template

✅ Pantallas Personalizables

5.1 Mensaje de Notificación

Personalice el mensaje que recibe el cliente por WhatsApp/SMS/Email:

¡Hola! [Tu Empresa] necesita verificar tu identidad para completar tu registro.

Este proceso es seguro y toma solo 3 minutos.

Haz clic aquí para empezar: [ENLACE]

5.2 Pantalla de Bienvenida

Configure el mensaje inicial que ve el cliente:

¡Bienvenido a [Tu Empresa]!

Para completar tu registro, necesitamos verificar tu identidad.
Este proceso es completamente seguro y toma solo unos minutos.

Tendrás que:
✓ Fotografiar tu documento oficial
✓ Tomar una selfie para confirmar tu identidad

¿Listo para empezar?

5.3 Pantalla de Permisos

Explique por qué necesita los permisos:

Para completar la verificación necesitamos:

📷 Acceso a tu cámara para:
- Fotografiar tu documento de identidad
- Tomar una selfie de verificación

📍 Tu ubicación para:
- Cumplir con requisitos regulatorios

Tu privacidad es importante. No guardamos videos ni usamos tu información para otros fines.

5.4 Pantalla de Resultados

Mensaje de confirmación final:

¡Excelente! Tu verificación se completó exitosamente.

¿Qué sigue?
• Recibirás una confirmación por email en los próximos minutos
• Tu cuenta ya está activada
• Puedes comenzar a usar nuestros servicios

¿Tienes preguntas? Contáctanos en [email protected]

Consejos para Mensajes Efectivos

  • Use lenguaje claro y simple
  • Explique el beneficio para el cliente
  • Incluya tiempos específicos
  • Proporcione información de contacto

PRUEBAS Y VALIDACIÓN

Paso 6: Realizar Prueba Completa

🎯 Objetivo

Validar que todo funciona correctamente antes del lanzamiento.

✅ Lista de Verificación

6.1 Configuración

  • Información de empresa completa
  • Países configurados correctamente
  • Mensajes personalizados
  • Webhook configurado (si aplica)

6.2 Prueba de Verificación

  1. Cree una sesión de prueba con sus datos
  2. Complete el proceso completo
  3. Verifique que reciba el resultado
  4. Confirme la redirección funciona

6.3 Prueba de Diferentes Escenarios

  • Documento mexicano válido
  • Cliente con buena conectividad
  • Cliente con mala iluminación
  • Proceso en dispositivo móvil
  • Proceso en computadora

Estados de Resultado Esperados

EstadoSignificadoAcción
APROBADOVerificación exitosaProceder con cliente
RECHAZADOFalló validaciónRevisar causa, posible reintento
PENDIENTERequiere revisión manualRevisar en 24-48 horas
⚠️ ERRORProblema técnicoVerificar configuración

OPERACIÓN DIARIA

Paso 7: Gestión de Verificaciones

🎯 Objetivo

Administrar las verificaciones de identidad en operación normal.

7.1 Monitoreo de Sesiones

Dashboard Principal: KYC → Sesiones

Información disponible:

  • Lista de todas las verificaciones
  • Estado actual de cada sesión
  • Tiempo de procesamiento
  • Datos extraídos del cliente

7.2 Revisión de Resultados

Para cada sesión puede consultar:

  • Datos personales extraídos
  • Imágenes capturadas
  • Puntuación de confianza
  • Validaciones realizadas
  • Historial de la sesión

7.3 Casos que Requieren Atención

Sesiones PENDIENTES:

  • Revise los datos manualmente
  • Valide si las imágenes son claras
  • Tome decisión de aprobación/rechazo

Sesiones con ERROR:

  • Verifique la configuración del sistema
  • Confirme que el webhook funciona
  • Contacte soporte si persiste

7.4 Métricas Importantes

Monitoree regularmente:

  • Tasa de aprobación
  • Tiempo promedio de procesamiento
  • Sesiones abandonadas
  • Principales causas de rechazo

INTEGRACIÓN AVANZADA (OPCIONAL)

Opción A: Implementación vía Marca Blanca

Características:

  • Interfaz completa proporcionada por JAAK
  • Mínimo desarrollo técnico
  • Personalización de marca básica
  • Implementación rápida (1-2 días)

Ideal para:

  • Empresas sin equipo técnico
  • Implementación rápida
  • Presupuesto limitado

Opción B: Integración vía API

Características:

  • Control total sobre la experiencia
  • Interfaz 100% personalizada
  • Integración con sistemas existentes
  • Desarrollo técnico requerido

Ideal para:

  • Empresas con equipo de desarrollo
  • Experiencia de usuario específica
  • Integración con sistemas complejos

Herramientas de Desarrollo Disponibles

  • @jaak.ai/face-detector: Componente para captura facial
  • @jaak.ai/stamps: Componente para captura de documentos
  • APIs REST: Servicios de validación individual

SOLUCIÓN DE PROBLEMAS

Problemas Frecuentes

Cliente no puede completar verificación

ProblemaCausa ProbableSolución
No carga la cámaraPermisos bloqueadosActivar permisos en navegador
Documento rechazadoPaís no configuradoVerificar lista de países aceptados
Calidad de imagenMala iluminaciónInstruir mejores condiciones
Proceso se cuelgaConectividadReintentar con mejor conexión

Configuración del sistema

ProblemaVerificar
Webhook no funcionaURL correcta y servidor activo
Mensajes no personalizadosConfiguración de templates guardada
Países incorrectosLista actualizada en configuración

SOPORTE Y CONTACTO

Cuándo Contactar Soporte

  • Errores técnicos persistentes
  • Problemas de configuración complejos
  • Dudas sobre integraciones
  • Solicitudes de funcionalidades

Información para Soporte

  • Descripción detallada del problema
  • Capturas de pantalla
  • Pasos realizados antes del error
  • Navegador y dispositivo usado
  • ShortKey de la sesión problemática

Conceptos Básicos

Para mayor información sobre términos técnicos y arquitectura del sistema, consulte la guía "Conceptos Básicos en JAAK" disponible en la documentación.

Documentación Adicional

  • Guía de integración vía API
  • Referencia de webhooks
  • Lista de países soportados
  • Códigos de error y soluciones