--- title: Tratamento de erros canonical: https://developer.unico.io/pt-BR/dual-api/developers/sdks-and-tools/android/error-handling locale: pt-BR generated_by: markdown-export --- 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 ```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 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ódigo | Mensagem | Descriçã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 | :::secondary[Códigos de erro da REST API] Os 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](/dual-api/developers/api-reference/error-codes). :::