Pular para o conteúdo principal
A Verificação de identidade é um único recurso com três métodos. Você escolhe quais métodos cada país pode usar; o usuário final recebe os que se aplicam ao país que ele seleciona, e a sessão registra qual método de fato produziu o resultado. A captura do documento não mudou. Tudo o que você já configura por meio de documents_allowed (tipos aceitos, subtipos, regras de captura, limiares, avisos) continua funcionando exatamente como antes, e um fluxo de verificação (workflow) que não especifica métodos continua usando apenas a captura do documento.

​
Como cada método funciona

​
Captura do documento

É o que o restante desta seção documenta: o usuário fotografa o documento, a Didit faz a leitura, verifica a autenticidade e retorna os campos extraídos. Disponível em todos os países que a Didit atende, a $0.15 por verificação. Comece pela visão geral da Verificação de identidade.

​
Consulta sem documento

O usuário digita o número do documento nacional de identidade e alguns dados pessoais, e a Didit os verifica na fonte oficial desse país. Nenhuma foto de documento é necessária. Na maioria dos países, essa fonte é um registro governamental, mas não em todos: no Canadá, na França, na Indonésia, nos Países Baixos, na Noruega, em Singapura, no Reino Unido e nos Estados Unidos, trata-se de uma base de birô de crédito, de serviços financeiros, de concessionárias de serviços públicos ou de registros residenciais. Como a procedência e o regime de consentimento aplicável variam conforme a fonte, a fonte exata é indicada por país na tabela abaixo e em Consulta sem documento, nunca de forma genérica. Quando a fonte retorna uma foto (hoje, África do Sul, Nigéria, Argentina e Panamá, todos eles registros governamentais), o usuário também precisa enviar uma selfie. A prova de vida passiva é executada nessa selfie, e ela é comparada com a foto do registro, tudo dentro da consulta e tudo incluído no preço da consulta. Quando a fonte retorna apenas dados, não há com o que comparar o rosto, então nenhuma selfie é capturada; execute Prova de vida e Correspondência facial como etapas próprias do fluxo, se precisar delas. Os campos de requisição, as regras de formato e os regimes de consentimento completos de cada país estão em Consulta sem documento.

​
Carteira

O usuário faz login com uma identidade digital que já possui, como uma eID nacional ou uma identidade bancária. A carteira autentica o usuário e depois compartilha atributos de identidade assinados com a Didit. Dependendo da carteira, o usuário pode informar um código de identificação pessoal ou um número de telefone; nenhuma foto de documento é necessária para a verificação por carteira. A experiência de login depende da carteira: um redirecionamento para o aplicativo, um QR code ou um código de comparação confirmado no telefone do usuário. Smart-ID e Mobile-ID usam um código de comparação. Os atributos de cada carteira, a disponibilidade em produção e a semântica de falhas estão em Carteiras de identidade digital.

​
Níveis de garantia

Todo resultado da Verificação de identidade traz um nível de garantia derivado do método que o produziu. O nível é uma descrição fiel do que foi de fato comprovado, não uma classificação:
Os níveis de garantia são um rótulo voltado para administradores. Eles aparecem no payload da sessão, no console e nas exportações. Os usuários finais nunca veem o nível, o preço nem o nome da fonte consultada.

​
Configurar métodos por país

Os métodos ficam na chave methods da configuração do recurso Verificação de identidade (OCR), indexados pelo código de país ISO 3166-1 alpha-3. Se você omitir a chave, omitir um país ou omitir um método dentro de um país, esse país usará apenas a captura do documento.
Os dois países acima estão como available para consulta no catálogo publicado. O exemplo mantém as carteiras desativadas para não depender de uma carteira habilitada no seu ambiente. Um fluxo que habilita uma carteira marcada como Coming soon é rejeitado, assim como as demais configurações incluídas na mesma operação de salvamento. Quando o catálogo marca uma carteira como available em um país, o bloco de carteiras desse país fica assim:
Consulte o catálogo antes de enviar. Pré-requisito: a carteira consta como disponível para esse país, na lista em Carteiras de identidade digital. Duas regras que a API aplica ao salvar:
  • A disponibilidade é definida pelo servidor. Um método ou uma carteira que o catálogo de recursos não marca como available para esse país é rejeitado. Consulte o catálogo primeiro, pela aba Países do console ou com a ferramenta MCP didit_workflow_get_id_verification_methods_catalog.
  • As carteiras são uma lista de permissões, nunca uma classificação. providers indica quais carteiras um país pode oferecer. A ordem enviada não tem significado e é descartada na normalização; quem escolhe é o usuário final.
A referência completa, campo por campo, incluindo valores padrão e validação, está em Configurações de recursos do fluxo.

​
Fallback: o que acontece quando um método sem documento não é concluído

Quatro opções decidem o que acontece em seguida. Cada uma é fallback_to_document (enviar o usuário para a captura de documento) ou decline (encerrar a sessão com uma Verificação de identidade recusada). As quatro têm fallback_to_document como padrão. id_lookup.max_attempts (de 1 a 5, padrão 1) é o número de consultas respondidas que o usuário tem antes de a opção ser acionada. Um número que não passa na validação de formato no cliente nunca chega ao registro e, por isso, não consome uma tentativa: o usuário apenas é solicitado a corrigi-lo. Uma carteira ou consulta só pode recorrer à captura de documento quando a captura de documento está habilitada para aquele país e pelo menos um tipo de documento é aceito lá. Com a captura de documento desativada, ou sem nenhum tipo de documento aceito para o país, um login que falha ou uma consulta sem correspondência recusa a sessão, mesmo que a opção indique fallback_to_document. Não há para onde recorrer. Uma recusa registra fallback_from na Verificação de identidade recusada, indicando qual método falhou e por quê. A implementação atual em staging também leva essas evidências para a verificação de documento criada após um fallback. Confirme a disponibilização em produção antes de depender dessas evidências adicionais. Um registro que não responde (por timeout ou indisponibilidade) é a exceção: ele nunca recusa o usuário por conta própria. A consulta não é cobrada e nenhuma tentativa é consumida; o usuário é solicitado a tentar novamente. Após três consultas sem resposta na etapa, id_lookup.on_provider_error se aplica: decline recusa a sessão, e fallback_to_document envia o usuário para a captura de documento. Quando essa opção é fallback_to_document, mas o país não tem nenhum documento para o qual recorrer, a consulta continua aberta e o usuário pode continuar tentando; a sessão não é recusada.

​
Oferecer a captura de documento apenas como fallback

Por padrão, um país que oferece uma carteira ou uma consulta de identidade junto com a captura de documento exibe as opções lado a lado na primeira tela. Defina document.fallback_only como true para manter a captura de documento habilitada para o país sem oferecê-la logo de início. Os usuários começam pela carteira ou pela consulta de identidade do país. Com uma única carteira, o usuário vai direto para essa carteira. Somente os usuários cujo login com a carteira falha, é cancelado ou expira, ou cuja consulta não tem correspondência, são levados para a captura de documento. As opções acima ainda determinam quais desses resultados levam à captura de documento, portanto pelo menos uma delas deve ser fallback_to_document.
fallback_only é opcional e tem false como padrão. Ele é rejeitado, a menos que document.enabled seja true e pelo menos uma carteira ou consulta de identidade naquele país recorra à captura de documento. Habilite em documents_allowed os tipos de documento que o fallback deve oferecer, por exemplo passaporte e carteira de identidade na Finlândia.

​
Quanto custa cada método

Estes são preços de tabela: o desconto do seu plano se aplica aos dois métodos. Uma consulta usa as tarifas públicas de varejo da Validação de banco de dados para os serviços que executa; vários serviços podem contribuir para uma mesma tentativa. Na Nigéria, é selecionado NIN ou BVN. A tabela de países mostra o preço completo configurado por tentativa, e cada nova tentativa respondida é cobrada separadamente.

​
Regras de faturamento

  • Um registro que respondeu gera cobrança da consulta. Correspondência, correspondência parcial e ausência de correspondência contam: a consulta foi executada, e a resposta é o produto.
  • Um registro que nunca respondeu não é cobrado. Um erro do provedor não tem custo.
  • Um número que não passa na validação de formato no cliente nunca é cobrado e nunca conta para max_attempts, porque nunca chegou ao registro.
  • A captura de documento é cobrada à parte quando o usuário recorre a ela. Uma consulta que recebeu resposta e em seguida leva o usuário a recorrer a um documento gera duas cobranças, porque duas verificações foram executadas.

​
Cobertura

A captura de documento está disponível em todos os países que a Didit atende e não se repete abaixo: $0.15 por verificação. Esta tabela lista apenas os países onde existe um método sem documento. Um país que não aparece na lista, ou cuja célula indique Não previsto, oferece apenas captura de documento.
A cobertura é gerada a partir do catálogo de capacidades fornecido pelo backend, então esta tabela tem a mesma fonte usada pelo console e pela API para validação. Em breve significa que a entrada aparece no console, mas ainda não pode ser ativada; não é uma capacidade disponível e não tem data prometida.

​
O que chega na sessão

Todo resultado da Verificação de identidade traz o método que o produziu, o nível de garantia e, quando um método não documental foi executado, um bloco de evidências específico desse método. As sessões com documento continuam exatamente como antes, com as novas chaves em null. Os tipos e exemplos campo a campo dos três métodos estão no modelo de dados da Verificação de identidade, e as mesmas chaves chegam no webhook status.updated.

​
Relacionados

Última modificação em 1 de novembro de 2026