Saltar al contenido principal
Didit envía webhooks bancarios cuando un enlace finaliza, cambia una conexión, el consentimiento está a punto de vencer o una sincronización almacena datos nuevos. Usan el mismo formato, firma y reintentos que cualquier otro webhook de Didit, y solo incluyen identificadores y estados: para leer los datos, consulta el objeto.
Los eventos de webhook bancarios se envían para aplicaciones de producción y de sandbox. Elige los eventos por destino con el filtro de eventos del destino, como con los demás eventos. Consulta Webhooks para ver el formato, los encabezados de firma y los reintentos.

Eventos

Todos los eventos también incluyen los campos comunes event_id, webhook_type, timestamp, created_at, application_id y environment. Los eventos bank.link.* incluyen sus campos dentro de data; los eventos de conexión, datos y sincronización los incluyen en el nivel superior. ended_by puede ser end_user, bank, customer o unknown. El esquema exacto de cada evento está en la Referencia de la API.

Ejemplo

Cómo usarlos

  • Datos nuevos. bank.data.updated es solo una señal: no se envía ningún dato. Llama a la fuente de cambios con tu cursor almacenado. Usa bank.sync.completed solo si quieres ver todas las sincronizaciones, incluidas las que no cambiaron nada.
  • Onboarding. Espera a bank.connection.created antes de leer las cuentas, y a bank.connection.history_complete antes de confiar en el historial completo.
  • Consentimiento. Con bank.connection.consent_expiring, pide a la persona que renueve. Con bank.connection.renewal_required, los datos se pueden seguir leyendo, pero ya no se sincronizan.
  • Detención. Con bank.connection.revoked, detén tu propia fuente de cambios para esa conexión y decide si quieres eliminar los datos almacenados.
  • Duplicados. Trata cada evento de forma idempotente: usa el id del evento como clave, y espera recibir el mismo evento dos veces de vez en cuando.
  • No confíes en el navegador. Confirma un enlace con bank.link.completed o GET /v3/bank/links/{id}/, no con un id de enlace enviado por una página.

Próximos pasos

Última modificación el 22 de noviembre de 2026