Skip to main content
GET
Obtener sesión biométrica actual

Descripción general

Este endpoint devuelve la sesión biométrica más reciente de una entidad (ordenada por createdAt), sin importar el estado: pending, in_progress, approved, rejected, etc. Es el equivalente biométrico de GET /api/kyc/entities/{entityId}/current para validaciones KYC.
Si la entidad nunca tuvo una sesión biométrica, la API responde 200 con null (no 404), igual que el endpoint KYC actual.

Cuándo usarlo

  • Recuperar una sesión pendiente para embeber de nuevo el sessionUrl o cancelarla
  • Consultar el estado del último intento biométrico (status, rejectionCode, decision)
  • Resolver ACTIVE_SESSION_EXISTS al crear una nueva sesión: el id de la sesión activa está en este endpoint (o en activeSessionId del error 409)

Solicitud

Encabezados

Respuesta

200 OK — sesión encontrada

200 OK — sin sesiones

Flujo recomendado

  1. POST /api/kyc/biometric/sessions → guardar id y sessionUrl
  2. Embeber sessionUrl en iframe
  3. Polling: GET /api/kyc/biometric/entities/{entityId}/current o GET /api/kyc/biometric/sessions/{id}
  4. Si necesitás reiniciar: POST /api/kyc/biometric/sessions/{id}/cancel (solo pending / in_progress)

Diferencia con currentSessionId en el listado

GET /api/kyc/biometric/sessions?entityId=... incluye currentSessionId: es la última sesión approved (verificación biométrica vigente). Este endpoint /current devuelve la última sesión creada, que puede estar pending.

Error al crear segunda sesión

Si intentás crear otra sesión con una activa (pending / in_progress), recibís 409 ACTIVE_SESSION_EXISTS con el ID bloqueante:
Cancelá con POST /api/kyc/biometric/sessions/{activeSessionId}/cancel y volvé a crear.

Endpoints relacionados