Vai al contenuto principale
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 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

L’accesso continuo è disponibile presso una banca solo se la banca lo consente. Consulta l’endpoint delle istituzioni oppure leggi la pagina di copertura. 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_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/. 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.

Interrompere l’accesso

Interrompere l’accesso non equivale a eliminare. Leggi Dati, consenso ed eliminazione 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/ 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.
Ultima modifica il 22 novembre 2026