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.
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
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}/ 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.
- 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.
- 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_ateerasure, além do registro da exclusão comrequested_at,erased_atestatus. 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, comerased_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.deletedconfirma a exclusão.