Saltar para o conteúdo principal
A verificação de conta confirma que uma conta bancária pertence à pessoa que o seu fluxo já verificou, a partir dos dados da conta introduzidos por ela. Não há início de sessão bancário nem ecrã de consentimento: a pessoa introduz a sua conta no formato utilizado no seu país, e o banco confirma o nome associado à mesma face ao nome verificado num passo anterior. É um dos dois métodos de Verificação bancária, juntamente com o início de sessão bancário, e o valor do método é account_lookup. O envio de extrato bancário e os microdepósitos permanecem como alternativas de recurso após ambos, e a pessoa pode sempre continuar sem verificação bancária. Para verificar uma conta a partir do seu backend sem uma sessão, por exemplo antes de um pagamento, utilize a API de verificação de conta.
A Verificação bancária confirma a propriedade de uma conta face a uma identidade estabelecida por outro passo, pelo que não constitui uma prova 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 deste passo. A pessoa nunca escreve um nome para a verificação: a Didit compara sempre o nome que a sessão já verificou.

​
Como funciona

1

A pessoa escolhe o seu país

No passo de Verificação bancária, a pessoa escolhe um país disponibilizado pelo passo. Quando a verificação de conta surgir em primeiro lugar, o passo abre um formulário curto no formato de conta desse país. Quando o início de sessão bancário surgir primeiro, a pessoa escolhe Introduza os dados da sua conta para aceder ao formulário.
2

A pessoa introduz a sua conta

Por exemplo, um IBAN, um sort code e um número de conta, ou uma CLABE. O fluxo de verificação constrói o formulário a partir do que a API devolve para esse país, pelo que um país adicionado posteriormente pela Didit não exige alterações do seu lado.
3

A Didit verifica primeiro o formato

Antes de faturar o que quer que seja, a Didit valida cada valor: o seu comprimento, os seus carateres, os seus dígitos de controlo e, no caso de um IBAN, se pertence ao país selecionado. Um valor inválido é recusado indicando o campo a corrigir. A pessoa corrige-o no momento e nenhuma tentativa é consumida.
4

O banco verifica o nome na conta

A Didit executa uma verificação face ao nome verificado pela sessão. Qualquer outro dado enviado pelo cliente é ignorado.
5

O passo toma uma decisão

A resposta converte-se num resultado de propriedade, e as ações do passo transformam-no no veredito exatamente da mesma forma que no início de sessão bancário.

​
Onde a verificação está disponível

A cobertura é por país. Em produção, a verificação funciona hoje na Nigéria, no Gana e no Quénia. A Didit ativa-a país a país, assim que tiver uma rota com preço definido nesse local; um país sem essa rota não a disponibiliza, e os preços da Verificação bancária mostram sempre a lista atualizada. São adicionados novos países ao longo do tempo, e o passo lê sempre a lista atual, pelo que nunca precisa de alterar a sua integração quando um país é adicionado. Dentro de um país abrangido, os métodos do passo determinam se a pessoa vê essa verificação:
  • A ordem do passo. O parâmetro bank_method_order define quais os métodos disponibilizados por cada país e qual surge em primeiro lugar. O padrão, ["open_banking", "account_lookup"], inicia no início de sessão bancário e oferece a verificação de conta como recurso alternativo.
  • A ordem específica de um país. O parâmetro methods num país em bank_countries substitui a ordem do passo para esse país, por exemplo ["account_lookup"] apenas para a verificação de conta, ou ["account_lookup", "open_banking"] para iniciar com ela.
  • Um banco indisponível. Quando um país oferece a verificação de conta, esta também serve de recurso se o início de sessão bancário estiver degradado ou indisponível: o passo avança para o formulário de conta antes de ser solicitado qualquer consentimento, desde que a pessoa ainda tenha tentativas de verificação de conta disponíveis.
  • A verificação funciona nas rotas próprias da Didit. Um passo executado através do seu próprio fornecedor do marketplace (provider_key) só a disponibiliza com a opção fallback_to_native ativa.
  • Contas empresariais. Numa sessão de verificação de empresas, a verificação compara uma conta empresarial com a empresa verificada, nos países onde a Didit verifica contas empresariais.
Consulte Escolher os métodos por país para conhecer as regras aplicadas ao guardar as definições.

​
O que a pessoa introduz

Estes são os formatos de conta que o formulário compreende. Não constituem uma lista de cobertura: o funcionamento da verificação num país depende de onde está disponível, e o passo apresenta sempre os campos exatos para esse país. Em alguns países, o formulário também solicita um número de registo: para contas empresariais e, em alguns países, para todas as contas. Os espaços, traços e pontos são removidos e as letras convertidas para maiúsculas antes de um valor ser validado, para que a pessoa possa introduzir a conta tal como o seu banco a imprime.

​
Ativar

Um novo passo disponibiliza a verificação da conta por predefinição, como alternativa ao início de sessão bancário. Para começar por esta opção, ou para a disponibilizar isoladamente, coloque account_lookup em primeiro lugar na ordem:
Estas definições configuram a verificação:

​
Resultados

​
Verificações que devolvem uma resposta

Cada uma destas é faturada uma vez e consome uma das verificações de conta da pessoa (bank_account_check_max_attempts). Até à conclusão do passo, a pessoa pode tentar novamente com outra conta enquanto restarem verificações. O resultado surge em ownership.result, exceto no caso de uma conta inexistente, que surge em connection.reason_code. Com bank_account_check_accept_close_match desativado, ambas as correspondências próximas tornam-se um no_match, com o código de motivo OWNER_NAME_MISMATCH: nunca é pedido à pessoa que confirme o nome, e bank_no_match_action decide. O início de sessão bancário mantém as suas correspondências próximas em qualquer dos casos. Assim que a pessoa tiver esgotado todas as verificações de conta e todas as tentativas de início de sessão bancário nos países em que também seja disponibilizado o início de sessão bancário, sem uma ligação bem-sucedida, o passo permanece aberto enquanto ainda lhe disponibilizar o envio de extrato com tentativas restantes: consulte O envio de extrato. Quando já não restar nenhuma alternativa, o passo termina em bank_attempts_exhausted_action (DECLINE por predefinição), a menos que uma tentativa anterior já tenha chegado a um veredito, como uma não correspondência de nome. Esse veredito mantém-se então válido.

​
Resultados que nunca são faturados

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

​
Na decisão

A decisão da sessão lista o passo em bank_verifications[]. Assim que uma conta for avaliada, method indica account_lookup. Enquanto nenhuma conta tiver sido avaliada, method e ownership ficam como null, e connection.reason_code indica o motivo, por exemplo ACCOUNT_NOT_FOUND, PROVIDER_UNAVAILABLE ou REFERENCE_IDENTITY_MISSING. Nenhum banco é selecionado para a verificação, pelo que connection.institution_id, connection.institution_name e connection.oauth são null, e connection.institution_country corresponde ao país escolhido pela pessoa. A Didit não mantém qualquer acesso à conta depois da conclusão do passo, pelo que uma verificação terminada com 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 rendimentos. Quando o passo os solicita, financial_data.not_collected lista-os; consulte Os dados financeiros requerem início de sessão bancário.
O exemplo mostra apenas os campos abordados nesta página. Assim que uma conta for avaliada, leia method para distinguir uma verificação de conta do início de sessão bancário: é o campo específico para essa finalidade.

​
Em regras de fluxo e relatórios

  • Ramificações e regras de estado: 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 devolve uma resposta constitui uma cobrança de Bank Verification: uma correspondência, uma correspondência aproximada, uma não correspondência, uma conta que não foi possível verificar e uma conta não encontrada são todas faturadas. Um valor recusado antes da verificação, uma verificação indisponível e uma sessão sem um nome verificado para comparar nunca são faturados. O preço é definido por país: consulte os Preços de Bank Verification. A verificação de conta é um método pago autónomo, nunca uma alternativa: a ação bank_fallback_used_action não é acionada neste caso. Após uma verificação faturada, os microdepósitos e o carregamento do extrato são incluídos sem custos adicionais na mesma sessão, onde o passo os ativa e o país os disponibiliza.

​
Testar na sandbox

Numa aplicação de sandbox, a verificação é executada num serviço simulado e nada é faturado. A sandbox disponibiliza ambos os métodos em todos os países, na ordem definida pelo passo: com a ordem predefinida, selecione Introduza os dados da sua conta para executar a verificação, ou defina bank_method_order para ["account_lookup", "open_banking"] para começar por este. Os últimos quatro carateres da conta introduzida pela pessoa (o IBAN, caso contrário o número de conta) escolhem a resposta. Qualquer outra terminação corresponde ao nome verificado. A sandbox regista cada verificação respondida como utilização sem custos, permitindo-lhe ver quais as verificações que uma sessão em produção faturaria. Um IBAN, um CLABE e um CBU contêm dígitos de controlo, pelo que não pode simplesmente alterar os respetivos quatro últimos carateres. Utilize estes valores, que passam em todas as verificações de formato:
A API de verificação de conta responde a uma chave de sandbox a partir das mesmas terminações, sem necessidade de sessão. Consulte Testes na sandbox para obter mais informações sobre como funcionam as aplicações de sandbox em geral.
Última modificação em 7 de novembro de 2026