> ## 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: duração, lembretes e expiração

> Duração do consentimento bancário, quando a Didit envia lembretes, o que devolve a chamada de renovação e o que acontece ao expirar.

Um consentimento bancário dura o tempo que o banco permitir e, depois, tem de ser renovado pela pessoa.
A Didit avisa antes de ele terminar e disponibiliza uma chamada de renovação para a mesma ligação.

## Quanto tempo dura

* O banco e a rota definem a data de fim, no máximo o `consent_days` que pediu.
* Cada ligaçã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 utilizadores um número fixo de dias: diga «até» à data indicada na ligação.

## Saber com antecedência

`bank.connection.consent_expiring` é enviado 14, 7 e 1 dia antes do fim.
Também pode listar as ligaçõ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 resposta é `201` com uma ligação de renovação, ou uma destas:

| Resposta | Significado |
| - | - |
| `409 renewal_not_needed` | Faltam mais de 30 dias. Tente novamente mais tarde. |
| `409 renewal_window_expired` | Já passou a data de `consent.renewable_until`. A pessoa volta a ligar-se com uma nova ligação. |

A página onde a pessoa conclui a renovação ainda não está disponível, por isso não envie pessoas para uma ligação de renovação neste momento.
Até lá, use os lembretes acima para saber quando um consentimento termina.

## Se o consentimento caducar

* A ligação passa a `renewal_required` com `status_reason: consent_expired` ou `bank_requires_sign_in`.
* Pode continuar a ler o que foi sincronizado. Nada é sincronizado nem cobrado, e é enviado `bank.connection.renewal_required`.
* Depois de `consent.renewable_until`, a ligação passa a `revoked` com `status_reason: consent_lapsed`, e a pessoa volta a estabelecer a ligação.

## Relacionados

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


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