Saltar al contingut principal
Didit envia webhooks bancaris quan un enllaç finalitza, una connexió canvia, el consentiment està a punt de caducar o una sincronització emmagatzema dades noves. Fan servir la mateixa estructura, signatura i reintents que la resta de webhooks de Didit, i només transmeten identificadors i estats: per llegir-ne el contingut, has de recuperar l’objecte.
Els esdeveniments de webhook bancaris s’envien per a aplicacions de producció i de sandbox. Tria els esdeveniments per destinació amb el filtre d’esdeveniments de la destinació, igual que per a la resta d’esdeveniments. Consulta Webhooks per a l’estructura, les capçaleres de signatura i els reintents.

Esdeveniments

Cada esdeveniment inclou també els camps comuns event_id, webhook_type, timestamp, created_at, application_id i environment. Els esdeveniments bank.link.* porten els seus camps dins de data; els esdeveniments de connexió, de dades i de sincronització els porten al nivell superior. ended_by és end_user, bank, customer o unknown. L’esquema exacte de cada esdeveniment és a la Referència de l’API.

Exemple

Com utilitzar-los

  • Dades noves. bank.data.updated és només un senyal: no s’envia cap dada. Crida el feed de canvis amb el teu cursor emmagatzemat. Utilitza bank.sync.completed només si vols veure cada sincronització, incloses les que no han canviat res.
  • Alta. Espera bank.connection.created abans de llegir els comptes, i bank.connection.history_complete abans de confiar en l’historial complet.
  • Consentiment. Quan rebis bank.connection.consent_expiring, demana a la persona que renovi el consentiment. Quan rebis bank.connection.renewal_required, les dades encara es poden llegir, però ja no se sincronitzen.
  • Aturada. Quan rebis bank.connection.revoked, atura el teu propi feed per a aquesta connexió i decideix si vols eliminar les dades emmagatzemades.
  • Duplicats. Tracta cada esdeveniment de manera idempotent: usa l’identificador de l’esdeveniment com a clau, i espera que el mateix esdeveniment arribi dues vegades de tant en tant.
  • No confiïs mai en el navegador. Confirma un enllaç amb bank.link.completed o amb GET /v3/bank/links/{id}/, no amb un identificador d’enllaç enviat per una pàgina.

Propers passos

Darrera modificació el 22 de novembre del 2026