Pular para o conteúdo principal
A Verificação bancária nunca deixa uma pessoa travada. Enquanto a etapa aguarda por ela, a pessoa sempre pode escolher Continue without your bank, e a etapa mostra essa opção assim que nenhum método funciona para o país ou o banco dela. A sessão então segue o resultado que você escolheu para esse caso, que por padrão é uma revisão. Quando uma tentativa malsucedida consome a última tentativa de todas as formas que ainda são oferecidas à pessoa, incluindo o envio de extrato, a etapa não espera: ela termina sozinha e segue bank_attempts_exhausted_action, que por padrão é uma recusa. A exceção é quando uma tentativa anterior já chegou a um veredito, como uma divergência de nome. Nesse caso, esse veredito prevalece. Esta página explica as outras formas de verificação que cada país oferece, quando a pessoa vê Continue without your bank, como cada caso é decidido e como interpretar isso no resultado.
A Verificação bancária ainda não está habilitada no ambiente de produção. Até que esteja, você não pode adicionar esta etapa a um fluxo de verificação (workflow) nem chamar esta API, seja no ambiente de produção ou em sandbox. Esta página descreve como ela vai funcionar.

​
As formas de verificação

A pessoa começa pelo login no banco ou pela consulta de conta, na ordem que você definiu para o país dela: veja Escolha os métodos por país. O envio de extrato e os microdepósitos são alternativas depois desses dois. Continue without your bank vem por último. Uma forma que não pode ser usada em um país nunca é oferecida à pessoa nesse país. No console, Countries and methods a mostra como Not available para esse país.

​
Um país que nenhuma rota bancária atende

Um país em que nem o login no banco nem a consulta de conta têm uma rota continua na etapa. As pessoas desse país enviam um extrato, quando a etapa oferece essa opção, ou continuam sem banco. Ao salvar, esse país é mantido quando methods é omitido ou definido como null. O methods dele não pode listar nenhum método, porque nenhuma rota atende a nenhum método ali: isso é recusado ao salvar, por exemplo com Account check is not available in VNM. Uma lista vazia também é recusada, como em qualquer país habilitado, com Choose a method: bank sign-in, account check, or both. Se o seu contrato define preços próprios e não inclui o envio de extrato, esse país também é recusado ao salvar se o envio for oferecido sem nenhuma tentativa bancária antes dele.
Aqui, o Vietnã representa um país que nenhuma rota bancária atende. Ele não define methods, então ele é mantido ao salvar, e as pessoas desse país veem o envio de extrato e Continue without your bank.

​
O envio de extrato

O envio de extrato pede um extrato bancário dos últimos 3 meses que mostre o nome da pessoa, o banco e o número da conta. A Didit lê o extrato, verifica se ele foi editado e compara o nome do titular da mesma forma que compara o nome informado por um banco. Com bank_statement_enabled ativado, a etapa oferece o envio em dois casos:
  • Após uma tentativa cobrada: depois que um login no banco ou uma consulta de conta foi cobrado na mesma sessão, o envio de extrato é uma alternativa incluída sem custo adicional.
  • Sem nenhuma tentativa bancária antes: em qualquer país, inclusive um que nenhuma rota bancária atende. Isso exige bank_statement_standalone_enabled, que vem ativado por padrão. Desative-o para oferecer o envio de extrato somente após uma tentativa cobrada.
O envio de extrato e os microdepósitos consomem, cada um, uma das bank_max_attempts da etapa, as mesmas tentativas que o login no banco usa. Depois que a pessoa usa todas elas, nenhum dos dois é mais oferecido, nem mesmo após uma tentativa cobrada. A consulta de conta tem suas próprias tentativas, bank_account_check_max_attempts. Por isso, onde ela é o único método, uma pessoa que já usou todas as tentativas de consulta de conta ainda pode enviar um extrato, quando a etapa oferece essa opção. Quando uma tentativa malsucedida consome a última tentativa de todas as formas que ainda são oferecidas à pessoa, incluindo o envio de extrato, a etapa termina sozinha. A pessoa não recebe a opção de continuar, e o resultado não registra nenhuma continuação. A sessão segue bank_attempts_exhausted_action, a menos que uma tentativa anterior já tenha chegado a um veredito, como uma divergência de nome, que então prevalece. Para deixar espaço para uma alternativa após um login no banco malsucedido, defina bank_max_attempts como 2 ou mais.

​
Quando a pessoa vê Continuar sem seu banco

bank_continue_without_bank define quando a etapa exibe Continuar sem seu banco: Nenhum dos valores desativa a opção: a pessoa sempre pode continuar. No console, configure isso na etapa de Bank Verification em Quando a pessoa não consegue verificar, como Mostrar Continuar sem banco: Quando nada mais funcionar ou Desde o início.

​
O que a pessoa vê

  • Nenhuma rota no país dela: por exemplo, “Ainda não conseguimos nos conectar a bancos no Vietnã”, com o envio de extrato em Outras formas de verificar e Continuar sem seu banco.
  • Um banco que não pode ser usado aqui: “Este banco não pode ser usado aqui”. A pessoa pode informar os dados da conta onde o país oferece a verificação de conta, enviar um extrato, escolher outro banco ou continuar sem seu banco.
  • Sem internet banking, ou um banco que não está na lista: “Verifique sua conta de outra forma”, com as formas que o país dela oferece e Continuar sem seu banco.
  • Um banco que não pode ser acessado no momento: a pessoa pode tentar novamente. A tela também oferece Continuar sem seu banco quando o outro método, o login no banco ou a verificação de conta, não pode ajudar: o país dela não o oferece, não restam tentativas ou a última tentativa também não conseguiu estabelecer conexão com o banco.
  • Depois de continuar: “Obrigado, você pode continuar”. A pessoa nunca vê uma mensagem de falha e segue para a próxima etapa do seu fluxo.

​
Escolha o resultado

Quando a pessoa continua sem banco, a Didit determina o motivo com base no que aconteceu na etapa. Ela nunca obtém um motivo a partir do dispositivo da pessoa. Cada motivo, registrado como continuation.reason, segue sua própria configuração de resultado:
  • no_route: nenhuma rota de login no banco ou de verificação de conta atende o país da pessoa. Decidido por bank_unsupported_action, REVIEW por padrão, com o código de motivo NOT_COVERED.
  • institution_unsupported: o banco escolhido não pode ser usado nesta etapa. Decidido por bank_unsupported_action, REVIEW por padrão, com o código de motivo NOT_COVERED.
  • attempts_exhausted: todas as tentativas já tinham sido usadas, e nenhuma ainda estava em andamento, quando a pessoa continuou. Decidido por bank_attempts_exhausted_action, DECLINE por padrão.
  • person_choice: havia uma forma de verificar, e a pessoa escolheu continuar. Isso inclui um banco que não podia ser acessado no momento: o banco é coberto, então o motivo é a escolha da própria pessoa. Decidido por bank_skipped_action, REVIEW por padrão, com o código de motivo SKIPPED.
bank_skipped_action e bank_attempts_exhausted_action aceitam REVIEW ou DECLINE. bank_unsupported_action também aceita NO_ACTION, que aprova a etapa e ainda assim registra NOT_COVERED. No console, essas são as linhas Bank or country not covered, Continued without a bank e Attempts exhausted da aba Outcomes da etapa.
Continuar nunca substitui um veredito a que uma tentativa já chegou. Se uma tentativa já foi avaliada, por exemplo, o banco ou um extrato retornou um titular que não corresponde e a pessoa ainda tinha tentativas, ou uma correspondência aproximada que ela não confirmou, a etapa mantém esse veredito e seus códigos de motivo. Nesse caso, nenhuma configuração de resultado da lista acima se aplica, e nenhum NOT_COVERED ou SKIPPED é adicionado. O resultado ainda registra que a pessoa continuou: consulte Leia no resultado.

​
Veja no resultado

​
Decisão e webhooks

O item da etapa em bank_verifications[], na decisão da sessão e no objeto decision dos webhooks status.updated, indica que a pessoa continuou sem banco:
  • continued_without_bank é true: a pessoa saiu da etapa com Continue without your bank.
  • method é none quando nenhuma tentativa foi avaliada antes de a pessoa continuar. Depois de uma tentativa avaliada, como um titular que não corresponde, method continua sendo o método dessa tentativa, e o veredito dela é mantido.
  • continuation indica como a pessoa continuou:
    • reason: no_route, institution_unsupported, attempts_exhausted ou person_choice.
    • country: o país em que a pessoa estava fazendo a verificação, em ISO 3166-1 alpha-3, ou null quando ela continuou antes de escolher um.
    • offered: as outras formas de verificação que esse país ofereceu, na ordem em que as ofereceu: statement e depois microdeposits. Fica vazio quando ele não ofereceu nenhuma.
    • institution_id e institution_name: para institution_unsupported, o banco que a pessoa não conseguiu usar, ou seja, o banco que ela escolheu ou o banco em que terminou a última tentativa dela. A Didit obtém os dois da própria lista de bancos, nunca do dispositivo da pessoa, então um banco que não está nessa lista deixa os dois como null. Os dois são null para qualquer outro motivo.
    • continued_at: quando a pessoa continuou.
  • reason_codes contém NOT_COVERED ou SKIPPED, como em Escolha o resultado, quando a continuação decidiu a etapa. Depois de uma tentativa avaliada, ele mantém os códigos de motivo dessa tentativa.
  • not_covered é true para no_route e institution_unsupported.
O exemplo mostra apenas os campos discutidos nesta página. Todos os campos estão no schema BankVerificationResult da referência da API. Quando o seu fluxo restringe os dados que retorna, continued_without_bank e continuation.reason continuam sendo retornados, então você ainda consegue distinguir no_route de institution_unsupported, que compartilham NOT_COVERED. Todas as outras chaves de continuation ficam então como null: o país, o banco, o que foi oferecido e quando. O próprio continuation é null quando a pessoa não continuou. Nesse caso, method também não é retornado, então leia continued_without_bank, e não method, para saber se a pessoa continuou.

​
Regras do fluxo

Ramificações e regras de status personalizadas podem ler:
  • bank.continued_without_bank: true ou false.
  • bank.continue_reason: no_route, institution_unsupported, attempts_exhausted ou person_choice.
  • bank.method: none quando a pessoa continuou sem banco antes de qualquer tentativa ser avaliada. Depois de uma tentativa avaliada, o método dessa tentativa.

​
Relatório da sessão

Quando a pessoa continuou sem banco antes de qualquer tentativa ser avaliada, a linha Verification method do relatório PDF da sessão mostra Continued without a bank. Depois de uma tentativa avaliada, ela informa o método dessa tentativa.

​
Preços

  • Continue without your bank nunca é cobrado. As tentativas que a pessoa fez antes de continuar são cobradas normalmente.
  • Um envio de extrato sem nenhuma tentativa bancária cobrada antes dele custa $0.20 por extrato que a Didit lê e avalia. Ele é cobrado em uma linha de uso própria, Bank verification - statement upload (bank_statement_upload), e a tarifa do seu contrato ou o seu preço especial se aplica a ele como a qualquer complemento. Se o seu contrato define preços próprios e não o inclui, a etapa não o oferece.
  • Um upload de extrato ou microdepósitos depois de um login bancário cobrado ou de uma verificação de conta cobrada na mesma sessão estão incluídos sem custo adicional.

​
Nós salvos antes de Continue without your bank

bank_allow_skip foi descontinuado. Um nó salvo com ele agora é executado com o valor que ele representava: Um nó que não permitia pular deixava a pessoa sem como avançar quando nada funcionava para ela. Agora ele mostra Continue without your bank nesses casos, e bank_unsupported_action, bank_attempts_exhausted_action ou bank_skipped_action decide a sessão. Por um ciclo de lançamento, um salvamento que envia bank_allow_skip sem bank_continue_without_bank ainda define o modo a partir dele. Todo salvamento grava bank_allow_skip de volta: true para from_start, false para when_needed. Use bank_continue_without_bank em novas integrações.

​
Teste no sandbox

Uma aplicação de sandbox não cobra nada, e o envio de extrato e os microdepósitos não exigem tentativa de conexão com o banco antes deles. Defina bank_continue_without_bank como from_start para ver Continue without your bank na primeira tela e escolha essa opção para testar bank_skipped_action. Consulte Testes no sandbox para saber como as aplicações de sandbox funcionam em geral.

​
Relacionados

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