Pular para o conteúdo principal
Verificação bancária confirma que uma conta bancária pertence à pessoa ou à empresa que uma etapa anterior do seu fluxo de verificação (workflow) verificou. É uma única etapa do fluxo com dois métodos: a pessoa faz login no banco ou digita os dados da conta e o banco confirma o nome do titular. Você escolhe quais métodos cada país oferece e qual vem primeiro.
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 no ambiente de produção nem no sandbox. Esta página descreve como ela vai funcionar.
Verificação bancária compara o titular da conta à identidade que outra etapa estabeleceu, então ela não comprova identidade sozinha. Coloque Verificação de identidade, Validação de banco de dados, um questionário ou expected_details antes da etapa. A pessoa nunca digita o nome que é verificado: a Didit sempre compara o nome que a sessão já verificou.

​
Os dois métodos

Os dois métodos geram o mesmo tipo de resultado: se o titular corresponde, o titular que o banco retornou e a conta mascarada. Os métodos variam por país, e um país pode oferecer um deles, os dois, ou os dois em qualquer ordem. Consulte a verificação de conta para ver os formatos de conta, os resultados e os valores de sandbox. O envio de extrato e os microdepósitos continuam sendo alternativas depois dos dois métodos (bank_statement_enabled, bank_microdeposits_enabled), e a pessoa sempre pode continuar sem um banco. Os microdepósitos só são oferecidos depois de um login no banco ou de uma verificação de conta cobrados na mesma sessão, sem custo adicional. O envio de extrato também está incluído depois de um deles e também pode vir sem nenhuma tentativa bancária antes, em qualquer país. Consulte Quando a pessoa não consegue verificar o banco.

​
O que a pessoa vê

Em cada país, a pessoa começa pelo primeiro método que o país oferece. O segundo é a alternativa:
  • Login no banco primeiro: o seletor de bancos é aberto. A última linha, Informe os dados da sua conta, inicia a verificação de conta. Se o login no banco falhar, a mesma linha aparece de novo em Outras formas de verificar.
  • Verificação de conta primeiro: o formulário da conta é aberto, com um link Em vez disso, faça login no seu banco abaixo dele.
  • Um único método: a pessoa vê apenas esse método.
Onde um país oferece a verificação de conta, ela também serve de alternativa para um banco que o login no banco não consegue alcançar no momento, porque o banco está instável ou fora do ar: a pessoa passa para o formulário da conta antes de qualquer pedido de consentimento, desde que ainda tenha verificações de conta disponíveis. Um método que nenhuma rota atende em um país fica de fora nesse país, então a pessoa nunca vê um método que não pode ser executado. Um país para o qual não há nenhuma rota oferece apenas as alternativas e Continuar sem o seu banco.

​
Escolha os métodos por país

​
A ordem da etapa

bank_method_order define quais métodos a etapa oferece, e em que ordem, para cada país que não define a sua própria ordem. A lista contém open_banking, account_lookup ou os dois, com o primeiro método listado primeiro.
Um salvamento que não envia bank_method_order recebe ["open_banking", "account_lookup"]: login no banco primeiro e a verificação de conta como alternativa. Uma lista vazia é recusada com Choose a method: bank sign-in, account check, or both. A ordem da etapa é um padrão. Em um país onde nenhuma rota atende um dos seus métodos, esse método fica de fora e o país oferece os demais. Um país que uma rota atende, mas que fica sem nenhum método pela ordem, é recusado ao salvar, por exemplo Choose a method: bank sign-in, account check, or both. ARE offers account check. Um país que nenhuma rota atende é mantido, apenas com as alternativas: consulte Um país que nenhuma rota bancária atende.

​
A ordem própria de um país

methods em um país de bank_countries substitui a ordem da etapa para esse país. A pessoa começa pelo primeiro método e tem o segundo como alternativa.
Aqui, o Reino Unido segue a ordem da etapa, a Noruega oferece apenas o login no banco e o México começa pela verificação de conta, com o login no banco como alternativa. Um país com methods definido como null, ou sem a chave, segue a ordem da etapa. O salvamento é recusado, em bank_countries.<ISO3>, quando um país habilitado:
  • define methods como uma lista vazia, mesmo em um país que nenhuma rota atende, ou
  • indica um método que nenhuma rota atende nesse país, por exemplo Account check is not available in NOR.
Um país que nenhuma rota atende omite methods, ou o define como null, e oferece apenas as alternativas: consulte Um país que nenhuma rota bancária atende.

​
No console

Na etapa de Verificação bancária, Countries and methods lista cada país, indicando a disponibilidade do login no banco e da verificação de conta, além de qual método vem primeiro. As predefinições preenchem todos os países de uma vez: Uma predefinição nunca deixa um país sem nada: quando um país tem apenas um dos dois métodos, esse método permanece disponível.

​
Dados financeiros exigem login no banco

Apenas o login no banco lê saldos, transações e renda. Quando a etapa os solicita em bank_scopes e um país oferece a verificação de conta, uma pessoa que faz a verificação por verificação de conta é aprovada sem esses dados. A etapa não falha: o resultado lista o que não foi coletado em financial_data.not_collected.
not_collected é uma lista vazia sempre que o método coletou tudo o que a etapa solicitou. Para exigir os dados, ofereça apenas o login no banco nos países em que você precisa deles.

​
Configurações da verificação de conta

Estas chaves afetam apenas a verificação de conta. O login no banco mantém suas próprias configurações. As tentativas são contadas por método. bank_max_attempts conta as tentativas de login no banco, e um microdepósito ou envio de extrato também consome uma delas. bank_account_check_max_attempts conta as verificações de conta. A etapa termina em bank_attempts_exhausted_action quando todas as formas de verificar a pessoa que ainda são oferecidas, incluindo o envio de extrato, tiverem consumido suas tentativas sem uma conexão bem-sucedida: veja O envio de extrato.

​
Leia o método no resultado

​
Decisão e webhooks

Cada etapa de Verificação bancária é um item de bank_verifications[] na decisão da sessão e no objeto decision dos webhooks status.updated. Seu method informa como a conta foi verificada: method é null até que uma conta tenha sido avaliada, e none quando a pessoa continuou sem banco antes de qualquer tentativa ser avaliada: veja Leia no resultado. Leia method, e não ownership.method, para distinguir os métodos: ownership.method é a comparação de nomes que produziu a pontuação, como exact ou fuzzy.
O exemplo mostra apenas os campos discutidos nesta página. Todos os campos estão no schema SessionDecision da referência da API.

​
Regras do fluxo

Ramificações e regras de status personalizadas usam o mesmo valor de bank.method, chamado Bank Verification Method no construtor de regras, com os valores Bank Sign-in, Account Check, Micro-deposits, Statement Upload e Continued Without a Bank. Uma regra compara o valor do método, por exemplo, uma ramificação após uma etapa de Análise AML que envia para revisão uma verificação de conta com pontuação de risco alta:

​
Relatório da sessão

O relatório PDF da sessão indica o método na linha Verification method.

​
Nós salvos antes dos métodos

bank_open_banking_enabled e bank_account_lookup_enabled foram descontinuados. Um nó salvo antes da existência de bank_method_order agora opera seguindo a ordem definida por seus dois controles: Quando a verificação de conta estava ativada junto com o login no banco, a pessoa agora a vê como opção de reserva no seletor de bancos, Informe os dados da sua conta, e não apenas quando o banco dela está fora do ar. Um nó com os dois controles desativados, que oferecia apenas microdepósitos ou envio de extrato, permanece como está; um salvamento posterior deve ativar pelo menos um dos dois métodos. Durante uma versão, um salvamento que não envia bank_method_order, mas envia qualquer um dos controles, ainda define a ordem a partir dos controles. Cada salvamento grava novamente os dois controles, indicando se algum país oferece o login no banco e se algum país oferece a verificação de conta. Use bank_method_order e bank_countries.<ISO3>.methods em novas integrações.

​
Preços

Cada método é cobrado pelo seu próprio preço, por país. Veja os preços da Verificação bancária para conferir os preços de cada país.
  • O login no banco tem seu próprio preço, e os complementos de saldo e de transações adicionam, cada um, o seu.
  • A verificação de conta é cobrada uma vez por cada verificação a que o banco responde: uma correspondência, uma correspondência próxima, nenhuma correspondência, uma conta que ele não conseguiu verificar e uma conta que ele não encontrou. Uma conta recusada da forma como foi digitada nunca é cobrada.
Onde um país oferece os dois métodos, uma sessão pode custar qualquer um dos preços, dependendo do método que a pessoa usa. O envio de extrato e os microdepósitos estão incluídos sem custo adicional após uma tentativa cobrada. Um envio de extrato sem tentativa bancária anterior custa $0.20, e continuar sem um banco nunca é cobrado: veja Preços. A API de verificação de conta executa a mesma verificação a partir do seu backend, sem sessão, pelo mesmo preço da verificação de conta.

​
Teste no sandbox

Uma aplicação de sandbox oferece os dois métodos em todos os países, na ordem definida pela etapa, e não cobra nada. Com a ordem padrão, a pessoa começa no login no banco e escolhe Informe os dados da sua conta para executar a verificação de conta. Para começar pela verificação de conta, defina bank_method_order como ["account_lookup", "open_banking"]. Os quatro últimos caracteres da conta determinam a resposta da verificação de conta: veja Teste no sandbox.

​
Relacionados

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