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. Usabank.sync.completedsolo se vuoi vedere ogni sincronizzazione, anche quelle che non hanno modificato nulla. - Onboarding. Attendi
bank.connection.createdprima di leggere i conti, ebank.connection.history_completeprima di fare affidamento sullo storico completo. - Consenso. Su
bank.connection.consent_expiringchiedi alla persona di rinnovarlo. Subank.connection.renewal_requiredi dati sono ancora leggibili ma non vengono più sincronizzati. - Stop. Su
bank.connection.revokedinterrompi 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.completedoGET /v3/bank/links/{id}/, non con un ID di link inviato da una pagina.
Passaggi successivi
- Feed bancario continuo per la contabilità
- Sandbox: il Didit Test Bank genera questi eventi.