Skip to main content
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

email
string
required
Correo electrónico del usuario que realizará el proceso de verificación
vendor_id
string
required
Identificador único del proveedor o referencia interna de tu sistema
callback_url
string
required
URL a la que se enviará la notificación cuando el proceso de verificación haya finalizado

Respuesta

status
string
Estado de la respuesta (ej: “success”)
message
string
Mensaje descriptivo de la respuesta
data
object
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:
EstadoDescripción
PENDINGSesión creada pero el usuario aún no ha iniciado el proceso
IN_PROGRESSUsuario ha iniciado el proceso de verificación
COMPLETEDProceso de verificación completado exitosamente
FAILEDProceso de verificación fallido
EXPIREDLa 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ódigoDescripción
400Solicitud inválida - parámetros faltantes o incorrectos
401Token de autenticación inválido o faltante
429Demasiadas solicitudes - se ha excedido el límite de rate
500Error interno del servidor