---
title: Manejo de errores
canonical: https://developer.unico.io/es/dual-api/developers/sdks-and-tools/ios/error-handling
locale: es
generated_by: markdown-export
---

Todo el manejo de errores del SDK de iOS está centralizado en esta sección. El callback `onErrorAcessoBioManager` recibe un objeto `ErrorBio` que expone `getCode()` y `getDescription()`.

## Códigos de error

| Código | Descripción |
|---|---|
| `73000` | La sesión fue cancelada debido a un error desconocido e inesperado. El SDK de Unico Check utiliza diversas APIs de iOS, incluyendo cámara, almacenamiento, seguridad, red y más — este es un error genérico. |
| `73001` | Contexto inválido |
| `73003` | La versión de la API debe ser 13 o más reciente |
| `73006` | No es posible abrir la cámara en emuladores |
| `73100` | No es posible conectarse a internet |
| `73200` | No se encontró el archivo JSON unico_sdk |
| `73202` | No es posible cargar el archivo JSON unico_sdk |
| `73203` | No es posible cargar `AcessoBioConfigDataSource` |
| `73204` | No es posible inicializar el SDK — configure el entorno mediante `setEnvironment` en el build |
| `73300` | No es posible obtener el objeto de autenticación de unico |
| `73301` | No es posible analizar el objeto de autenticación de unico |
| `73302` | No se encontró el token de unico |
| `73701` | No se encontró la importación de liveness activo |
| `73702` | No es posible inicializar el liveness activo en modo producción |
| `73703` | No es posible obtener la sesión de liveness activo |
| `73704` | El usuario presionó el botón de cancelar y no completó la sesión |
| `73705` | La sesión no se realizó correctamente y no se generó un FaceScan |
| `73706` | Acceso a la cámara denegado — el usuario denegó explícitamente el permiso o la política del dispositivo lo bloquea |
| `73707` | La sesión fue cancelada porque la aplicación fue terminada, suspendida, interrumpida por una notificación del SO o enviada al fondo |
| `73708` | La sesión fue cancelada porque el dispositivo está en modo horizontal |
| `73709` | La sesión fue cancelada porque el dispositivo está en modo retrato invertido |
| `73710` | La sesión fue cancelada porque el usuario no pudo completarla dentro del tiempo límite establecido |
| `73711` | La sesión fue cancelada debido a presión de memoria |
| `73712` | La sesión fue cancelada porque tu aplicación no está en producción y requiere una conexión de red |
| `73713` | La sesión fue cancelada porque tu clave necesita ser validada nuevamente |
| `73714` | La sesión fue cancelada porque la clave de cifrado configurada por el desarrollador no era válida |
| `73715` | La sesión fue cancelada porque no todas las imágenes de guía estaban configuradas |
| `73716` | La sesión fue cancelada porque el SDK no pudo iniciar la cámara en este dispositivo |
| `73717` | La sesión fue cancelada porque el usuario se encontraba en un estado bloqueado |
| `73718` | Error desconocido e inesperado durante el uso normal de las APIs de iOS |
| `73719` | La sesión fue cancelada porque el usuario presionó el mensaje de subtexto de la pantalla de preparación |
| `73720` | La sesión no fue procesada |
| `73721` | La sesión no puede realizarse: límite de intentos excedido |
| `73722` | La sesión no puede realizarse: tiempo de espera de alineación facial agotado |
| `73730` | No es posible inicializar una sesión de liveness activo — error de licencia desconocido |
| `73731` | No es posible inicializar una sesión de liveness activo — licencia expirada |
| `73800` | No se pudo construir la clave cifrada |

:::secondary[Catálogo oficial de errores]
Los códigos anteriores reflejan el catálogo del SDK de iOS. El catálogo oficial de códigos de error multiplataforma está disponible en [Referencia de API > Códigos de error](/dual-api/developers/api-reference/error-codes).
:::

## Callbacks del ciclo de vida

Además de `onErrorAcessoBioManager`, el SDK también dispara:

- `onUserClosedCameraManually()` — el usuario cerró la cámara manualmente.
- `onSystemClosedCameraTimeoutSession()` — la sesión expiró por tiempo de espera (valor predeterminado 40 s, mínimo 40 s).
- `onSystemChangedTypeCameraTimeoutFaceInference()` — la detección facial superó el umbral de 13 s; la captura cambia al modo manual.

:::info[Enrutamiento de callbacks para cancelaciones y timeouts]
Los errores `73704` (usuario canceló) y `73710` (timeout de sesión) **no** se entregan a través de `onErrorAcessoBioManager`. Activan directamente los callbacks de ciclo de vida correspondientes:
- `73704` → `onUserClosedCameraManually()`
- `73710` → `onSystemClosedCameraTimeoutSession()`
:::