Saltar para o conteúdo principal
A Bank Verification confirma que uma conta bancária pertence à pessoa ou empresa que um passo anterior do seu fluxo verificou. Trata-se de um passo do fluxo com dois métodos: a pessoa inicia sessão no seu banco ou introduz os dados da sua conta e o banco confirma o nome na conta. Você escolhe que métodos cada país disponibiliza e qual surge em primeiro lugar.
Em produção, o início de sessão no banco funciona na Nigéria e na Nova Zelândia, e a verificação de conta funciona na Nigéria, no Gana e no Quénia. Mais países são adicionados ao longo do tempo, e os Preços da Bank Verification mostram sempre o que cada país disponibiliza atualmente.
A Bank Verification compara o titular da conta com uma identidade estabelecida por outro passo, pelo que não constitui um comprovativo de identidade por si só. Coloque a Verificação de identidade, a Validação de base de dados, um questionário ou expected_details antes do passo. A pessoa nunca introduz o nome verificado: a Didit compara sempre o nome que a sessão já verificou.

​
Os dois métodos

Ambos os métodos fornecem o mesmo tipo de resultado: se o titular corresponde, o titular devolvido pelo banco e a conta mascarada. Os métodos diferem consoante o país, e um país pode disponibilizar um deles, ambos ou ambos em qualquer ordem. Consulte a verificação de conta para conhecer os formatos de conta, resultados e valores de sandbox. O carregamento de extrato e os microdepósitos mantêm-se como alternativas de recurso após os dois métodos (bank_statement_enabled, bank_microdeposits_enabled), e a pessoa pode sempre continuar sem banco. Os microdepósitos só são disponibilizados após uma tentativa cobrada de início de sessão no banco ou de verificação de conta na mesma sessão, sem custos adicionais. O carregamento de extrato também está incluído após uma dessas tentativas e pode igualmente surgir sem qualquer tentativa bancária prévia, em qualquer país. Consulte Quando a pessoa não consegue verificar o seu banco.

​
O que a pessoa vê

Em cada país, a pessoa começa pelo primeiro método disponibilizado pelo país. O segundo serve de recurso:
  • Primeiro o início de sessão no banco: o seletor de bancos abre-se. A sua última linha, Introduza os dados da sua conta, inicia a verificação de conta. Se o início de sessão no banco falhar, a mesma linha surge novamente em Outras formas de verificar.
  • Primeiro a verificação de conta: o formulário de conta abre-se, com uma ligação Inicie sessão no seu banco em alternativa por baixo.
  • Apenas um método: a pessoa vê apenas esse método.
Quando um país disponibiliza a verificação de conta, esta também funciona como alternativa para um banco que o início de sessão no banco não consegue alcançar no momento, por estar degradado ou indisponível: a pessoa avança para o formulário de conta antes de ser solicitado qualquer consentimento, desde que ainda tenha verificações de conta disponíveis. Um método que nenhuma rota suporte num determinado país é omitido nesse país, para que a pessoa nunca veja um método que não possa ser executado. Um país que nenhuma rota suporte de todo disponibiliza apenas as suas alternativas de recurso e Continuar sem o seu banco.

​
Escolher os métodos por país

​
A ordem do passo

O parâmetro bank_method_order define que métodos o passo disponibiliza, e em que ordem, para todos os países que não definem uma ordem própria. Lista open_banking, account_lookup ou ambos, com o primeiro a surgir em primeiro lugar.
Ao guardar sem enviar bank_method_order, é assumido ["open_banking", "account_lookup"]: primeiro o início de sessão no banco, com a verificação de conta como recurso. Uma lista vazia é recusada com Choose a method: bank sign-in, account check, or both. A ordem do passo é um valor predefinido. Num país onde nenhuma rota suporte um dos seus métodos, esse método é omitido e o país disponibiliza os restantes. Um país suportado por uma rota, mas que a ordem deixe sem nenhum método, é recusado ao guardar, por exemplo Choose a method: bank sign-in, account check, or both. ARE offers account check. Um país que nenhuma rota suporte de todo é mantido, apenas com as suas alternativas de recurso: consulte Um país que nenhuma rota bancária suporta.

​
A ordem própria de um país

O campo methods de um país em bank_countries substitui a ordem do passo para esse país. A pessoa começa pelo primeiro método e o segundo é disponibilizado como alternativa.
Aqui, o Reino Unido segue a ordem do passo, a Noruega disponibiliza apenas o início de sessão no banco e o México começa pela verificação de conta com o início de sessão no banco como recurso. Um país com methods definido como null, ou sem essa chave, segue a ordem do passo. A configuração é recusada, em bank_countries.<ISO3>, quando um país ativado:
  • define methods como uma lista vazia, mesmo num país que nenhuma rota suporte, ou
  • indica um método que nenhuma rota suporte nesse local, por exemplo Account check is not available in NOR.
Um país que nenhuma rota suporte de todo omite methods, ou define-o como null, e disponibiliza apenas as suas alternativas de recurso: consulte Um país que nenhuma rota bancária suporta.

​
Na consola

No passo de verificação bancária, Países e métodos lista cada país com o que o início de sessão no banco e a verificação de conta aí disponibilizam, e qual dos métodos surge em primeiro lugar. As suas predefinições preenchem todos os países de uma só vez: Uma predefinição nunca deixa um país sem nenhum método: quando um país dispõe de apenas um dos dois métodos, esse método permanece ativo.

​
Os dados financeiros requerem início de sessão bancário

Apenas o início de sessão no banco lê saldos, transações e rendimentos. Quando o passo os solicita em bank_scopes e um país disponibiliza a verificação de conta, uma pessoa que efetue a verificação por verificação de conta prossegue sem esses dados. O passo não falha: o resultado lista o que não foi recolhido em financial_data.not_collected.
not_collected é uma lista vazia sempre que o método recolheu tudo o que o passo solicitou. Para exigir os dados, disponibilize apenas o início de sessão no banco nos países onde necessita deles.

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

Estas chaves moldam apenas a verificação de conta. O início de sessão no banco mantém as suas próprias definições. As tentativas são contabilizadas por método. bank_max_attempts conta as tentativas de início de sessão no banco, e um micro-depósito ou envio de extrato bancário também gasta uma delas. bank_account_check_max_attempts conta as verificações de conta. O passo termina em bank_attempts_exhausted_action assim que todas as formas de verificação que continuam disponíveis para a pessoa, incluindo o envio de extrato, tenham esgotado as suas tentativas sem uma ligação bem-sucedida: consulte O envio de extrato.

​
Ler o método no resultado

​
Decisão e webhooks

Cada passo de Bank Verification é um item de bank_verifications[] na decisão da sessão e no objeto decision dos webhooks status.updated. O respetivo method indica 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: consulte Ler o 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 abordados nesta página. Todos os campos estão no esquema SessionDecision da referência da API.

​
Regras de fluxo

As ramificações e as regras de estado personalizadas leem o mesmo valor como bank.method, identificado como 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 um passo de Triagem AML que envia uma verificação de conta com uma pontuação de risco elevada para revisão:

​
Relatório da sessão

O relatório PDF da sessão indica o método na sua linha Método de verificação.

​
Nós guardados antes dos métodos

bank_open_banking_enabled e bank_account_lookup_enabled foram descontinuados. Um nó guardado antes da existência de bank_method_order é agora executado com a ordem que os seus dois interruptores definiam: Onde a verificação de conta estava ativada a par do início de sessão no banco, a pessoa vê-a agora como alternativa no seletor de bancos, Introduza os dados da sua conta, e não apenas quando o seu banco está indisponível. Um nó com ambos os interruptores desativados, que oferecia apenas micro-depósitos ou o envio de extrato, é mantido como está; uma gravação posterior deve ativar pelo menos um dos dois métodos. Durante uma única versão, uma gravação que não envie bank_method_order mas envie qualquer um dos interruptores continuará a definir a ordem a partir dos interruptores. Cada gravação volta a gravar ambos os interruptores, indicando se algum país oferece o início de sessão no banco e se algum país oferece a verificação de conta. Utilize bank_method_order e bank_countries.<ISO3>.methods em novas integrações.

​
Preços

Cada método é faturado pelo seu próprio preço, por país. Consulte os preços do Bank Verification para obter os preços de cada país.
  • O início de sessão no banco tem o seu próprio preço, e os complementos de saldo e de transações acrescentam cada um o seu custo.
  • A verificação de conta é faturada uma vez por cada verificação a que o banco responda: uma correspondência, uma correspondência próxima, uma não correspondência, uma conta que não foi possível verificar e uma conta que não foi encontrada. Uma conta recusada com os dados introduzidos nunca é faturada.
Onde um país disponibiliza ambos os métodos, uma sessão pode ter qualquer um dos preços, dependendo do método que a pessoa utilizar. O envio de extrato e os micro-depósitos estão incluídos sem custos adicionais após uma tentativa cobrada. Um envio de extrato sem nenhuma tentativa bancária anterior custa $0.20, e continuar sem banco nunca é faturado: consulte 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.

​
Testar na sandbox

Uma aplicação sandbox disponibiliza ambos os métodos em todos os países, na ordem definida pelo passo, e não fatura nada. Com a ordem predefinida, a pessoa começa no início de sessão no banco e escolhe Introduza os dados da sua conta para executar a verificação de conta. Para começar na verificação de conta, defina bank_method_order como ["account_lookup", "open_banking"]. Os últimos quatro carateres da conta determinam a resposta da verificação de conta: consulte Testar na sandbox.

​
Conteúdo relacionado

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