> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Bank Link: fluxo de ligação bancária alojado

> O Bank Link da Didit é o único fluxo para ligar uma conta bancária: crie uma ligação no seu servidor e envie a pessoa para a página alojada.

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](https://docs.didit.me/pt/integration/bank-link/hosted-link.md) e [Regresse ao seu site](https://docs.didit.me/pt/integration/bank-link/return-to-your-site.md) 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](https://docs.didit.me/pt/core-technology/bank-verification/data-consent-and-deletion.md) 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](https://docs.didit.me/pt/integration/bank-link/return-to-your-site.md).

## 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](https://docs.didit.me/pt/integration/bank-link/return-to-your-site.md).
* Os eventos incluem apenas IDs: sem nomes, sem números de conta e sem tokens.

## Próximos passos

* Siga o [guia de início rápido](https://docs.didit.me/pt/core-technology/bank-verification/quickstart.md).
* Leia a [referência de `create_link`](https://docs.didit.me/pt/standalone-apis/bank-link-create) para conhecer todas as opções.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.