Vai al contenuto principale
Didit invia i webhook bancari quando un link si conclude, una connessione cambia, il consenso sta per scadere o una sincronizzazione memorizza nuovi dati. Usano la stessa struttura, la stessa firma e gli stessi tentativi di qualsiasi altro webhook Didit, e contengono solo ID e stati: per leggerne il contenuto devi recuperare l’oggetto.
Gli eventi webhook bancari vengono inviati per le applicazioni di produzione e sandbox. Scegli gli eventi per destinazione con il filtro eventi della destinazione, come per gli altri eventi. Consulta Webhook per la struttura, le intestazioni di firma e i tentativi.

Eventi

Ogni evento contiene anche i campi comuni event_id, webhook_type, timestamp, created_at, application_id ed environment. Gli eventi bank.link.* riportano i propri campi sotto data; gli eventi di connessione, dati e sincronizzazione li riportano al livello superiore. ended_by può assumere i valori end_user, bank, customer o unknown. Lo schema esatto di ogni evento è nel riferimento API.

Esempio

Come usarli

  • Nuovi dati. bank.data.updated è solo un segnale: non viene inviato alcun dato. Chiama il feed delle modifiche con il cursore che hai memorizzato. Usa bank.sync.completed solo se vuoi vedere ogni sincronizzazione, anche quelle che non hanno modificato nulla.
  • Onboarding. Attendi bank.connection.created prima di leggere i conti, e bank.connection.history_complete prima di fare affidamento sullo storico completo.
  • Consenso. Su bank.connection.consent_expiring chiedi alla persona di rinnovarlo. Su bank.connection.renewal_required i dati sono ancora leggibili ma non vengono più sincronizzati.
  • Stop. Su bank.connection.revoked interrompi il tuo feed per quella connessione e decidi se eliminare i dati memorizzati.
  • Duplicati. Gestisci ogni evento in modo idempotente: usa l’ID dell’evento come chiave, e aspettati che lo stesso evento arrivi due volte ogni tanto.
  • Non fidarti mai del browser. Conferma un link con bank.link.completed o GET /v3/bank/links/{id}/, non con un ID di link inviato da una pagina.

Passaggi successivi

Ultima modifica il 22 novembre 2026