Pular para o conteúdo principal
O Bank Link da Didit é o fluxo único em que a pessoa conecta uma conta bancária ao seu produto, seja para uma leitura pontual ou para acesso contínuo. Você cria um link no seu servidor e envia a pessoa para a página hospedada desse link.

Como exibir

Envie a pessoa para o link url, ou coloque-o em um e-mail ou mensagem: a Didit hospeda todas as telas. Veja Link bancário hospedado e Volte para o seu site para trazer a pessoa de volta à sua página. Seu servidor confirma o resultado com GET /v3/bank/links/{id}/ ou com o webhook bank.link.completed.

O que a pessoa vê

  1. Consentimento. Quem vai ler os dados (seu nome e logotipo), quais dados (contas, saldos, transações desde uma data), por quanto tempo, com que frequência são atualizados e como interromper o acesso.
  2. Pessoal ou empresarial. Somente quando o banco separa os dois e a sua requisição disse any.
  3. Banco. O seletor lista os bancos que conseguem fazer o que o link pede. Com acesso contínuo, ele lista apenas os bancos que conseguem manter o acesso aberto.
  4. Login no banco. Na própria página do banco, nunca dentro das telas da Didit.
  5. Contas. Todas as contas elegíveis vêm pré-selecionadas, e cada uma pode ser desmarcada, desde que pelo menos uma permaneça selecionada.
  6. Sucesso. As contas vinculadas e, no caso de acesso contínuo, até quando o acesso vale.
Veja Dados, consentimento e exclusão para saber o que a pessoa concorda e como o acesso é interrompido.

O trajeto pelo banco

A página de login do próprio banco não pode ser exibida dentro de um frame, por isso o Bank Link envia a pessoa ao banco e a traz de volta. O estado de um link fica nos servidores da Didit, então fechar uma aba nunca faz com que um consentimento que a pessoa já deu seja perdido. Ao final, a pessoa é levada ao seu redirect_url, se o link tiver um: veja Voltar ao seu site.

Segurança

  • A chave de API nunca chega a um navegador ou a um aplicativo.
  • redirect_url é verificada quando você cria o link: em uma aplicação de sandbox, hoje só funciona um endereço localhost; veja Voltar para o seu site.
  • Os eventos trazem apenas ids: sem nomes, sem números de conta e sem tokens.

Próximos passos

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