# Unico Developer Documentation

> Documentação da plataforma Unico de verificação de identidade: casos de uso, capabilities, SDKs e referência de API.

## Docs

- [IDCloud](https://developer.unico.io/pt-BR/index.md): Portal do Desenvolvedor Unico — documentação para APIs de verificação de identidade, SDKs e capabilities do IDCloud para web, Android, iOS e Flutter.
- Construir
  - [Cadastro](https://developer.unico.io/pt-BR/products/sign-up.md): Verifique a identidade de novos clientes em qualquer lugar do mundo e garanta um cadastro seguro. Um conjunto de capabilities em uma única jornada, adaptado ao cenário que você precisa.
    - [Onboarding](https://developer.unico.io/pt-BR/products/sign-up/onboarding/index.md): Verificação de identidade, em qualquer região, com liveness, Verificação de Identidade Biométrica, avaliação de risco de fraude e reutilização de documento.
    - [Verificação sem documento](https://developer.unico.io/pt-BR/products/sign-up/non-document-verification/index.md): Verificação de identidade, em qualquer região, com liveness, Verificação Biométrica de Identidade e avaliação de risco de fraude.
    - [Detecção de Nível de Risco de Fraude](https://developer.unico.io/pt-BR/products/sign-up/fraud-risk-level-detection/index.md): Valida que uma pessoa real está realizando o cadastro combinando Liveness com Alerta Comportamental — sem necessidade de captura de documento ou identificador governamental.
    - [Multi Contas](https://developer.unico.io/pt-BR/products/sign-up/multi-accounts.md): Valide o princípio One Face, One Contract cruzando a biometria facial do usuário com a base de cadastro do seu operador.
  - [Autenticação Avançada](https://developer.unico.io/pt-BR/products/step-up-authentication.md): Verifique a identidade de clientes em qualquer lugar do mundo em fluxos transacionais e garanta um processo seguro. Um conjunto de capacidades em uma única jornada, adaptado ao cenário que você precisa.
    - [Revalidação inteligente](https://developer.unico.io/pt-BR/products/step-up-authentication/smart-revalidation/index.md): Reautentica usuários em transações após o registro, permitindo que os métodos de autenticação variem conforme a experiência desejada e a criticidade do fluxo.
  - [Soluções Regionais](https://developer.unico.io/pt-BR/products/regional-solutions.md): Produtos projetados para atender a pontos críticos da legislação e dos marcos legais regionais — fluxos de verificação de identidade adaptados aos requisitos regulatórios locais.
    - [Verificação de Idade](https://developer.unico.io/pt-BR/products/regional-solutions/age-verification/index.md): Permite comprovar que o usuário atende à idade mínima exigida de forma 100% biométrica, sem atrito com documentos.
    - [Verificação de Dados](https://developer.unico.io/pt-BR/products/regional-solutions/data-verification/index.md): Fornece as informações necessárias sobre uma pessoa para que empresas possam cumprir as regulamentações vigentes para serviços financeiros e iGaming.
    - [Verificação de Cartão Não Presente](https://developer.unico.io/pt-BR/products/regional-solutions/card-not-present-verification/index.md): Valide que a pessoa que está concluindo uma transação sem cartão presente é a legítima titular do cartão de crédito, por meio de biometria facial e verificação de titularidade do cartão.
- Capacidades
  - [Prova de Vida](https://developer.unico.io/pt-BR/capabilities/liveness.md): Capacidade que verifica se o usuário é real e está vivo no momento da captura da selfie. A âncora biométrica de praticamente todos os fluxos do IDCloud.
  - [Verificação de Identidade](https://developer.unico.io/pt-BR/capabilities/identity-verification.md): Capacidade que verifica se o rosto capturado pertence ao titular do documento de identificação.
  - [Classificação de Risco de Fraude](https://developer.unico.io/pt-BR/capabilities/fraud-risk-classification.md): Detecta anomalias comportamentais e fraude de identidade com efeito de rede ao avaliar a transação na dimensão temporal.
  - [Score de Risco](https://developer.unico.io/pt-BR/capabilities/risk-score.md): Capacidade que gera um score probabilístico de fraude, usado junto com a Verificação de Identidade quando o resultado é "inconclusivo".
  - [Validação 1:1](https://developer.unico.io/pt-BR/capabilities/1-1-validation.md): Capability que confirma que o rosto atual é o mesmo utilizado em um processo de referência. Típico de fluxos transacionais.
  - [Reutilização e Captura de Documentos](https://developer.unico.io/pt-BR/capabilities/document-reuse-and-capture.md): Capacidade que solicita, armazena e reutiliza documentos. Reduz o atrito em jornadas com captura de documentos ao oferecer classificação, OCR, FaceMatch e CPF Match.
  - [Retorno de Semelhança do Serpro](https://developer.unico.io/pt-BR/capabilities/serpro-similarity-return.md): Capability específica para crédito consignado (INSS) e operações que exigem comparação com a base do Serpro. Retorna uma pontuação de semelhança entre a selfie capturada e a foto registrada no Serpro.
  - [Revalidação Inteligente](https://developer.unico.io/pt-BR/capabilities/smart-revalidation.md): Reautentica usuários em transações após o registro, permitindo que os métodos de autenticação variem conforme a experiência desejada e a criticidade do fluxo.
  - [Multi Contas](https://developer.unico.io/pt-BR/capabilities/multi-accounts.md): Realiza uma busca biométrica 1:N na base do operador para detectar se um rosto já está vinculado a outra conta ativa.
  - [Verificação de Idade](https://developer.unico.io/pt-BR/capabilities/age-verification.md): Capability que determina se a pessoa diante da câmera é maior de idade, com base em análise biométrica.
  - [Human Token](https://developer.unico.io/pt-BR/capabilities/human-token.md): Deriva um personId estável e opaco a partir de uma selfie — a identidade é o resultado da chamada, não a entrada. Nenhum identificador é declarado pelo usuário.
  - [Cardholder Verification](https://developer.unico.io/pt-BR/capabilities/cardholder-verification.md): Capacidade que confirma que um cartão pertence ao seu titular declarado, reutilizando um processo previamente validado junto com o CPF e os dados do cartão da pessoa.
  - [Fluxos disponíveis](https://developer.unico.io/pt-BR/capabilities/available-flows.md): Catálogo completo de fluxos pré-compostos da plataforma IDCloud — cada um, uma combinação de capacidades pronta, enviada no campo `flow` do POST /v1/process.
- Recursos
  - [Glossário](https://developer.unico.io/pt-BR/resources/glossary.md): Glossário de termos utilizados na documentação do IDCloud — biometria, prova de vida, processos, tokens e conceitos-chave.
  - [FAQ](https://developer.unico.io/pt-BR/resources/faq.md): Perguntas frequentes sobre o IDCloud — integração, autenticação, códigos de erro e plataformas suportadas.
  - [Backtests](https://developer.unico.io/pt-BR/resources/backtests.md): Execute simulações históricas para avaliar o desempenho de capacidades com dados do passado.
  - [Reprocessamento e Importação de Base Biométrica](https://developer.unico.io/pt-BR/resources/reprocessing.md): Guia para reprocessamento de registros biométricos ou importação de base biométrica na plataforma Unico.

## Developers

- [Referência de API](https://developer.unico.io/pt-BR/developers/api-reference.md): Reference for the IDCloud APIs — two public contracts (Web & SDK, API) and a Mexico-only Magic Link integration.
  - [Autenticação](https://developer.unico.io/pt-BR/developers/api-reference/authentication.md): Fluxo OAuth2 JWT Bearer utilizado por todos os contratos do IDCloud. Saiba como obter credenciais, construir a asserção JWT e trocá-la por um token de acesso.
  - [Ambientes](https://developer.unico.io/pt-BR/developers/api-reference/environments.md): Hosts de sandbox e produção para os contratos Web & SDK, API e Magic Link México.
  - [Web e Nativo](https://developer.unico.io/pt-BR/developers/api-reference/web-sdk.md): Utilizado quando a captura biométrica é hospedada pela Unico (iFrame, Redirect ou SDK nativo).
    - [Criar Processo](https://developer.unico.io/pt-BR/developers/api-reference/web-sdk/post-process.md): Crie um processo de verificação. Retorna uma URL de jornada e tokens de SDK que direcionam o usuário para a experiência de captura hospedada pela Unico.
    - [Obter Processo](https://developer.unico.io/pt-BR/developers/api-reference/web-sdk/get-process.md): Recupere o estado atual e o resultado de um processo de verificação.
    - [Fluxos](https://developer.unico.io/pt-BR/developers/api-reference/web-sdk/flows.md): Catálogo de receitas de capacidades disponíveis para o Web SDK, agrupadas por produto, e os valores de resultado que cada uma pode retornar.
    - [Definir Documento do Processo](https://developer.unico.io/pt-BR/developers/api-reference/web-sdk/post-process-document.md): Defina o documento de identificação em um processo criado sem um. Aciona capacidades que requerem um documento.
    - [Obter Selfie](https://developer.unico.io/pt-BR/developers/api-reference/web-sdk/get-selfie.md): Recupera a selfie com marca d'água capturada durante a jornada de verificação.
    - [Obter conjunto de evidências](https://developer.unico.io/pt-BR/developers/api-reference/web-sdk/get-evidence-set.md): Recupere o pacote completo de evidências de captura de um processo — utilizado para conformidade e auditoria regulatória.
  - [API](https://developer.unico.io/pt-BR/developers/api-reference/api.md): Contrato TCA / Check.Integration — utilizado quando o cliente controla a captura e envia a imagem diretamente na requisição.
    - [Criar Processo](https://developer.unico.io/pt-BR/developers/api-reference/api/post-processes.md): Crie um processo de verificação enviando a imagem capturada diretamente. Retorna um resultado síncrono.
    - [Obter Processo](https://developer.unico.io/pt-BR/developers/api-reference/api/get-process.md): Recupere um processo de contrato de API existente pelo seu identificador. Usado para reconsultas, já que os resultados são retornados de forma síncrona na criação.
    - [Fluxos](https://developer.unico.io/pt-BR/developers/api-reference/api/flows.md): Catálogo de receitas de capacidades disponíveis para o contrato de API, agrupadas por produto, e os valores de resultado que cada uma pode retornar.
    - [Obter Documentos Reutilizáveis](https://developer.unico.io/pt-BR/developers/api-reference/api/get-document.md): Verifique se um usuário já possui um documento reutilizável em arquivo antes de iniciar um novo fluxo de captura.
    - [Criar Processo de Documento](https://developer.unico.io/pt-BR/developers/api-reference/api/post-processes-document.md): Capture um novo documento ou reutilize um documento capturado anteriormente vinculado a um processo biométrico.
    - [Verificação de Dados](https://developer.unico.io/pt-BR/developers/api-reference/api/get-lists.md): Consulte dados cadastrais, triagem PEP/AML e vínculo esportivo para um determinado CPF.
    - [Verificação de Idade](https://developer.unico.io/pt-BR/developers/api-reference/api/post-processes-age-validation.md): Crie um processo de Verificação de Idade. Opcionalmente combina detecção de prova de vida e verificação de identidade em uma única requisição.
  - [SSO / SAML](https://developer.unico.io/pt-BR/developers/api-reference/sso-saml.md): Configure o Single Sign-On via SAML para que seus usuários se autentiquem com o próprio provedor de identidade da sua empresa, em vez de credenciais individuais da Unico.
  - [Códigos de erro](https://developer.unico.io/pt-BR/developers/api-reference/error-codes.md): Consolidated catalog of HTTP and platform error codes across Web & SDK, API, and Magic Link contracts.
  - [Rate limits](https://developer.unico.io/pt-BR/developers/api-reference/rate-limits.md): Per-contract rate limits, the Retry-After header, and patterns for staying within budget.
  - [Coleção Postman](https://developer.unico.io/pt-BR/developers/api-reference/postman.md): Coleções Postman prontas para uso para os contratos de Autenticação, Web & SDK e API.
- [SDKs e Ferramentas](https://developer.unico.io/pt-BR/developers/sdks-and-tools/overview.md): Visão geral dos SDKs e ferramentas de integração do IDCloud — Web SDK, Android SDK, iOS SDK, Flutter SDK e API REST.
  - [Android SDK](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/requirements.md): | Requisito | Versão / valor |
    - [Instalação](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/installation.md): Para configurar o SDK no seu projeto, siga os seguintes passos:
      - [Configuração específica](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/installation/specific-setup.md): SDK Key
    - [Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/initialization.md): Inicialize o SDK no carregamento da aplicação — normalmente na classe Application ou no onCreate da sua Activity de entrada. A autenticação do SDK com o backend leva alguns segundos; inicializar cedo evita atraso entre o toque do usuário no botão de captura e a abertura da câmera. Consulte Boas práticas para mais detalhes.
    - Fluxo de captura
      - Tipos de captura
        - [Liveness (selfie biométrica)](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/capture-flow/capture-types/liveness.md): Captura de selfie biométrica com verificação de liveness integrada. O SDK guia o usuário até que um frame biometricamente válido seja obtido via SmartFrames e retorna a imagem como Base64 + JWT (JSON Web Token — um payload assinado enviado ao seu backend para chamar a API REST).
        - [Jornadas do Usuário](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/capture-flow/capture-types/user-journeys.md): Jornadas do Usuário são sessões de captura em múltiplas etapas orquestradas pelo SDK em conjunto com o fluxo configurado. Por exemplo, um fluxo com Prova de Vida + Score de Risco + Captura de Documentos + Assinatura Eletrônica executa selfie, captura de documento e assinatura em uma única sessão.
        - [Revalidação Silenciosa](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/capture-flow/capture-types/silent-revalidation.md): Utiliza o motor da Revalidação Silenciosa, que analisa o contexto comportamental do usuário no efeito de rede Unico, e entrega o sinal de confiança da transação corrente. Ou seja, entregamos o nível de confiança de ser o usuário esperado na transação.
      - [Recebendo o resultado](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/capture-flow/receiving-the-result.md): O SDK retorna o resultado da captura por meio de callbacks definidos na interface de listener utilizada durante a sessão de captura.
    - [Personalização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/customization.md): Essas personalizações estão disponíveis apenas quando o fluxo de captura é document-capture ou liveness.
    - [Tratamento de erros](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/error-handling.md): 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).
    - Referência de API
      - [API de Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/api-reference/initialization-api.md): | Classe | Descrição |
      - [API de Captura](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/api-reference/capture-api.md): Chame estes métodos na interface UnicoCheckCamera obtida pelo builder do SDK. Após a preparação, o callback CameraListener.onCameraReady(cameraOpener) fornece o opener para iniciar a captura.
      - [Interfaces de Callback / Listener](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/api-reference/callback-listener-interfaces.md): Callbacks do ciclo de vida da sessão do SDK. Passe uma implementação para o construtor do AcessoBio.
      - [API de Customização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/api-reference/customization-api.md): Passe a implementação do seu tema ao builder usando setTheme():
      - [Enums](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/api-reference/enums.md): Define o tipo de documento a ser capturado. Passado para prepareDocumentCamera para configurar a sessão de captura.
    - [Recursos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/resources.md): - Inicialize o SDK no carregamento da aplicação, não no clique do botão de captura. A autenticação com o backend leva alguns segundos e, se feita junto com a abertura da câmera, cria uma percepção de atraso.
      - [Problemas conhecidos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/resources/known-issues.md): - O build de release falha mas o debug funciona — provavelmente um problema de obfuscation. Revise as regras do ProGuard/DexGuard.
      - [Notas de versão](https://developer.unico.io/pt-BR/developers/sdks-and-tools/android/resources/release-notes.md): Mantenha sempre o seu SDK Android atualizado com a versão mais recente disponível. Usamos versionamento semântico para numerar nossas versões.
  - [iOS SDK](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/requirements.md): | Requisito | Versão / valor |
    - [Instalação](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/installation.md): Passo 1 — Adicionar a dependência do SDK
      - [Configuração específica](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/installation/specific-setup.md): SDK Key
    - [Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/initialization.md): Implemente o protocolo AcessoBioConfigDataSource na sua classe:
    - Fluxo de captura
      - Tipos de captura
        - [Liveness (selfie biométrica)](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/capture-flow/capture-types/liveness.md): Captura de selfie biométrica com verificação de liveness embarcada, retornando o frame capturado em Base64 e JWT.
        - [Jornadas do Usuário](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/capture-flow/capture-types/user-journeys.md): As Jornadas do Usuário são sessões de captura em múltiplas etapas orquestradas pelo SDK em conjunto com o fluxo configurado. Por exemplo, um fluxo com Prova de Vida + Score de Risco + Captura de Documentos + Assinatura Eletrônica executa selfie, captura de documento e assinatura em uma única sessão.
        - [Revalidação Silenciosa](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/capture-flow/capture-types/silent-revalidation.md): Utiliza o motor da Revalidação Silenciosa, que analisa o contexto comportamental do usuário no efeito de rede Unico, e entrega o sinal de confiança da transação corrente. Ou seja, entregamos o nível de confiança de ser o usuário esperado na transação.
      - [Recebendo o resultado](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/capture-flow/receiving-the-result.md): O SDK retorna o resultado da captura por meio de callbacks definidos nas interfaces de delegate usadas durante a sessão de captura.
    - [Personalização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/customization.md): Essas personalizações estão disponíveis apenas quando o fluxo de captura é document-capture ou liveness.
    - [Tratamento de erros](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/error-handling.md): 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().
    - Referência de API
      - [API de Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/api-reference/initialization-api.md): | Classe | Descrição |
      - [API de Captura](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/api-reference/capture-api.md): | Método | Descrição |
      - [Interfaces de Callback / Listener](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/api-reference/callback-listener-interfaces.md): | Método | Gatilho |
      - [API de Customização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/api-reference/customization-api.md): | Método | Descrição |
      - [Enums](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/api-reference/enums.md): Define o tipo de documento a ser capturado. Passado para openDocument para configurar a sessão de captura.
    - [Recursos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/resources.md): - Inicialize o SDK no carregamento da aplicação (normalmente no didFinishLaunchingWithOptions do AppDelegate ou no viewDidLoad), não no clique do botão de captura. A autenticação com o backend leva alguns segundos e, se feita junto com a abertura da câmera, cria uma percepção de atraso.
      - [Problemas conhecidos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/resources/known-issues.md): - Sombra no final do fluxo — o controle do fluxo é delegado ao chamador do SDK. Se uma sombra aparecer ou a tela não fechar após uma captura bem-sucedida, implemente um release dentro de onSuccessSelfie:
      - [Notas de versão](https://developer.unico.io/pt-BR/developers/sdks-and-tools/ios/resources/release-notes.md): Sempre mantenha seu iOS SDK atualizado com a versão mais recente disponível. Usamos versionamento semântico para numerar nossas versões.
  - [Flutter SDK](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/requirements.md): | Requisito | Versão / valor |
    - [Instalação](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/installation.md): Para configurar o SDK Unico para Flutter, siga os passos abaixo:
      - [Configuração específica](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/installation/specific-setup.md): SDK Key
    - [Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/initialization.md): Inicialize o SDK no carregamento da aplicação — geralmente no main() ou no initState() do widget de entrada. Consulte Boas práticas para detalhes sobre por que você não deve inicializar no clique do botão de captura.
    - Fluxo de captura
      - Tipos de captura
        - [Liveness (selfie biométrica)](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/capture-flow/capture-types/liveness.md): Captura de selfie biométrica com verificação de liveness integrada. O SDK guia o usuário até que um frame biometricamente válido seja obtido via SmartFrames e retorna a imagem em Base64 + JWT.
        - [Jornadas do Usuário](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/capture-flow/capture-types/user-journeys.md): As Jornadas do Usuário são sessões de captura em múltiplas etapas orquestradas pelo SDK em conjunto com o fluxo configurado. Por exemplo, o fluxo idchecktrustdocssign executa selfie + documento + assinatura em uma única sessão.
        - [Revalidação Silenciosa](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/capture-flow/capture-types/silent-revalidation.md): Utiliza o motor da Revalidação Silenciosa, que analisa o contexto comportamental do usuário no efeito de rede Unico, e entrega o sinal de confiança da transação corrente. Ou seja, entregamos o nível de confiança de ser o usuário esperado na transação.
      - [Recebendo o resultado](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/capture-flow/receiving-the-result.md): O SDK retorna o resultado da captura por meio de callbacks definidos na interface de listener usada durante a sessão de captura.
    - [Personalização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/customization.md): Essas personalizações estão disponíveis apenas quando o fluxo de captura é document-capture ou liveness.
    - [Tratamento de erros](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/error-handling.md): Todo o tratamento de erros do Flutter SDK está centralizado nesta seção. Os callbacks onErrorUnico, onErrorSelfie e onErrorDocument recebem um objeto UnicoError que expõe getCode() e getDescription().
    - Referência de API
      - [API de Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/api-reference/initialization-api.md): | Classe | Descrição |
      - [API de Captura](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/api-reference/capture-api.md): | Método | Descrição |
      - [Interfaces de Callback / Listener](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/api-reference/callback-listener-interfaces.md): | Método | Gatilho |
      - [API de Personalização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/api-reference/customization-api.md): | Método | Descrição |
      - [Enums](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/api-reference/enums.md): Define o tipo de documento a ser capturado. Passado para openCameraDocument para configurar a sessão de captura.
    - [Recursos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/resources.md): - Use o plugin Flutter oficial. Não implemente os SDKs nativos via bridges — essa abordagem gera erros não mapeados pelo time de Engenharia da Unico.
      - [Problemas conhecidos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/resources/known-issues.md): - O build de release falha, mas o debug funciona — provavelmente um problema de obfuscation no lado Android. Os SDKs nativos não podem ser obfuscados. Revise as regras ProGuard/DexGuard.
      - [Notas de Versão](https://developer.unico.io/pt-BR/developers/sdks-and-tools/flutter/resources/release-notes.md): Registro de alterações do Unico Flutter SDK — histórico de versões, novas funcionalidades, correções de bugs e atualizações dos SDKs nativos Android e iOS.
  - [Integração Web](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web.md): Opções de integração client-side para o contrato Web & SDK — fluxos de redirecionamento, iFrame SDK e a biblioteca de captura JavaScript.
    - [Web SDK](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/requirements.md): O frame de captura suporta WebRTC e versões mais recentes dos navegadores listados abaixo. O funcionamento não é garantido em versões muito antigas.
      - [Instalação](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/installation.md): Configure a CSP, instale o pacote do Web SDK e baixe os arquivos de recursos necessários para a captura de Prova de Vida.
        - [Configuração específica](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/installation/specific-setup.md): SDK Key
      - [Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/initialization.md): Inicialize o SDK o mais cedo possível — normalmente quando a página ou componente que contém o frame de captura é carregado. Consulte Boas práticas para detalhes sobre por que você não deve inicializar ao clicar no botão de captura.
      - Fluxo de captura
        - Tipos de captura
          - [Liveness (selfie biométrica)](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/liveness.md): Captura de selfie biométrica com verificação de liveness integrada. O SDK guia o usuário até que um frame biometricamente válido seja obtido via SmartFrames e retorna a imagem como Base64 + JWT.
          - [Captura de documento](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/document-capture.md): Captura de documentos de identidade. O SDK apresenta um frame para auxiliar o usuário no posicionamento do documento; após o posicionamento, o usuário clica no botão para capturar a foto.
        - [Recebendo o resultado](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/capture-flow/receiving-the-result.md): O SDK retorna o resultado da captura por meio do objeto callback passado para open(). Ambos os handlers success e error são obrigatórios.
        - [Coleta de Dados de Monitoramento](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection.md): Metadados opcionais que você pode anexar a qualquer sessão de captura para identificar o usuário e o fluxo em ferramentas de monitoramento e observabilidade.
      - [Personalização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/customization.md): O Web SDK suporta duas dimensões de personalização: idioma e tema visual.
      - [Tratamento de erros](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/error-handling.md): 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().
      - [Acessibilidade](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/accessibility.md): O SDK implementa componentes preparados com atributos HTML para acessibilidade — aria-label, tabindex, role, entre outros — que habilitam a navegação pelo teclado entre elementos, ativam orientação por áudio e são utilizados por softwares de leitura de tela.
      - Referência de API
        - [API de Inicialização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/api-reference/initialization-api.md): | Classe | Descrição |
        - [API de Captura](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/api-reference/capture-api.md): | Método | Descrição |
        - [Interfaces de Callback / Listener](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/api-reference/callback-listener-interfaces.md): O Web SDK utiliza um único objeto callback passado para open(), em vez de interfaces de listener específicas por plataforma.
        - [API de Personalização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/api-reference/customization-api.md): | Método | Descrição |
        - [Enums](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/api-reference/enums.md): Define o modo de câmera para captura de selfie. Passado para prepareSelfieCamera.
      - [Recursos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/resources.md): - Inicialize o SDK no carregamento da página, não ao clicar no botão de captura. A autenticação com o backend leva alguns segundos e, se feita junto com a abertura da câmera, cria uma percepção de lentidão.
        - [Problemas conhecidos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/resources/known-issues.md): - CSP bloqueia o carregamento do SDK — sem as diretivas de CSP necessárias (worker-src, script-src, etc.), o Web SDK não consegue carregar Web Workers e recursos adicionais. Revise a configuração de CSP.
        - [Notas de Versão](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-sdk/resources/release-notes.md): Mantenha sempre o seu Web SDK atualizado com a versão mais recente disponível. Utilizamos versionamento semântico para numerar nossas versões.
    - [Integração de Aplicativo Web](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-integration.md): Como integrar o contrato Web & SDK no lado do cliente — fluxos de redirecionamento e configuração do iFrame SDK.
      - [Recursos](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-integration/resources.md): Boas práticas e notas de versão para integração com o SDK Web App Integration da Unico (unico-journey-sdk).
        - [Notas de Versão](https://developer.unico.io/pt-BR/developers/sdks-and-tools/web/web-integration/resources/release-notes.md): Changelog do SDK de Web App Integration da Unico (unico-journey-sdk) — histórico de versões, novos recursos e notas de atualização.
  - [Capture Standard](https://developer.unico.io/pt-BR/developers/sdks-and-tools/capture-standard.md): Para desempenho otimizado das capabilities da plataforma IDCloud, recomendamos utilizar nossos SDKs (Web, Android, iOS, Flutter). Eles garantem o melhor funcionamento do produto como um todo, tanto em termos de taxa de abandono quanto na validação de Liveness.
  - [Boas Práticas](https://developer.unico.io/pt-BR/developers/sdks-and-tools/best-practices-for-sdk-implementation.md): Diretrizes para integrar, atualizar, testar e publicar os SDKs da Unico com segurança, incluindo as regras do ambiente de homologação (UAT).
  - [Política de Atualização](https://developer.unico.io/pt-BR/developers/sdks-and-tools/update-policy.md): Política de atualização dos SDKs da Unico: por que ela existe, os prazos mínimos que o cliente deve cumprir e como permanecer suportado e protegido.
- [Webhooks e Eventos](https://developer.unico.io/pt-BR/developers/webhooks-and-events.md): Introdução aos webhooks do IDCloud — receba notificações em tempo real para eventos de processos de verificação de identidade.
  - [Configuração](https://developer.unico.io/pt-BR/developers/webhooks-and-events/setup.md): Guia passo a passo para configurar webhooks do IDCloud — autoatendimento via portal para Web e SDK, e configuração por cliente para integrações via API usando a orquestração Check (apenas Brasil).
  - [Tipos de evento](https://developer.unico.io/pt-BR/developers/webhooks-and-events/event-types.md): Referência dos tipos de eventos de webhook do IDCloud — payloads de processo concluído, falha e mudança de status.
  - [Segurança](https://developer.unico.io/pt-BR/developers/webhooks-and-events/security.md): Como validar e proteger payloads de webhook do IDCloud — verificação de assinatura e boas práticas.
  - [Estratégia de Fallback](https://developer.unico.io/pt-BR/developers/webhooks-and-events/fallback.md): Como recuperar resultados de processos quando o serviço de webhook está temporariamente indisponível.
- [Integração com Agentes de IA](https://developer.unico.io/pt-BR/developers/llms.md): Leia esta documentação a partir de agentes de IA e ferramentas de LLM com a versão em Markdown de cada página, um índice llms.txt por idioma e a barra de ações.
- Soluções Regionais
  - [Verificação de Cartão Não Presente](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification.md): Documentação da REST API da Verificação de Cartão Não Presente — combine identificação do comprador e validação da titularidade do cartão de crédito em transações de pagamento.
    - Sobre a Verificação de Cartão Não Presente
      - [O que é a Verificação de Cartão Não Presente](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/about-idpay/unico-id-pay.md): O que é a Verificação de Cartão Não Presente e as garantias que ele oferece para transações de pagamento: prova de vida, correspondência de identidade do titular do cartão e proteção de liability.
      - [Funcionalidades](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/about-idpay/feature.md): As principais funcionalidades da Verificação de Cartão Não Presente: Transações de Pagamento e Onboarding de Cartão de Crédito, e como elas se diferenciam.
      - [Casos de uso](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/about-idpay/use-cases.md): Casos de uso da Verificação de Cartão Não Presente em checkout, pré-análise, ferramenta de mesa de análise, recuperação de vendas e onboarding de cartão de crédito.
      - [Chargeback](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/about-idpay/chargeback.md): A garantia de liability de chargeback da Unico para validações da Verificação de Cartão Não Presente: quando se aplica, pré-requisitos e exclusões.
    - [Integração](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/overview.md): Visão geral da integração com a Verificação de Cartão Não Presente: autentique-se, personalize a experiência, crie uma transação e trate a notificação do webhook.
      - [Autenticação](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication.md): A Verificação de Cartão Não Presente utiliza autenticação OAuth2 por conta de serviço (two-legged) para emitir access tokens para a REST API.
        - [Criando uma Conta de Serviço](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication/creating-a-service-account.md): Como solicitar uma conta de serviço para autenticação server-to-server da Verificação de Cartão Não Presente, incluindo a geração do par de chaves.
        - [Preparando para fazer uma requisição autenticada à API](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication/preparing-authenticated-request.md): Como montar e assinar o JWT, requisitar um access token da plataforma OAuth2 e tratar a resposta e expiração do token.
        - [Recursos adicionais](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources.md): Recursos de apoio para a autenticação da Verificação de Cartão Não Presente: um exemplo de implementação em JavaScript, códigos de erro de autenticação e a collection do Postman.
          - [Exemplo em Javascript](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/example-in-javascript.md): Implementação de referência em JavaScript para montar e assinar o JWT e requisitar um access token da Verificação de Cartão Não Presente.
          - [Erros de autenticação](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/authentication-errors.md): Códigos de erro retornados pela plataforma de autenticação OAuth2 da Verificação de Cartão Não Presente e como resolver cada um.
          - [Postman Collection](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/postman-collection.md): Collection do Postman pronta para uso para a REST API de Verificação de Cartão Não Presente: transações de pagamento, chargeback e onboarding de cartão de crédito.
      - [APIs](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis.md): Todos os endpoints disponíveis do produto Verificação de Cartão Não Presente: API Reference, Erros e Enumerados.
        - [Referência de API](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference.md): Referência de endpoints da REST API da Verificação de Cartão Não Presente: transações de pagamento, chargeback, onboarding de cartão de crédito e sinais de contexto.
          - [Transações de pagamento](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions.md): Referência da REST API para criar transações de pagamento, consultar status, recuperar evidências e reenviar notificações na Verificação de Cartão Não Presente.
          - [Chargeback](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/chargeback.md): Referência da REST API para solicitar uma análise de chargeback e consultar seu status na Verificação de Cartão Não Presente.
          - [Onboarding de cartão de crédito](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding.md): Referência da REST API para validar um cartão de crédito e consultar o status de validação na funcionalidade de Onboarding de Cartão de Crédito da Verificação de Cartão Não Presente.
          - [Sinais de contexto](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/context-signals.md): Referência da REST API para consultar a avaliação de risco de fraude (autofraude ou engenharia social) de uma transação de crédito concluída na Verificação de Cartão Não Presente.
        - [Erros](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/errors.md): Visão geral dos códigos de status HTTP e respostas de erro retornadas pelos endpoints da REST API da Verificação de Cartão Não Presente.
        - [Enumerados](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated.md): Enumerações utilizadas na REST API da Verificação de Cartão Não Presente: códigos de resultado de transação e de chargeback.
      - [Webhook](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/webhook.md): Como configurar e receber notificações do webhook da Verificação de Cartão Não Presente, incluindo formato de requisição/resposta e considerações importantes como rate limit e idempotência.
      - [Controlando a experiência](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/overview.md): Como funciona a integração do SDK da Verificação de Cartão Não Presente — padrões Webview, SDK e Redirect, e as etapas de API necessárias antes de integrar na sua aplicação.
        - [Requisitos](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/requirements.md): Versões mínimas de SO e matriz de compatibilidade de navegador/SO para o frame de captura do SDK da Verificação de Cartão Não Presente.
        - Mobile
          - [Android](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/android.md): Gerenciando a experiência de captura da Verificação de Cartão Não Presente no Android via CustomTabs: dependência, abertura da tab, configuração do manifest e leitura do callback.
          - [iOS](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios.md): Duas abordagens recomendadas para gerenciar a experiência de captura da Verificação de Cartão Não Presente no iOS: WKWebView e ASWebAuthenticationSession.
            - [WKWebView](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/wkwebview.md): Como implementar a experiência de captura da Verificação de Cartão Não Presente no iOS usando WKWebView: abertura da view, controle de fechamento e permissões necessárias.
            - [ASWebAuthenticationSession](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/aswebauthenticationsession.md): Como implementar a experiência de captura da Verificação de Cartão Não Presente no iOS usando ASWebAuthenticationSession: controlador de autenticação, configuração da sessão e permissões necessárias.
          - [Flutter](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/flutter.md): Gerenciando a experiência de captura da Verificação de Cartão Não Presente no Flutter via inappwebview: abertura da webview, monitoramento de mudança de URL e permissão de câmera.
        - Web
          - [SDK](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/sdk.md): Como implementar o SDK da Unico para web: instalação, métodos init/open, orientação de tela cheia e o modelo de segurança de iFrame + token de autenticação.
          - [Redirect (deprecated)](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/redirect-deprecated.md): Modelos de integração web depreciados da Verificação de Cartão Não Presente: window.open() e redirect de página inteira. Prefira o SDK para melhor conversão.
      - [Personalizações](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/customizations.md): Opções de personalização de logo, cor e formato de botões para a experiência da Verificação de Cartão Não Presente, com recomendações de contraste de acessibilidade.
      - [Verificação Silenciosa](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/silent-verification.md): Habilite a verificação em segundo plano para usuários recorrentes na Verificação de Cartão Não Presente, usando sinais e recorrência para decidir se uma transação pode ser aprovada silenciosamente.
    - Ajuda e FAQ
      - [Boas práticas de comunicação](https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/help-and-faq/best-communication-practices.md): Dicas para comunicar a validação biométrica de identidade da Verificação de Cartão Não Presente aos seus usuários finais, reduzindo fricção e chamados de suporte.

## Product Guide

- [Product Guide](https://developer.unico.io/pt-BR/product-guide.md): Manuais de operação dos produtos Unico — como usar cada tela, cada campo e cada configuração, passo a passo.
- [Portal IDCloud](https://developer.unico.io/pt-BR/product-guide/portal-idcloud.md): Guias de operação do Portal IDCloud — configure a experiência do seu cliente, as notificações para o seu sistema e a validação por QR Code.
  - Configurações
    - [Customização da Jornada](https://developer.unico.io/pt-BR/product-guide/portal-idcloud/settings/journey-customization.md): Configure a identidade visual da jornada — logo, cores, fundo e formato dos botões — direto no Portal IDCloud, com pré-visualização em tempo real.
    - [Webhook](https://developer.unico.io/pt-BR/product-guide/portal-idcloud/settings/webhook.md): Configure para onde o IDCloud notifica o seu sistema quando uma jornada muda de estado, como ele se autentica na sua API e o que fazer quando a sua API não responde.
    - [QR Code](https://developer.unico.io/pt-BR/product-guide/portal-idcloud/settings/qr-code.md): Ative a exibição do QR Code na jornada de validação para o seu cliente continuar o processo no celular, direto no Portal IDCloud.