KYC Mosaic

¿Qué es JAAK Mosaic?

JAAK Mosaic es una plataforma de verificación de identidad basada en KYC (KYC - Know Your Customer) que permite realizar procesos de verificación completos de forma embebida o mediante enlaces directos. La plataforma ofrece múltiples pasos de verificación configurables para adaptarse a diferentes necesidades de negocio.

🚀 Proceso para Crear una Sesión KYC

El flujo básico para generar un enlace de verificación KYC es muy simple:

1. Crear Sesión

Realiza una llamada POST a la API de JAAK para crear una nueva sesión de verificación. Crear Sesión KYC

2. Obtener shortKey

La respuesta incluye una URL de sesión de la cual extraes el shortKey:

https://sandbox.kyc.jaak.ai/session/jsi8lPd

ShortKey 👉 jsi8lPd Identificador único de 7 caracteres. Este shortKey se genera automáticamente y no es personalizable.

3. Configurar Flujo KYC

Define qué pasos de verificación quieres incluir en tu flujo personalizado.

steps=DOCUMENT_EXTRACT,DOCUMENT_VERIFY,IVERIFICATION

4. Generar URL

Combina el shortKey con la configuración con la URL de Mosaic para tener un LINK para compartir.

5. Mosaic URL

🔗

https://mosaic.sandbox.jaak.ai/link?shortKey=jsi8lPd&steps=DOCUMENT_EXTRACT,DOCUMENT_VERIFY,IVERIFICATION

6. Compartir Mosaic URL

Distribuye el enlace para que los usuarios completen su verificación de identidad.

📋 Pasos Disponibles en el Flujo KYC

🛠️ Configuraciones Predefinidas

Básico (Para casos simples)

{
  "steps": [
    {"key": "DOCUMENT_EXTRACT"},
    {"key": "DOCUMENT_VERIFY"},
    {"key": "IVERIFICATION"}
  ]
}

Estándar (Recomendado)

{
  "steps": [
    {"key": "WELCOME"},
    {"key": "DOCUMENT_EXTRACT"},
    {"key": "DOCUMENT_VERIFY"},
    {"key": "BLACKLIST"},
    {"key": "IVERIFICATION"},
    {"key": "OTO"},
    {"key": "FINISH"}
  ]
}

Seguridad Máxima

{
  "steps": [
    {"key": "DOCUMENT_EXTRACT"},
    {"key": "DOCUMENT_VERIFY"},
    {"key": "BLACKLIST"},
    {"key": "IVERIFICATION"},
    {"key": "LOCATION_PERMISSIONS"},
    {"key": "OTO"}
  ]
}

💻 Implementación Técnica

API de Creación de Sesión

// Crear nueva sesión KYC
const response = await fetch('https://sandbox.api.jaak.ai/api/v1/kyc/flow', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_TOKEN_JAAK',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "Verificación KYC",
    flow: "CUSTOM_FLOW",
    countryDocument: "MEX",
    flowType: "KYC"
  })
});

const data = await response.json();
const shortKey = extractShortKeyFromUrl(data.sessionUrl);

Generación de URL Final

// URL base de Mosaic
const baseUrl = "https://mosaic.sandbox.jaak.ai/link";

// Construir URL con shortKey y pasos
const steps = config.steps.map(step => step.key).join(',');
const kycUrl = `${baseUrl}?shortKey=${shortKey}&steps=${steps}`;

Ejemplo de URL Generada

https://mosaic.sandbox.jaak.ai/link?shortKey=ABC123X&steps=DOCUMENT_EXTRACT,DOCUMENT_VERIFY,IVERIFICATION

Parámetros URL Disponibles

📊 Seguimiento y Resultados

Una vez que los usuarios completen la verificación:

• Los datos extraídos se almacenan en JAAK
• Puedes consultar resultados via API 👉 Ver documentación
• Webhooks notifican cambios de estado 👉 Ver documentación

🔒 Consideraciones de Seguridad

• ✅ Tokens de API nunca en frontend
• ✅ HTTPS obligatorio para todas las URLs
• ✅ Validación de dominios permitidos
• ✅ Expiración de enlaces por tiempo
• ✅ Logs de auditoría para cumplimiento

🚀 Ventajas de JAAK Mosaic

1. 🏃‍♂️ Rápido: Enlaces listos en segundos
2. 🔧 Flexible: Configuración personalizable
3. 📱 Universal: Funciona en web y móvil
4. 🛡️ Seguro: Cumple normativas internacionales
5. 📊 Completo: Datos estructurados listos para usar

✨ Comenzar Ahora

Crea tu propio KYC Mosaic para implementar en tu proyecto: Implementar un KYC Mosaic