Pular para o conteúdo principal
A verificação de conta confirma que uma conta bancária pertence à pessoa que o seu fluxo de verificação (workflow) já verificou, a partir dos dados da conta que ela digita. Não há login no banco nem tela de consentimento: a pessoa informa a conta no formato usado no país dela, e o banco confere o nome do titular com o nome que uma etapa anterior verificou. É um dos dois métodos de Verificação bancária, ao lado do login no banco, e o valor do método é account_lookup. O envio de extrato e os microdepósitos continuam como alternativas depois desses dois, e a pessoa sempre pode continuar sem banco. Para verificar uma conta a partir do seu backend sem sessão, por exemplo antes de um pagamento, use a API de verificação de conta.
A Verificação bancária ainda não está habilitada em produção. Até que esteja, você não pode adicionar esta etapa a um fluxo nem chamar esta API, nem em produção nem no sandbox, e esta página descreve como ela vai funcionar.
A Verificação bancária confirma quem é o titular de uma conta com base em uma identidade que outra etapa estabeleceu, portanto não é, por si só, uma prova de identidade. Coloque Verificação de identidade, Validação de banco de dados, um questionário ou expected_details antes da etapa. A pessoa nunca digita um nome para a verificação: a Didit sempre compara o nome que a sessão já verificou.

​
Como funciona

1

A pessoa escolhe o país

Na etapa de Verificação bancária, a pessoa escolhe um dos países oferecidos pela etapa. Nos países em que a verificação de conta vem primeiro, a etapa abre um formulário curto no formato de conta daquele país. Nos países em que o login no banco vem primeiro, a pessoa escolhe Informe os dados da sua conta para chegar ao formulário.
2

A pessoa digita os dados da conta

Por exemplo, um IBAN, um sort code e um número de conta, ou uma CLABE. O fluxo de verificação monta o formulário a partir do que a API retorna para aquele país, então um país que a Didit adicionar depois não exige nenhuma mudança do seu lado.
3

A Didit verifica o formato primeiro

Antes de qualquer cobrança, a Didit verifica cada valor: o comprimento, os caracteres, os dígitos verificadores e, no caso de um IBAN, se ele pertence ao país selecionado. Um valor reprovado é recusado com a indicação do campo a corrigir. A pessoa corrige no mesmo lugar, e nenhuma tentativa é consumida.
4

O banco confere o nome do titular

A Didit executa uma verificação com base no nome que a sessão verificou. Qualquer outro dado enviado pelo cliente é ignorado.
5

A etapa decide

A resposta se torna um resultado de propriedade, e as ações da etapa o transformam no veredito exatamente como fazem no login no banco.

​
Onde a verificação é oferecida

A cobertura é definida por país. A Didit habilita a verificação país a país, assim que tem uma rota com preço definido ali; um país sem essa rota não a oferece. Novos países são adicionados ao longo do tempo, e a etapa sempre lê a lista atual, então você nunca precisa alterar sua integração quando um país é adicionado. Em um país coberto, os métodos da etapa decidem se a pessoa a vê:
  • A ordem da etapa. bank_method_order define quais métodos todos os países oferecem e qual vem primeiro. O padrão, ["open_banking", "account_lookup"], começa pelo login no banco e oferece a verificação de conta como alternativa.
  • A ordem própria de um país. methods em um país de bank_countries substitui a ordem da etapa naquele país, por exemplo ["account_lookup"] para oferecer apenas a verificação de conta, ou ["account_lookup", "open_banking"] para começar por ela.
  • Um banco fora do ar. Onde um país oferece a verificação de conta, ela também serve de alternativa para um banco cujo login no banco esteja degradado ou fora do ar: a etapa passa para o formulário de conta antes de qualquer pedido de consentimento, enquanto a pessoa ainda tiver verificações de conta disponíveis.
  • A verificação usa as rotas da própria Didit. Uma etapa que usa o seu próprio provedor do marketplace (provider_key) só a oferece com fallback_to_native ativado.
  • Contas empresariais. Em uma sessão de verificação empresarial, a verificação compara uma conta empresarial com a empresa verificada, nos países em que a Didit verifica contas empresariais.
Veja Escolha os métodos por país para conhecer as regras seguidas ao salvar.

​
O que a pessoa digita

Estes são os formatos de conta que o formulário reconhece. Não se trata de uma lista de cobertura: a execução da verificação em um país depende de onde ela é oferecida, e a etapa sempre mostra os campos exatos daquele país. Em alguns países, o formulário também pede um número de registro: para contas empresariais e, em alguns poucos países, para todas as contas. Espaços, hífens e pontos são removidos e as letras são convertidas para maiúsculas antes de um valor ser verificado, então a pessoa pode digitar a conta do jeito que o banco dela a imprime.

​
Ativar

Uma nova etapa oferece a verificação de conta por padrão, como alternativa ao login bancário. Para começar por ela, ou para oferecê-la sozinha, coloque account_lookup em primeiro lugar na ordem:
Estas configurações definem a verificação:

​
Resultados

​
Verificações que retornam uma resposta

Cada uma delas é cobrada uma vez e consome uma das verificações de conta da pessoa (bank_account_check_max_attempts). Até a etapa ser concluída, a pessoa pode tentar novamente com outra conta enquanto restarem verificações. O resultado fica em ownership.result, exceto no caso de uma conta que não existe, que fica em connection.reason_code. Com bank_account_check_accept_close_match desativado, as duas correspondências aproximadas passam a ser no_match, com o código de motivo OWNER_NAME_MISMATCH: a pessoa nunca é solicitada a confirmar o nome, e bank_no_match_action decide. O login bancário mantém suas correspondências próximas em qualquer caso. Quando a pessoa já usou todas as verificações de conta, e todas as tentativas de login bancário quando o país também oferece login bancário, sem uma conexão bem-sucedida, a etapa continua aberta enquanto ainda permitir o envio de extrato com tentativas restantes: consulte O envio de extrato. Quando não resta nenhuma opção, a etapa termina com bank_attempts_exhausted_action (DECLINE por padrão), a menos que uma tentativa anterior já tenha chegado a um veredito, como uma divergência de nome. Nesse caso, esse veredito prevalece.

​
Resultados que não geram cobrança

Nenhum destes consome uma verificação. Cada um aparece em connection.reason_code.

​
Na decisão

A decisão da sessão lista a etapa em bank_verifications[]. Depois que uma conta é avaliada, method indica account_lookup. Enquanto nenhuma conta tiver sido avaliada, method e ownership são null, e connection.reason_code informa o motivo, por exemplo ACCOUNT_NOT_FOUND, PROVIDER_UNAVAILABLE ou REFERENCE_IDENTITY_MISSING. Nenhum banco é escolhido para a verificação, então connection.institution_id, connection.institution_name e connection.oauth são null, e connection.institution_country é o país que a pessoa escolheu. A Didit não mantém acesso à conta depois que a etapa é concluída, então uma verificação que terminou em correspondência indica connection.status: revoked com reason_code: VERIFICATION_COMPLETED. O resultado em si permanece na sessão. Uma verificação de conta não lê saldos, transações nem renda. Quando a etapa os solicita, financial_data.not_collected os lista; consulte Dados financeiros exigem login bancário.
O exemplo mostra apenas os campos discutidos nesta página. Depois que uma conta é avaliada, leia method para distinguir uma verificação de conta do login bancário: é o único campo destinado a isso.

​
Em regras de fluxo e relatórios

  • Ramificações e regras de status: bank.method é account_lookup (Verificação da conta no construtor de regras), e bank.reason_code pode ser ACCOUNT_NOT_FOUND.
  • Relatório PDF da sessão: a linha Método de verificação indica Verificação da conta.

​
Preços

Cada verificação que retorna uma resposta gera uma cobrança de Verificação bancária: correspondência, correspondência aproximada, não correspondência, conta que não pôde ser verificada e conta não encontrada são todas cobradas. Um valor recusado antes da verificação, uma verificação indisponível e uma sessão sem nome verificado para comparar nunca são cobrados. O preço é definido por país: consulte Preços da Verificação bancária. A verificação de conta é um método pago independente, nunca um fallback: bank_fallback_used_action não é disparado por ela. Após uma verificação cobrada, os microdepósitos e o envio do extrato estão incluídos sem custo adicional na mesma sessão, quando a etapa os ativa e o país os oferece.

​
Teste no sandbox

Em uma aplicação de sandbox, a verificação é executada em um serviço simulado e nada é cobrado. O sandbox oferece os dois métodos em todos os países, na ordem definida pela etapa: com a ordem padrão, escolha Informe os dados da sua conta para executar a verificação, ou defina bank_method_order como ["account_lookup", "open_banking"] para iniciar por esse método. Os últimos quatro caracteres da conta que a pessoa digita (o IBAN ou, na falta dele, o número da conta) determinam a resposta. Qualquer outro final corresponde ao nome verificado. O sandbox registra cada verificação respondida como uso sem custo, para que você veja quais verificações uma sessão em produção cobraria. IBAN, CLABE e CBU têm dígitos verificadores, então não basta alterar os últimos quatro caracteres. Use estes valores, que passam em todas as validações de formato:
A API de verificação de conta retorna respostas para uma chave de sandbox com base nas mesmas terminações, sem sessão. Consulte Testes no sandbox para saber como as aplicações de sandbox funcionam em geral.
Última modificação em 1 de novembro de 2026