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ê
- 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.
- Pessoal ou empresarial. Só quando o banco os separa e o seu pedido indicou
any.
- 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.
- Início de sessão no banco. Na própria página do banco, nunca dentro dos ecrãs da Didit.
- Contas. Todas as contas elegíveis vêm pré-selecionadas e cada uma pode ser desmarcada, mantendo-se pelo menos uma selecionada.
- 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