Saltar para o conteúdo principal
Didit’s Bank Link é o fluxo único em que uma pessoa liga uma conta bancária ao seu produto, seja para uma leitura pontual, seja para acesso contínuo. Cria uma ligação no seu servidor e encaminha a pessoa para a respetiva página alojada.

Como o apresentar

Envie a pessoa para a ligação url, ou coloque-a num e-mail ou numa mensagem: a Didit aloja todos os ecrãs. Consulte o Bank Link alojado e Regresse ao seu site para levar a pessoa de volta à sua página. O 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 (o seu nome e logótipo), quais (contas, saldos, transações desde uma data), durante quanto tempo, com que frequência são atualizados e como parar.
  2. Pessoal ou empresarial. Só quando o banco os separa e o seu pedido indicou any.
  3. Banco. O seletor lista os bancos que conseguem fazer o que a ligação pede. Com acesso contínuo, lista apenas os bancos que conseguem manter o acesso aberto.
  4. Início de sessão no banco. Na própria página do banco, nunca dentro dos ecrãs da Didit.
  5. Contas. Todas as contas elegíveis vêm pré-selecionadas e cada uma pode ser desmarcada, mantendo-se pelo menos uma selecionada.
  6. Sucesso. As contas ligadas e, no caso de acesso contínuo, até quando.
Consulte Dados, consentimento e eliminação para saber o que a pessoa aceita e como o acesso é interrompido.

O salto para o banco

A página de início de sessão do próprio banco não pode ser executada dentro de um frame, por isso a Bank Link encaminha a pessoa para o banco e depois a traz de volta. O estado de uma ligação fica guardado nos servidores da Didit, pelo que fechar um separador nunca faz perder um consentimento que a pessoa já tenha dado. No final, a pessoa é enviada para o seu redirect_url quando a ligação tiver um: veja Voltar ao seu site.

Segurança

  • A chave de API nunca chega a um navegador nem a uma aplicação.
  • O redirect_url é validado quando cria a ligação: numa aplicação sandbox, atualmente só funciona um endereço localhost, ver Voltar ao seu site.
  • Os eventos incluem apenas IDs: sem nomes, sem números de conta e sem tokens.

Próximos passos

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