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

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

## Códigos de erro

| Código | Descrição |
|---|---|
| `73000` | A sessão foi cancelada por um erro desconhecido e inesperado. O Unico Check SDK utiliza diversas APIs do iOS, incluindo câmera, armazenamento, segurança, rede e outras — este é um erro genérico para situações não previstas. |
| `73001` | Contexto inválido |
| `73003` | A versão da API precisa ser 13 ou superior |
| `73006` | Não foi possível abrir a câmera em emuladores |
| `73100` | Sem conexão com a internet |
| `73200` | Arquivo JSON unico_sdk não encontrado |
| `73202` | Não foi possível carregar o arquivo JSON unico_sdk |
| `73203` | Não foi possível carregar `AcessoBioConfigDataSource` |
| `73204` | Não foi possível inicializar o SDK — configure o ambiente via `setEnvironment` no build |
| `73300` | Não foi possível obter o objeto de autenticação unico |
| `73301` | Não foi possível interpretar o objeto de autenticação unico |
| `73302` | Token unico não encontrado |
| `73701` | Importação de liveness ativo não encontrada |
| `73702` | Não foi possível inicializar o liveness ativo em modo de produção |
| `73703` | Não foi possível obter a sessão de liveness ativo |
| `73704` | O usuário pressionou o botão de cancelamento e não concluiu a sessão |
| `73705` | A sessão não foi concluída com sucesso e um FaceScan não foi gerado |
| `73706` | Acesso à câmera negado — o usuário negou explicitamente a permissão ou a política do dispositivo bloqueia o acesso |
| `73707` | A sessão foi cancelada porque o app foi encerrado, entrou em modo de espera, recebeu uma notificação do sistema operacional ou foi enviado para segundo plano |
| `73708` | A sessão foi cancelada porque o dispositivo está no modo paisagem |
| `73709` | A sessão foi cancelada porque o dispositivo está no modo retrato invertido |
| `73710` | A sessão foi cancelada porque o usuário não conseguiu concluí-la dentro do tempo limite configurado |
| `73711` | A sessão foi cancelada devido a pressão de memória |
| `73712` | A sessão foi cancelada porque seu app não está em produção e requer uma conexão de rede |
| `73713` | A sessão foi cancelada porque sua chave precisa ser validada novamente |
| `73714` | A sessão foi cancelada porque a chave de criptografia configurada pelo desenvolvedor não era válida |
| `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 iOS |
| `73719` | A sessão foi cancelada porque o usuário pressionou o texto de subtítulo da tela de preparação |
| `73720` | A sessão não foi processada |
| `73721` | A sessão não pode ser realizada: limite de tentativas excedido |
| `73722` | A sessão não pode ser realizada: timeout de alinhamento facial |
| `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 |
| `73800` | Não foi possível construir a chave criptografada |

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

## Callbacks do ciclo de vida

Além de `onErrorAcessoBioManager`, o SDK também dispara:

- `onUserClosedCameraManually()` — o usuário fechou a câmera manualmente.
- `onSystemClosedCameraTimeoutSession()` — a sessão expirou por timeout (padrão 40 s, mínimo 40 s).
- `onSystemChangedTypeCameraTimeoutFaceInference()` — a detecção facial excedeu o limite de 13 s; a captura muda para o modo manual.

:::info[Roteamento de callbacks para cancelamentos e timeouts]
Os erros `73704` (usuário cancelou) e `73710` (timeout de sessão) **não** são entregues através de `onErrorAcessoBioManager`. Eles acionam diretamente os callbacks de ciclo de vida correspondentes:
- `73704` → `onUserClosedCameraManually()`
- `73710` → `onSystemClosedCameraTimeoutSession()`
:::