Pular para o conteúdo principal
Um consentimento bancário dura pelo tempo que o banco permitir e, depois disso, precisa ser renovado pela pessoa. A Didit avisa você antes que ele expire e oferece uma chamada de renovação para a mesma conexão.

Duração do consentimento

  • O banco e a rota definem a data final, no máximo o valor de consent_days que você solicitou.
  • Cada conexão mostra as datas reais em consent.expires_at e consent.renew_by.
  • A instituição mostra o consentimento mais longo que o banco permite em consent_days_max.
  • Nunca prometa aos seus usuários um número fixo de dias: diga “até” a data indicada na conexão.

Saiba com antecedência

bank.connection.consent_expiring é enviado 14, 7 e 1 dia antes do término. Você também pode listar as conexões que terminam em breve:

Renovar

A API responde com 201 e um link de renovação, ou com uma destas respostas: A página em que a pessoa conclui a renovação ainda não está disponível, por isso não envie pessoas para um link de renovação hoje. Até lá, use os lembretes acima para saber quando um consentimento termina.

Se o consentimento caducar

  • A conexão passa para renewal_required com status_reason: consent_expired ou bank_requires_sign_in.
  • Você ainda pode ler o que foi sincronizado; nada é sincronizado nem cobrado, e bank.connection.renewal_required é enviado.
  • Após consent.renewable_until, ela fica revoked com status_reason: consent_lapsed, e a pessoa se conecta novamente.

Relacionados

Última modificação em 22 de novembro de 2026