Pular para o conteúdo principal
A etapa de Verificação de identidade em um fluxo de verificação (workflow) tem uma aba Countries. É nela que você decide, país por país, qual dos três métodos uma pessoa pode usar e o que acontece quando um método sem documento não dá resultado. Tudo o que você define na aba é gravado na chave methods do nó de Verificação de identidade: o console e a Management API são duas visões do mesmo objeto.

​
Países e métodos de identificação permitidos

Abra um fluxo, selecione o nó Verificação de identidade e depois Países. Cada linha de país mostra os métodos que ele aceita. Escolha um país para abrir o editor dele. Os interruptores de Recorrer à captura do documento quando… ficam desativados sempre que o país não tem captura do documento, porque não há captura do documento à qual recorrer. Ative Captura do documento para o país para poder usá-los. Um país em que você desativa todos os métodos é rejeitado ao salvar com No method enabled — nobody can verify here, porque essa configuração não consegue verificar ninguém.

​
Oferecer a captura do documento apenas como alternativa

Em Recorrer à captura do documento quando… (exibido junto com as configurações de Carteiras e de Consulta sem documento), o interruptor Offer document capture only as the fallback tira a captura do documento da primeira tela. Os usuários começam pela carteira ou pela consulta sem documento do país, e apenas os usuários cujo login falha, é cancelado ou expira, ou cuja consulta não tem correspondência, são levados à captura do documento. Com uma única carteira, o usuário vai direto para essa carteira. Deixe-o desativado para mostrar a carteira ou a consulta lado a lado com a captura do documento. O interruptor fica indisponível enquanto a captura do documento estiver desativada para o país ou enquanto nenhum interruptor de alternativa estiver ativado para recorrer à captura do documento. Ele grava document.fallback_only.

​
A disponibilidade é definida pelo servidor

A aba lê o mesmo catálogo de capacidades usado pela API na validação, então ela só pode oferecer o que a plataforma realmente suporta:
  • Um método que o catálogo não oferece naquele país não aparece como opção.
  • Uma fonte ou carteira que o catálogo marca como Em breve é listada para que você veja o roadmap, mas não pode ser ativada.
  • O login por carteira é ativado por ambiente. Enquanto estiver desativado, todas as carteiras aparecem como Em breve, independentemente do que o catálogo diga.

​
Ativar Smart-ID ou Mobile-ID

Smart-ID e Mobile-ID estão disponíveis nos países em que são suportados. Consulte o catálogo de carteiras para ver a cobertura por país. Use a disponibilidade exibida no seu ambiente atual antes de alterar um fluxo.
  1. Abra Workflows, selecione o fluxo e o nó Verificação de identidade dele e, em seguida, abra Países.
  2. Abra o editor do país e localize Carteiras aceitas.
  3. Selecione Smart-ID ou Mobile-ID somente se estiver disponível; deixe a captura do documento ativada se quiser uma alternativa.
  4. Escolha o que deve acontecer quando um login por carteira falhar e, em seguida, salve e publique o fluxo.
  5. Inicie uma nova sessão de verificação usando esse fluxo e confira o cartão Credential da sessão concluída.
O guia de integração do Smart-ID e do Mobile-ID lista os códigos de país suportados e o fluxo com código de comparação que o usuário vê. Um teste bem-sucedido em staging ou sandbox não ativa a carteira em produção.

​
Requisição e resposta esperadas

See details de uma fonte de consulta ou de uma carteira abre a requisição e a resposta esperadas: o que é solicitado ao usuário final, em linguagem simples, e o que a fonte retorna. Cada fonte de consulta é nomeada com exatidão (um registro governamental na maioria dos países, um birô de crédito ou um cadastro residencial em alguns), porque é isso que determina a procedência e o regime de consentimento. O usuário final nunca vê os campos da resposta, o nome da fonte nem o preço.

​
Interruptores em massa

Global settings ativa um método em todos os países que o suportam, para que você não precise percorrer 36 países manualmente. O editor por país continua prevalecendo: ative um método globalmente e depois desative-o no único país em que você não o quer.

​
Preços na aba

A captura do documento mostra o preço: $0.15 por verificação. Uma consulta sem documento mostra o preço por país, e qualquer preço que o catálogo de preços ainda não publicou aparece na aba identificado como provisório, em vez de ser apresentado como uma cotação. Uma linha de carteira mostra a carteira, a cobertura e a disponibilidade dela. A aba também explica a consequência de faturamento de cada opção de fallback da consulta, para que o custo de uma configuração fique visível antes de você salvá-la:
  • A consulta é cobrada quando um registro responde (tanto uma correspondência quanto uma ausência de correspondência contam), e a captura do documento é cobrada adicionalmente quando o usuário recorre a ela.
  • Uma consulta que nunca retornou não é cobrada, então uma indisponibilidade custa apenas o preço do documento.
  • Se você desativar uma alternativa, esses usuários têm a solicitação recusada; nada mais é cobrado.

​
Como ler uma sessão

O bloco Verificação de identidade nos detalhes de uma sessão traz um chip com o método que o gerou e um segundo chip com o seu nível de garantia: Documento / Documentary, Consulta sem documento / Data match ou o nome da carteira com Cryptographic.
Uma sessão que passou de um método sem documento para a captura de documento aparece como uma sessão Documento / Documentary. A API ainda não registra o método tentado primeiro quando o fallback é bem-sucedido. O campo fallback_from só é preenchido quando a opção do país estava como decline e a sessão foi recusada. Por isso, o console não tem dados para mostrar um histórico do tipo “tentou isto, depois aquilo”. Para ver qual método sem documento foi tentado, use a lista de verificações da sessão.
Abaixo dos chips, cada método mostra suas próprias evidências:
  • Documento: sem alterações. Mostra as imagens da frente, do verso e da selfie, as pontuações de qualidade, os campos extraídos e os avisos.
  • Consulta sem documento: uma Comparação com o registro que lista cada campo comparado com o que o usuário informou, o que a fonte tinha e um resultado Correspondência, Parcial ou Sem correspondência, além do nome da fonte, do horário da consulta e do número de tentativas. Uma fonte que não respondeu aparece em uma linha própria, com um erro em vez de um resultado por campo. Quando a fonte retornou uma foto, essa foto e a selfie do usuário aparecem lado a lado com a pontuação facial.
  • Carteira: o cartão Credencial, com a carteira, a autoridade emissora, o tipo de credencial, o nível de garantia declarado, quando ela foi verificada, se a assinatura era válida e os atributos que a carteira compartilhou.
Quando uma fonte ou uma carteira não compartilha nenhuma foto, o painel informa isso em vez de deixar um quadro vazio. Não há nada com que fazer a correspondência facial, e a Prova de vida e a Correspondência facial são executadas como etapas próprias se o fluxo as incluir.

​
Conteúdo relacionado

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