> ## 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.

# Consentimento para dados bancários, controlo de acesso e eliminação

> Saiba o que o utilizador autoriza no Bank Link, como revogar o acesso, quem pode ler os dados e o que a Didit elimina ao apagar uma ligação bancária.

Os dados bancários são partilhados por instrução da pessoa, e esta pode deixar de os partilhar a qualquer momento.
Esta página indica o que a pessoa vê e aceita, como termina o acesso e o que é removido ao eliminar uma ligação.

## O que a pessoa vê e aceita

No ecrã de consentimento da Didit, a pessoa vê:

* quem vai ler os dados: o seu nome e logótipo;
* que dados: contas, saldos e transações desde uma data;
* durante quanto tempo: no caso de acesso contínuo, "até" uma data, com um lembrete de que pode parar a qualquer momento;
* com que frequência são atualizados;
* como parar.

O prestador regulado de serviços de informação sobre contas associado a uma rota é divulgado no ecrã de consentimento dessa rota, sempre que a lei o exige.
A Didit recebe os dados e transmite-lhos, por instrução da pessoa.
As credenciais bancárias de início de sessão nunca são vistas nem armazenadas pela Didit nas rotas de redirecionamento.

## Quem pode ler os dados

* Os dados bancários guardados estão protegidos: são cifrados em repouso, usados apenas para a finalidade para que a pessoa deu consentimento e nunca escritos em registos.
* Cada chamada aos dados bancários exige uma chave de API com a permissão Dados bancários: o acesso total não a inclui. Sem ela, a chamada responde com `403 bank_data_access_denied`.

## Como termina o acesso

| Quem | Como | Resultado |
| - | - | - |
| A pessoa | **Deixar de partilhar** no seu banco | `bank.connection.revoked` com `ended_by` definido como `end_user` ou `bank` |
| Você | `revoke_connection` | Os pedidos de dados ao banco param imediatamente. O consentimento fica com o estado `revocation_pending` e passa a `revoked` quando o banco confirma. |
| O consentimento | Termina na data indicada e não é renovado | `renewal_required`, depois `revoked` com `status_reason: consent_lapsed` |

Parar o acesso não é eliminar: depois de chamar `revoke_connection`, as contas, os saldos e as transações já lidos continuam legíveis para si até eliminar a ligação ou até passar `consent.retain_until`.
Elimine a ligação com `delete_connection` quando quiser que deixe de existir de imediato.

## Eliminar uma ligação

[`DELETE /v3/bank/connections/{id}/`](https://docs.didit.me/pt/standalone-apis/bank-connection-delete) interrompe o acesso ao banco e elimina as contas, os saldos e as transações armazenados da ligação.

**O que é eliminado**

* As contas, os saldos, as transações, o histórico de sincronizações, os registos de consentimento e os resultados de propriedade da ligação.
* O histórico do feed de alterações da ligação.
* O acesso ao banco, que é terminado.
* Todas as operações de dados da ligação (atualização, execuções de sincronização, contas, saldos, transações e feed de alterações) respondem com `409 connection_not_active`.

**O que não é afetado**

* Outras ligações, mesmo as da mesma pessoa: cada ligação é uma autorização independente.
* Os encargos já liquidados e os créditos já consumidos.
* Os webhooks já entregues a si e qualquer informação que tenha transferido ou guardado nos seus próprios sistemas: essa é a sua própria cópia.

**O que esperar**

* A eliminação é imediata e irreversível: quando a chamada devolve resposta, os dados da ligação já foram eliminados.
* Quando lida posteriormente, a ligação responde apenas com o seu `id`, `status` (`deleted`), `status_reason`, `created_at` e `erasure`, o registo da eliminação com `requested_at`, `erased_at` e `status`.
* `erasure.status` é a confirmação da eliminação, não uma fase em que os dados ainda são legíveis:
  * `pending`: a eliminação está a ser confirmada, incluindo a interrupção do acesso no banco.
  * `erased`: confirmada, com `erased_at`.
  * `failed`: a confirmação ainda não chegou e o processo de confirmação é repetido automaticamente. Não é necessária nenhuma ação da sua parte.
* Os dados são eliminados e não são legíveis em nenhum dos três estados.
* Repetir a chamada é seguro.
* `bank.connection.deleted` confirma a eliminação.

Eliminar a sua organização ou aplicação elimina as respetivas ligações e os respetivos dados da mesma forma.

## Próximos passos

* [Ligações](https://docs.didit.me/pt/core-technology/bank-verification/connections.md): estados e renovação.
* [Webhooks](https://docs.didit.me/pt/core-technology/bank-verification/webhooks.md): `bank.connection.revoked` e `bank.connection.deleted`.


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