---
title: Tratamento de erros
canonical: https://developer.unico.io/pt-BR/dual-api/developers/sdks-and-tools/web/web-sdk/error-handling
locale: pt-BR
generated_by: markdown-export
---

Todo o tratamento de erros do Web SDK está centralizado nesta seção. O callback `error` recebe um objeto `ErrorBio` que expõe `getCode()` e `getDescription()`.

## Erros de prepareCamera

| Código | Descrição |
|---|---|
| `73000` | Erro desconhecido e inesperado durante o uso normal das APIs do SDK |
| `73001` | `<property>` é obrigatório |
| `73002` | `<property>` deve ser uma instância de `<class>` |
| `73003` | `<class>` com o nome `<name>` não está disponível para injeção |
| `73004` | O tipo da classe deve ser uma função ou uma classe |
| `73005` | Não foi possível encontrar o locale `<locale>` |
| `73006` | Não foi possível encontrar o texto: `<text>` |
| `73100` | Não foi possível conectar à internet |
| `73200` | Não foi possível encontrar o arquivo JSON do SDK Unico |
| `73201` | Não foi possível carregar o arquivo JSON do SDK Unico |
| `73202` | O arquivo JSON do SDK Unico é inválido |
| `73204` | Não foi possível inicializar o SDK — configure o ambiente via `setEnvironment` no build |
| `73300` | Não foi possível autenticar esta aplicação |
| `73301` | Não foi possível autenticar esta aplicação |
| `73302` | token de autenticação não encontrado |
| `73303` | O host atual não está registrado |
| `73400` | Não foi possível inicializar a câmera |
| `73401` | Não foi possível carregar os modelos de ML para esta câmera |
| `73402` | A chave não pôde ser verificada devido a problemas de conectividade no dispositivo do usuário |
| `73403` | Esta combinação de dispositivo/plataforma/navegador/versão não é suportada pelo SDK |
| `73404` | O dispositivo está em orientação paisagem. O SDK só pode ser usado em modo retrato |
| `73405` | Dispositivo bloqueado devido a múltiplas tentativas falhas |
| `73406` | A inicialização da câmera foi bloqueada — o SDK foi aberto em um iFrame durante o `prepareCamera` |
| `73407` | O SDK não foi totalmente carregado |
| `73500` | Não foi possível obter a sessão |
| `73501` | Não foi possível obter a sessão |
| `73502` | token de sessão não encontrado |
| `73600` | Não foi possível encontrar o recurso de câmera |
| `73601` | Não foi possível iniciar a câmera em modo de produção |
| `74000` | Hexadecimal inválido |
| `74001` | O objeto não é um `UnicoTheme` |

## Erros de openCamera

| Código | Descrição |
|---|---|
| `73700` | Não foi possível analisar a resposta da câmera |
| `73704` | O usuário pressionou o botão cancelar e não completou a sessão |
| `73706` | Acesso à câmera negado — o usuário negou explicitamente a permissão ou a política do dispositivo a bloqueia |
| `73707` | A sessão foi cancelada devido ao encerramento do aplicativo, modo de espera, notificação do SO ou execução em segundo plano |
| `73708` | A sessão foi cancelada porque o dispositivo está em modo paisagem |
| `73710` | A sessão foi cancelada porque o usuário não conseguiu concluí-la dentro do tempo limite estabelecido |
| `73715` | A sessão foi cancelada porque nem todas as imagens de orientação foram configuradas |
| `73716` | A sessão foi cancelada porque o SDK não conseguiu iniciar a câmera neste dispositivo |
| `73717` | A sessão foi cancelada porque o usuário estava em estado de bloqueio |
| `73718` | Erro desconhecido e inesperado durante o uso normal das APIs do SDK |
| `73720` | O desenvolvedor cancelou programaticamente a sessão via API |
| `73721` | A sessão foi cancelada devido a uma mudança de orientação do dispositivo durante a sessão |
| `73722` | A sessão foi cancelada porque o documento não está pronto |
| `73723` | A sessão foi cancelada porque havia outra sessão em andamento |
| `73724` | A sessão ativa foi cancelada porque a sessão da câmera foi iniciada dentro de um iFrame |
| `73728` | Erro de conexão — use HTTPS para conectar |
| `73729` | Navegador não suportado — abra em outro navegador |
| `73730` | Não foi possível inicializar uma sessão de liveness ativo — erro de licença desconhecido |
| `73731` | Não foi possível inicializar uma sessão de liveness ativo — licença expirada |
| `73732` | Não foi possível inicializar uma sessão de liveness ativo — origem não permitida |
| `73750` | A captura falhou porque os olhos do usuário estavam fechados |
| `73760` | A captura falhou por causa da iluminação do ambiente (muito escuro, muito claro ou irregular) |
| `73761` | A captura falhou por causa da distância entre o rosto do usuário e a tela (muito perto ou muito longe) |
| `73762` | A captura falhou porque óculos ou acessórios estão cobrindo o rosto do usuário |
| `73763` | A captura falhou porque o rosto do usuário não estava firme ou alinhado |
| `73764` | A captura falhou por causa do enquadramento do rosto (rosto descentralizado, mais de um rosto ou fundo carregado) |
| `73800` | Não foi possível criptografar a resposta |
| `73900` | Não foi possível obter informações do sistema |

:::secondary[Catálogo oficial de erros]
Os códigos acima refletem o catálogo do Web SDK. O catálogo oficial de códigos de erro multiplataforma está disponível em [Referência de API > Códigos de erro](/dual-api/developers/api-reference/error-codes).
:::

## Tratando o callback

```javascript
const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // tratar o erro
    }
  }
};
```

:::danger[callback obrigatório]
O objeto `callback` é obrigatório. Se não for implementado corretamente (cobrindo os eventos `success` e `error`), o SDK lança uma exceção que, se não tratada, é exibida no console do usuário.
:::