--- title: Tratamento de erros canonical: https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/error-handling locale: pt-BR generated_by: markdown-export --- - [/pt-BR/](/pt-BR/) - [SDKs e Ferramentas](/pt-BR/developers/sdks-and-tools/overview) - [Android SDK](/pt-BR/developers/sdks-and-tools/android/requirements) - Tratamento de erros # Tratamento de erros Todo o tratamento de erros do SDK Android está centralizado nesta seção. O callback `onErrorAcessoBio` recebe um objeto `ErrorBio` com `code` (Int) e `description` (String). Tratando o callback - Kotlin - Java ``` 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 */ } }} ``` ``` @Overridepublic 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 Além de `onErrorAcessoBio`, o SDK também dispara: `onUserClosedCameraManually()` — usuário fechou a câmera manualmente. `onSystemClosedCameraTimeoutSession()` — sessão expirada por timeout. `onSystemChangedTypeCameraTimeoutFaceInference()` — nenhum rosto detectado em 13 segundos; o SDK muda para captura manual. Códigos de erro Todos os códigos de erro têm origem no enum `UnicoException` e são entregues via `ErrorBio(code, message)`. O campo `message` contém a string exata do SDK — não modifique nem localize. CódigoMensagemDescrição`73001``Context invalid`Contexto Android inválido passado ao SDK`73002``Did not grant permission to open camera`Permissão de câmera negada pelo usuário`73003``The lest API is 21(LOLLIPOP`Nível de API do dispositivo abaixo do mínimo exigido (API 21)`73004``Could not find implementation interface callback iAcessoBioSelfie`Interface `iAcessoBioSelfie` não implementada`73005``Could not find implementation interface callback iAcessoBioDocument`Interface `iAcessoBioDocument` não implementada`73006``Unable to open camera on emulators`O SDK não funciona em emuladores — use um dispositivo físico`73007``Unknown and unexpected error in WebApp…`Erro genérico de WebApp (câmera, armazenamento, segurança, rede)`73100``Unable to connect to internet.`Sem conexão com a internet`73200``Please inform the config object or json file name`Objeto de configuração ou arquivo JSON não fornecido`73202``Unable to parse json file`Arquivo de configuração JSON malformado`73204``Unable to initialize the SDK, please configure the environment on setEnviroment method of build``setEnvironment()` não foi chamado antes da inicialização`73300``Unable to get unico authentication object`Falha ao recuperar o objeto de autenticação`73301``Unable to parse object`Falha ao fazer parse da resposta de autenticação`73302``Could not find the unico token`Token de autenticação Unico não encontrado`73303``Current host is not registered`Identificador de bundle não registrado na SDK Key`73400``Could not initialize camera`Falha na inicialização da câmera`73701``Could not find active liveness import`Módulo de liveness ativo não encontrado`73703``Unable to get active liveness session`Falha ao obter uma sessão de liveness`73718``The Session was cancelled because of an unknown and unexpected error…`Erro interno desconhecido na sessão`73721``The Session can't be performed: attempts limit exceeded.`Sessão cancelada — limite de tentativas de captura atingido`73722``The Session can't be performed: face alignment timeout.`Sessão cancelada — timeout de alinhamento facial`73726``An error happened during video recording`Erro de gravação de vídeo durante o liveness`73727``No actions found in a video`Nenhuma ação de liveness detectada no vídeo`73740``The user pressed the do not consent button and did not complete the Session.`Usuário recusou o consentimento`73800``Could not build encrypted key.`Falha ao construir o JWT criptografado`73801``The Session of SDK was cancelled because of an unknown and unexpected error.`Erro interno desconhecido na sessão do SDK`73802``The Session was cancelled because of an unknown and unexpected error…`Sessão cancelada — campos obrigatórios do JWT ausentes`73900``Erro ao analisar imagem`Erro ao analisar a imagem capturada`73901``É necessário implementar a interface AcessoBioListener`Interface `AcessoBioListener` não implementada`73902``É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.`O valor de `setTimeoutSession` deve ser maior que 40 segundos`73903``Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.`Arquivo de configuração corrompido — verifique e tente novamente`73904``Erro ao finalizar processo`Erro ao finalizar o processo de captura`73905``Unable to open document camera`A câmera de documentos não pôde ser aberta`73906``Document type uninformed`Tipo de documento não especificado`74001``onSuccess: not implemented when using open:webAppToken:`Callback `onSuccess` não implementado para User Journey`74100``Could not prepare SDK-S`Falha ao preparar os componentes do SDK`74101``No URL token was provided.`Nenhum token de URL fornecido para a jornada`74102``Environment type was not specified.`Ambiente (`PROD`/`UAT`) não configurado`737120``Unable to initialize liveness`A activity de liveness não pôde ser inicializada`737220``Capture could not start`O processo de captura falhou ao iniciar`737320``Transaction could not start`A transação não pôde ser iniciada`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.`Erro genérico do provedor de sessão — tente novamente Códigos de erro da REST APIOs códigos acima são erros de callback do SDK. Os códigos de erro da REST API (famílias de status HTTP) estão documentados separadamente em [Referência de API > Códigos de erro](/pt-BR/developers/start/error-codes).Última atualização em 8 de out. de 2026**