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 diconsent_days che hai richiesto.
Ogni connessione mostra le date reali in consent:
expires_aterenew_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_grantedeaccounts_granted: ciò che è stato concesso e quante volte è stato rinnovato.
Rinnovo
Un rinnovo mantiene l’ID della connessione e tutti gli ID degli account, e la cronologia prosegue senza duplicati.- Didit invia
bank.connection.consent_expiring14, 7 e 1 giorno prima della scadenza. - Chiama
POST /v3/bank/connections/{id}/renew/. Risponde con409 renewal_not_neededfinché restano più di 30 giorni e con409 renewal_window_expireddopoconsent.renewable_until. Altrimenti risponde con201e un link di rinnovo.
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 conid, 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 stessoend_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/accettastatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeecreated_after. - Consulta il costo di una connessione con il suo oggetto
billing: l’unità, il prezzo e il mese già saldato.