Crear Sesión KYC Bravo
Soluciones Compliance
Crear Sesión KYC Bravo
Crea una nueva sesión para el proceso de verificación de identidad KYC Bravo
POST
Crear Sesión KYC Bravo
Descripción
Este endpoint crea una nueva sesión para el proceso de verificación de identidad KYC Bravo. La sesión permite iniciar un flujo de verificación de identidad para un usuario específico, asociándolo con un identificador de proveedor y configurando una URL de retorno para recibir notificaciones sobre el resultado del proceso. El servicio de KYC Bravo proporciona:- Verificación de identidad: Validación de documentos oficiales
- Prueba de vida: Verificación biométrica del usuario
- Análisis de riesgo: Evaluación de posibles fraudes
- Experiencia digital: Proceso optimizado para dispositivos móviles y web
Autenticación
Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de Autenticación):Parámetros de Consulta
Correo electrónico del usuario que realizará el proceso de verificación
Identificador único del proveedor o referencia interna de tu sistema
URL a la que se enviará la notificación cuando el proceso de verificación haya finalizado
Respuesta
Estado de la respuesta (ej: “success”)
Mensaje descriptivo de la respuesta
Datos de la sesión creada
Estados de la Sesión
Una vez creada la sesión, el proceso de verificación puede pasar por varios estados que serán notificados a través del callback_url:| Estado | Descripción |
|---|---|
PENDING | Sesión creada pero el usuario aún no ha iniciado el proceso |
IN_PROGRESS | Usuario ha iniciado el proceso de verificación |
COMPLETED | Proceso de verificación completado exitosamente |
FAILED | Proceso de verificación fallido |
EXPIRED | La sesión ha expirado sin completar el proceso |
Ejemplo de Solicitud
Ejemplo de Respuesta Exitosa
Notificación de Callback
Cuando el proceso de verificación finaliza, se envía una notificación POST al callback_url configurado con el siguiente formato:Códigos de Error
| Código | Descripción |
|---|---|
| 400 | Solicitud inválida - parámetros faltantes o incorrectos |
| 401 | Token de autenticación inválido o faltante |
| 429 | Demasiadas solicitudes - se ha excedido el límite de rate |
| 500 | Error interno del servidor |