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

# Connessioni bancarie: accesso continuo, consenso e rinnovo

> Una connessione bancaria è il consenso di una persona a leggere la sua banca. Stati, scadenza, rinnovo e revoca con Didit.

Una connessione bancaria Didit è l'autorizzazione di una persona o di un'azienda affinché la tua applicazione possa leggere i dati di una banca, con le relative date di consenso, lo stato di sincronizzazione e i conti.

Un [Bank Link](https://docs.didit.me/it/core-technology/bank-verification/bank-link.md) completato crea la connessione, che resta attiva per il tempo consentito dalla banca e dalla persona.

I dati bancari sono disponibili per le applicazioni in sandbox; le chiamate di un'applicazione in produzione restituiscono `404` finché l'accesso in produzione non viene annunciato.

## Accesso una tantum e continuo

| | Una tantum | Continuo |
| - | - | - |
| `access` | `one_time` (predefinito) | `ongoing` |
| Cosa succede | I dati vengono letti una sola volta quando la persona si connette, poi l'accesso termina (`status_reason: collection_complete`). | L'accesso resta aperto finché il consenso non termina o qualcuno non lo interrompe. |
| Dati successivi | Leggibili tramite gli stessi endpoint. | Sincronizzati automaticamente da una a quattro volte al giorno a seconda della banca, più le sincronizzazioni in tempo reale su richiesta. |
| Fatturazione | Per verifica, vedi [prezzi](https://docs.didit.me/it/getting-started/bank-verification-pricing.md) | Per connessione attiva al mese, vedi [prezzi](https://docs.didit.me/it/getting-started/bank-verification-pricing.md) |

L'accesso continuo è disponibile presso una banca solo se la banca lo consente.
Consulta l'[endpoint delle istituzioni](https://docs.didit.me/it/standalone-apis/bank-institutions-list.md) oppure leggi la [pagina di copertura](https://docs.didit.me/it/core-technology/bank-verification/coverage.md).
Quando una banca non può mantenere l'accesso aperto, la persona viene informata che la banca non consente l'accesso continuo e deve scegliere un'altra banca.
Imposta `allow_one_time_fallback: true` per consentire alla persona di proseguire con una lettura una tantum, dopo aver confermato sul proprio schermo l'accesso ridotto: la connessione diventa quindi `one_time`.

## Stati

| `status` | Significato | Dati leggibili | Sincronizzazioni | Fatturato |
| - | - | - | - | - |
| `pending` | Il collegamento è completato e la prima sincronizzazione è in esecuzione. | Non ancora | In esecuzione | No |
| `active` | Il consenso è valido e la sincronizzazione procede correttamente o è in fase di nuovo tentativo. | Sì | Sì | Sì |
| `renewal_required` | Il consenso è terminato, oppure la banca chiede alla persona di accedere di nuovo. `status_reason` indica quale delle due situazioni si applica. | Come nell'ultima sincronizzazione | No | No |
| `paused` | Il saldo non è sufficiente per il mese. | Come nell'ultima sincronizzazione | No | No |
| `revoked` | L'accesso è stato interrotto dalla persona, dalla banca o da te. `consent.ended_by` indica chi. | Fino a `consent.retain_until` | No | No |
| `deleted` | La connessione e i suoi dati sono stati eliminati. | No | No | No |
| `failed` | La prima sincronizzazione non è mai riuscita. | No | No | No |

`status_reason` è uno dei seguenti valori: `collection_complete`, `consent_expired`, `consent_lapsed`, `bank_requires_sign_in`, `revoked_by_end_user`, `revoked_by_bank`, `revoked_by_customer`, `insufficient_balance`, `paused_by_customer` (riservato, nessun endpoint lo imposta al momento) e `first_sync_failed`.

## Consenso

La banca stabilisce la scadenza del consenso, fino al valore di `consent_days` che hai richiesto.
Ogni connessione mostra le date reali in `consent`:

* `expires_at` e `renew_by`: la fine del consenso. Rinnova prima di questa data per non avere interruzioni.
* `renewable_until`: l'ultimo momento in cui la stessa connessione può essere riattivata dopo la fine del consenso.
* `renewed_count`, `version`, `scopes_granted` e `accounts_granted`: ciò che è stato concesso e quante volte è stato rinnovato.

Il consenso dura finché la banca lo consente.
Leggi il valore effettivo su ogni connessione e il valore specifico per banca sull'istituto.

## Rinnovo

Un rinnovo mantiene l'ID della connessione e tutti gli ID degli account, e la cronologia prosegue senza duplicati.

1. Didit invia `bank.connection.consent_expiring` 14, 7 e 1 giorno prima della scadenza.
2. Chiama [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/it/standalone-apis/bank-connection-renew). Risponde con `409 renewal_not_needed` finché restano più di 30 giorni e con `409 renewal_window_expired` dopo `consent.renewable_until`. Altrimenti risponde con `201` e un link di rinnovo.

La pagina in cui la persona completa un rinnovo non è ancora disponibile, quindi oggi non indirizzare le persone verso un link di rinnovo.

Se la persona lascia scadere il consenso, la connessione passa a `renewal_required`: i dati restano leggibili così come sono stati sincronizzati l'ultima volta e non viene addebitato nulla.
Dopo `consent.renewable_until` passa a `revoked` con `status_reason: consent_lapsed` e la persona si connette di nuovo.

Per il flusso completo consulta [Rinnova un consenso bancario](https://docs.didit.me/it/use-cases/renew-bank-consent.md).

## Interrompere l'accesso

| Chi | Come | Cosa succede |
| - | - | - |
| La persona | **Interrompi la condivisione** nella propria banca | `bank.connection.revoked` con `ended_by: end_user` o `bank` |
| Tu | [`revoke_connection`](https://docs.didit.me/it/standalone-apis/bank-connection-revoke) | Il recupero dei dati da parte della banca si interrompe immediatamente. Il consenso passa a `revocation_pending` e poi a `revoked` quando la banca conferma. I dati già letti restano leggibili finché non elimini la connessione o non scade `consent.retain_until`. |
| Tu | [`delete_connection`](https://docs.didit.me/it/standalone-apis/bank-connection-delete) | Interrompe l'accesso ed elimina la connessione e i relativi conti, saldi e transazioni. Operazione irreversibile. |

Interrompere l'accesso non equivale a eliminare.
Leggi [Dati, consenso ed eliminazione](https://docs.didit.me/it/core-technology/bank-verification/data-consent-and-deletion.md) per sapere esattamente cosa rimuove l'eliminazione.

## Una connessione eliminata

Una connessione eliminata risponde solo con `id`, `status` (`deleted`), `status_reason`, `created_at` e `erasure`.
`status_reason` può assumere i valori `deleted_by_customer`, `consent_lapsed`, `retention_elapsed` o `application_deleted`.
Tutti gli altri campi sono assenti.

## Duplicati

Un nuovo link che porta esattamente agli stessi conti che condividi già con lo stesso `end_user.reference` presso la stessa banca viene completato come rinnovo di quella connessione (`reused: true`) senza comportare un doppio addebito.
Qualsiasi altra sovrapposizione termina il link con stato `failed`, includendo `duplicate_conflict` e `conflicts_with`, prima che venga salvato o addebitato qualcosa.
Rinnova la connessione esistente oppure crea di nuovo il link con `"duplicates": "allow"` per ottenere una seconda connessione indipendente.

## Gestisci le connessioni dei tuoi clienti

* Elenco con filtri: [`GET /v3/bank/connections/`](https://docs.didit.me/it/standalone-apis/bank-connections-list) accetta `status`, `access`, `institution_id`, `country`, `vendor_data`, `end_user_reference`, `consent_expires_before` e `created_after`.
* Consulta il costo di una connessione con il suo oggetto `billing`: l'unità, il prezzo e il mese già saldato.


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