> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks de banca: eventos de enlace, conexión y datos

> Eventos webhook bank.link, bank.connection, bank.data y bank.sync de Didit: cuándo se envían, qué contienen y cómo usarlos para la lectura diaria.

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.

> [!NOTE]
>
> 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](https://docs.didit.me/es/integration/webhooks.md) para ver el formato, los encabezados de firma y los reintentos.

## Eventos

| Evento | Cuándo | Campos |
| - | - | - |
| `bank.link.completed` | Una persona conectó un banco. | `data.link_id`, `data.status`, `data.connection_id`, `data.check_id`, `data.error_code` (siempre `null`) |
| `bank.link.cancelled` | La persona canceló. | `data.link_id`, `data.status` |
| `bank.link.expired` | El enlace caducó antes de completarse. | `data.link_id`, `data.status` |
| `bank.link.failed` | El enlace terminó con un error. | `data.link_id`, `data.status`, `data.error_code` |
| `bank.connection.created` | La primera sincronización terminó y las cuentas ya se pueden leer. | `connection_id`, `initial_status` |
| `bank.connection.history_complete` | La carga del historial terminó, por cualquier motivo. | `connection_id`, `status` |
| `bank.connection.updated` | Cambió el estado, el consentimiento o el estado de la sincronización. | `connection_id`, `status`, `revocation_status` |
| `bank.connection.consent_expiring` | 14, 7 y 1 día antes de que termine el consentimiento. | `connection_id`, `days_left`, `consent_expires_at`, `renew_by` |
| `bank.connection.renewal_required` | Terminó el consentimiento, o el banco pide a la persona que vuelva a iniciar sesión. | `connection_id`, `status`, `reason`, `renew_by`, `renewable_until` |
| `bank.connection.renewed` | Se completó un enlace de renovación. | `connection_id`, `status`, `consent_version`, `link_id`, `consent_expires_at` |
| `bank.connection.revoked` | El acceso finalizó. | `connection_id`, `status`, `ended_by`, `status_reason`, `ended_at`, `retain_until` |
| `bank.connection.deleted` | La conexión y sus datos se eliminaron. | `connection_id`, `status`, `erasure_status`, `reason`, `erased_at` |
| `bank.data.updated` | Una sincronización almacenó cambios. | `connection_id`, `sync_id`, `trigger`, `accounts` (IDs con sus recuentos), `balances_changed` |
| `bank.sync.completed` | Terminaron todas las sincronizaciones. | `connection_id`, `sync_id`, `trigger`, `outcome`, `changed` |
| `bank.sync.failed` | Una sincronización sigue fallando. | `connection_id`, `sync_id`, `error_code`, `failing_since` |
| `bank.sync.recovered` | Una sincronización que fallaba vuelve a funcionar. | `connection_id`, `sync_id` |

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](https://docs.didit.me/es/standalone-apis/bank-data.md).

## Ejemplo

```json theme={null}
{
  "event_id": "7c1e0a52-93d4-4a6b-8f21-0d5b9e3a64c7",
  "webhook_type": "bank.sync.completed",
  "timestamp": 1763804640,
  "created_at": 1763804640,
  "application_id": "b3e1f0a2-5d64-4c8e-9a17-2f6d0c8b7e41",
  "environment": "sandbox",
  "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6",
  "sync_id": "c2b8d4f6-9a13-4e07-85bc-3d6e1f0a7b92",
  "trigger": "scheduled",
  "outcome": "succeeded",
  "changed": true
}
```

## 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](https://docs.didit.me/es/standalone-apis/bank-transactions-sync.md) 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](https://docs.didit.me/es/standalone-apis/bank-connection-delete.md) 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

* [Flujo continuo de datos bancarios para contabilidad](https://docs.didit.me/es/use-cases/bank-data-for-accounting.md)
* [Sandbox](https://docs.didit.me/es/core-technology/bank-verification/sandbox.md): Didit Test Bank emite estos eventos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.