¿Qué es KYC (Conozca a Su Cliente)?
Know Your Customer (KYC) es el proceso de verificación de identidad de clientes individuales antes de establecer una relación comercial. La solución KYC de gu1 te permite integrar la verificación de identidad en tu aplicación, permitiendo que tus usuarios finales completen el proceso de verificación de manera fluida.Enfoque API-First
Nuestra API de KYC te permite:- Crear validaciones KYC programáticamente para tus clientes
- Generar URLs de verificación para compartir con tus usuarios
- Recibir notificaciones webhook en tiempo real cuando la verificación se complete
- Consultar el estado de validación en cualquier momento
Flujo de Integración Típico
Iniciar Validación KYC
Llama a la API para crear una validación KYC y recibe una URL de verificación
Compartir URL con el Cliente
Envía la URL de verificación a tu cliente por email, SMS o intégrala en tu app
Cliente Completa la Verificación
Tu cliente sigue la URL y completa el proceso de verificación de identidad
Webhooks vs Polling Manual: Aunque los webhooks proporcionan notificaciones en tiempo real, también puedes verificar manualmente el estado de validación en cualquier momento usando
GET /api/kyc/validations/:id. Esto es útil para:- Depuración o pruebas sin infraestructura de webhooks
- Mostrar actualizaciones de estado a usuarios en tiempo real
- Recuperarse de fallos en la entrega de webhooks
- Construir dashboards de administración para monitorear el estado de validación
Características Principales
KYC Completo vs Verificaciones Individuales
¿Cuál deberías usar?
-
KYC Completo (
global_gueno_validation_kyc): Verificación completa de identidad incluyendo carga de documento, selfie, face matching y detección de vida. Recomendado para servicios financieros, banca e industrias reguladas. - Verificaciones Individuales: Llamadas API separadas para verificaciones específicas como screening PEP, verificación de sanciones o búsquedas de medios adversos. Usa cuando solo necesitas puntos de datos específicos o ya tienes documentos de identidad verificados.
| Característica | KYC Completo | Verificaciones Individuales |
|---|---|---|
| Carga de Documento | ✅ Incluido | ❌ No incluido |
| Selfie + Liveness | ✅ Incluido | ❌ No incluido |
| Face Matching | ✅ Incluido | ❌ No incluido |
| PEP/Sanciones | ✅ Incluido | ✅ Llamada API separada |
| Medios Adversos | Complemento opcional | ✅ Llamada API separada |
| Experiencia de Usuario | Flujo único para el usuario | Sin interacción del usuario |
| Mejor Para | Apertura de cuenta, onboarding | Monitoreo continuo, screening |
| Endpoint API | POST /api/kyc/validations | POST /entities/:id/analyze |
Verificación Integral de Identidad (KYC Completo)
- Validación de Documentos: Autentica documentos de identidad emitidos por el gobierno
- Verificación Biométrica: Reconocimiento facial y detección de vida
- Face Matching: Compara selfie con la foto del documento (ver nota de seguridad abajo)
- Screening AML/Sanciones: Verifica contra listas de vigilancia global
- Extracción de Datos: Extrae y verifica información personal
Procesamiento Automático de Documentos
- Tecnología OCR: Extrae automáticamente datos de documentos de identidad
- Soporte Multi-idioma: Procesa documentos en más de 100 idiomas
- Autenticación de Documentos: Detecta documentos falsos o alterados
- Extracción de Datos: Incorpora información verificada a tu sistema
Webhooks en Tiempo Real
- Notificaciones Instantáneas: Recibe actualizaciones tan pronto como se complete la verificación
- Cambios de Estado: Notificaciones de aprobación, rechazo o revisión manual
- Entrega Segura: Firmas de webhook para validación de seguridad
- Lógica de Reintentos: Reintentos automáticos para entregas fallidas
Listo para Cumplimiento
- Cumplimiento AML/CFT: Cumple con requisitos anti-lavado de dinero
- Cumplimiento GDPR: Estándares de protección de datos y privacidad
- Registro de Auditoría: Historial completo de intentos de verificación
- Retención de Datos: Políticas de retención configurables
Casos de Uso
Aplicaciones Fintech
- Banca Digital: Verifica usuarios durante la apertura de cuenta
- Apps de Pago: Cumple con regulaciones financieras
- Plataformas de Préstamos: Verifica identidad de prestatarios
- Exchanges de Cripto: Cumple requisitos KYC para traders
Marketplaces y Plataformas
- Plataformas P2P: Verifica compradores y vendedores
- Economía Compartida: Valida proveedores de servicios
- Economía Gig: Incorpora freelancers y contratistas
- Plataformas de Alquiler: Verifica inquilinos y anfitriones
Gaming y Apuestas
- Verificación de Edad: Confirma que usuarios son mayores de edad
- Juego Responsable: Implementa programas de autoexclusión
- Cumplimiento Regulatorio: Cumple requisitos de autoridades de juego
- Prevención de Fraude: Verifica identidad de jugadores
Documentos Soportados
Nuestra solución KYC acepta varios documentos de identidad de más de 200 países:- Cédulas de identidad nacional
- Pasaportes
- Licencias de conducir
- Permisos de residencia
- Documentos emitidos por el gobierno
Comenzando
¿Listo para integrar verificación KYC en tu aplicación?Crear Validación KYC
Iniciar una nueva sesión de verificación
Obtener URL de Verificación
Obtener la URL para compartir con usuarios
Integración de Webhooks
Recibir notificaciones en tiempo real
Verificar Estado
Consultar resultados de verificación
Resumen de Endpoints API
| Endpoint | Método | Descripción | Caso de Uso |
|---|---|---|---|
/api/kyc/validations | POST | Crear una nueva validación KYC | Iniciar proceso de verificación |
/api/kyc/validations/{id} | GET | Obtener estado y detalles de validación | Polling manual - verificar estado en cualquier momento |
/api/kyc/entities/{entityId}/current | GET | Obtener validación actual para una entidad | Recuperar validación activa |
/api/kyc/webhooks | POST | Recibir notificaciones webhook | Automático - recibir notificación cuando se complete |