> ## 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 de dados bancários, controle de acesso e exclusão

> Veja o que o usuário autoriza no Bank Link, como ele e você revogam o acesso, quem pode ler os dados e o que a exclusão de uma conexão bancária remove na Didit.

Os dados bancários são compartilhados por instrução da pessoa, e ela pode interromper o compartilhamento a qualquer momento.
Esta página explica o que a pessoa vê e aceita, como o acesso é encerrado e o que a exclusão de uma conexão remove.

## O que a pessoa vê e autoriza

Na tela de consentimento da Didit, a pessoa vê:

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

O provedor regulamentado de informações de conta por trás de uma rota é divulgado na tela de consentimento dessa rota, quando a lei exige.
A Didit recebe os dados e os repassa a você, por instrução da pessoa.
As credenciais bancárias de acesso nunca são vistas nem armazenadas pela Didit nas rotas de redirecionamento.

## Quem pode ler os dados

* Os dados bancários armazenados são protegidos: são criptografados em repouso, usados somente para a finalidade que a pessoa autorizou e nunca gravados em logs.
* Toda chamada de dados bancários exige uma chave de API com a permissão de dados bancários: o acesso total não inclui essa permissão. Sem ela, a chamada responde `403 bank_data_access_denied`.

## Como o acesso termina

| Quem | Como | Resultado |
| - | - | - |
| A pessoa | **Deixar de compartilhar** no banco | `bank.connection.revoked` com `ended_by` definido como `end_user` ou `bank` |
| Você | `revoke_connection` | A obtenção de dados do banco é interrompida imediatamente. O consentimento fica com `revocation_pending` e, quando o banco confirma, passa para `revoked`. |
| O consentimento | Ele termina na data de término e não é renovado | `renewal_required`, depois `revoked` com `status_reason: consent_lapsed` |

Interromper o acesso não é excluir: após `revoke_connection`, as contas, os saldos e as transações já obtidos continuam disponíveis para leitura até que você exclua a conexão ou até que `consent.retain_until` passe.
Exclua a conexão com `delete_connection` quando quiser removê-la agora.

## Excluir uma conexão

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

**O que é excluído**

* As contas, os saldos, as transações, o histórico de sincronização, os registros de consentimento e os resultados de propriedade da conexão.
* O histórico do feed de alterações da conexão.
* O acesso da conexão no banco, que é encerrado.
* Toda operação de dados da conexão (atualização, execuções de sincronização, contas, saldos, transações e o feed de alterações) responde `409 connection_not_active`.

**O que não é afetado**

* Outras conexões, mesmo as da mesma pessoa: cada conexão é uma autorização independente.
* Cobranças já liquidadas e créditos já consumidos.
* Webhooks já entregues a você, e tudo o que você baixou ou armazenou em seus próprios sistemas: essa é a sua própria cópia.

**O que esperar**

* A exclusão é imediata e irreversível: quando a chamada retorna, os dados da conexão já foram excluídos.
* Ao consultar a conexão depois, ela responde apenas com `id`, `status` (`deleted`), `status_reason`, `created_at` e `erasure`, além do registro da exclusão com `requested_at`, `erased_at` e `status`.
* `erasure.status` é a confirmação da exclusão, não uma etapa em que os dados ainda podem ser lidos:
  * `pending`: a exclusão está sendo confirmada, incluindo o encerramento do acesso no banco.
  * `erased`: confirmada, com `erased_at`.
  * `failed`: a confirmação ainda não chegou e é repetida automaticamente. Você não precisa fazer nada.
* Os dados são excluídos e não podem ser lidos em nenhum dos três estados.
* Repetir a chamada é seguro.
* `bank.connection.deleted` confirma a exclusão.

Excluir sua organização ou aplicação exclui suas conexões e os respectivos dados da mesma forma.

## Próximos passos

* [Conexões](https://docs.didit.me/pt-br/core-technology/bank-verification/connections.md): status e renovação.
* [Webhooks](https://docs.didit.me/pt-br/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.