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

# Renovar consentimento bancário: prazo, lembretes e expiração

> Veja quanto tempo dura um consentimento bancário, quando a Didit envia lembretes, o que a chamada de renovação retorna e o que acontece ao expirar.

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:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/?status=active&consent_expires_before=2026-12-15" \
  -H "x-api-key: $DIDIT_API_KEY"
```

## Renovar

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/renew/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "redirect_url": "http://localhost:3000/bank/return" }'
```

A API responde com `201` e um link de renovação, ou com uma destas respostas:

| Resposta | Significado |
| - | - |
| `409 renewal_not_needed` | Restam mais de 30 dias. Tente novamente mais tarde. |
| `409 renewal_window_expired` | O prazo de `consent.renewable_until` já passou. A pessoa se conecta novamente com um novo link. |

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

* [Conexões](https://docs.didit.me/pt-br/core-technology/bank-verification/connections.md)
* [Feed bancário contínuo para contabilidade](https://docs.didit.me/pt-br/use-cases/bank-data-for-accounting.md)
* [Dados, consentimento e exclusão](https://docs.didit.me/pt-br/core-technology/bank-verification/data-consent-and-deletion.md)


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