--- title: Manejo de errores canonical: https://developer.unico.io/es/dual-api/developers/sdks-and-tools/android/error-handling locale: es generated_by: markdown-export --- Todo el manejo de errores del SDK de Android está centralizado en esta sección. El callback `onErrorAcessoBio` recibe un objeto `ErrorBio` con `code` (Int) y `description` (String). ## Manejo del callback ### Kotlin ```kotlin override fun onErrorAcessoBio(error: ErrorBio) { when (error.code) { 73002 -> { /* camera permission denied — redirect to app settings */ } 73006 -> { /* running on emulator — physical device required */ } 73100 -> { /* no internet connection */ } else -> { /* generic error handling */ } } } ``` ### Java ```java @Override public void onErrorAcessoBio(ErrorBio error) { switch (error.getCode()) { case 73002: /* camera permission denied — redirect to app settings */ break; case 73006: /* running on emulator — physical device required */ break; case 73100: /* no internet connection */ break; default: /* generic error handling */ } } ``` ## Callbacks de ciclo de vida Además de `onErrorAcessoBio`, el SDK también activa: - `onUserClosedCameraManually()` — el usuario cerró la cámara manualmente. - `onSystemClosedCameraTimeoutSession()` — la sesión expiró por tiempo de espera. - `onSystemChangedTypeCameraTimeoutFaceInference()` — no se detectó ningún rostro durante 13 segundos; el SDK cambia a captura manual. ## Códigos de error Todos los códigos de error provienen del enum `UnicoException` y se entregan mediante `ErrorBio(code, message)`. El campo `message` contiene la cadena exacta del SDK — no la modifique ni localice. | Código | Mensaje | Descripción | |---|---|---| | `73001` | `Context invalid` | Contexto de Android no válido pasado al SDK | | `73002` | `Did not grant permission to open camera` | El usuario denegó el permiso de cámara | | `73003` | `The lest API is 21(LOLLIPOP` | El nivel de API del dispositivo está por debajo del mínimo requerido (API 21) | | `73004` | `Could not find implementation interface callback iAcessoBioSelfie` | Interfaz `iAcessoBioSelfie` no implementada | | `73005` | `Could not find implementation interface callback iAcessoBioDocument` | Interfaz `iAcessoBioDocument` no implementada | | `73006` | `Unable to open camera on emulators` | El SDK no funciona en emuladores — use un dispositivo físico | | `73007` | `Unknown and unexpected error in WebApp…` | Error genérico de WebApp (cámara, almacenamiento, seguridad, red) | | `73100` | `Unable to connect to internet.` | Sin conexión a internet | | `73200` | `Please inform the config object or json file name` | Objeto de configuración o archivo JSON no proporcionado | | `73202` | `Unable to parse json file` | El archivo de configuración JSON está malformado | | `73204` | `Unable to initialize the SDK, please configure the environment on setEnviroment method of build` | `setEnvironment()` no fue llamado antes de la inicialización | | `73300` | `Unable to get unico authentication object` | Error al recuperar el objeto de autenticación | | `73301` | `Unable to parse object` | Error al analizar la respuesta de autenticación | | `73302` | `Could not find the unico token` | Token de autenticación de Unico no encontrado | | `73303` | `Current host is not registered` | Identificador de bundle no registrado en la SDK Key | | `73400` | `Could not initialize camera` | Error en la inicialización de la cámara | | `73701` | `Could not find active liveness import` | Módulo de liveness activo no encontrado | | `73703` | `Unable to get active liveness session` | Error al obtener una sesión de liveness | | `73718` | `The Session was cancelled because of an unknown and unexpected error…` | Error interno desconocido en la sesión | | `73721` | `The Session can't be performed: attempts limit exceeded.` | Sesión cancelada — límite de intentos de captura alcanzado | | `73722` | `The Session can't be performed: face alignment timeout.` | Sesión cancelada — tiempo de espera de alineación facial | | `73726` | `An error happened during video recording` | Error de grabación de vídeo durante el liveness | | `73727` | `No actions found in a video` | No se detectaron acciones de liveness en el vídeo | | `73740` | `The user pressed the do not consent button and did not complete the Session.` | El usuario rechazó el consentimiento | | `73800` | `Could not build encrypted key.` | Error al construir el JWT cifrado | | `73801` | `The Session of SDK was cancelled because of an unknown and unexpected error.` | Error interno desconocido en la sesión del SDK | | `73802` | `The Session was cancelled because of an unknown and unexpected error…` | Sesión cancelada — campos obligatorios del JWT ausentes | | `73900` | `Erro ao analisar imagem` | Error al analizar la imagen capturada | | `73901` | `É necessário implementar a interface AcessoBioListener` | Interfaz `AcessoBioListener` no implementada | | `73902` | `É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.` | El valor de `setTimeoutSession` debe ser mayor de 40 segundos | | `73903` | `Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.` | Archivo de configuración dañado — verifique e inténtelo de nuevo | | `73904` | `Erro ao finalizar processo` | Error al finalizar el proceso de captura | | `73905` | `Unable to open document camera` | No se pudo abrir la cámara de documentos | | `73906` | `Document type uninformed` | Tipo de documento no especificado | | `74001` | `onSuccess: not implemented when using open:webAppToken:` | Callback `onSuccess` no implementado para User Journey | | `74100` | `Could not prepare SDK-S` | Error al preparar los componentes del SDK | | `74101` | `No URL token was provided.` | No se proporcionó token de URL para la jornada | | `74102` | `Environment type was not specified.` | Entorno (`PROD`/`UAT`) no configurado | | `737120` | `Unable to initialize liveness` | La actividad de liveness no pudo inicializarse | | `737220` | `Capture could not start` | El proceso de captura no pudo iniciarse | | `737320` | `Transaction could not start` | La transacción no pudo iniciarse | | `737321` | `The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.` | Error genérico del proveedor de sesión — inténtelo de nuevo | :::secondary[Códigos de error de la REST API] Los códigos anteriores son errores de callback del SDK. Los códigos de error de la REST API (familias de estado HTTP) están documentados por separado en [Referencia de API > Códigos de error](/dual-api/developers/api-reference/error-codes). :::