Pular para o conteúdo principal
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

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.
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: status e renovação.
  • Webhooks: bank.connection.revoked e bank.connection.deleted.
Última modificação em 22 de novembro de 2026