> ## 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 bancaris: enllaç, connexió i esdeveniments de dades

> Esdeveniments webhook bank.link, bank.connection, bank.data i bank.sync de Didit: quan s'envien, què contenen i com usar-los.

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.

> [!NOTE]
>
> 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](https://docs.didit.me/ca/integration/webhooks.md) per a l'estructura, les capçaleres de signatura i els reintents.

## Esdeveniments

| Esdeveniment | Quan | Camps |
| - | - | - |
| `bank.link.completed` | Una persona ha connectat un banc. | `data.link_id`, `data.status`, `data.connection_id`, `data.check_id`, `data.error_code` (sempre `null`) |
| `bank.link.cancelled` | La persona ha cancel·lat l'operació. | `data.link_id`, `data.status` |
| `bank.link.expired` | L'enllaç ha caducat abans de completar-se. | `data.link_id`, `data.status` |
| `bank.link.failed` | L'enllaç ha acabat amb un error. | `data.link_id`, `data.status`, `data.error_code` |
| `bank.connection.created` | Ha acabat la primera sincronització i els comptes es poden llegir. | `connection_id`, `initial_status` |
| `bank.connection.history_complete` | Ha acabat la càrrega de l'historial, per qualsevol motiu. | `connection_id`, `status` |
| `bank.connection.updated` | Ha canviat l'estat, el consentiment o l'estat de la sincronització. | `connection_id`, `status`, `revocation_status` |
| `bank.connection.consent_expiring` | 14, 7 i 1 dia abans que acabi el consentiment. | `connection_id`, `days_left`, `consent_expires_at`, `renew_by` |
| `bank.connection.renewal_required` | El consentiment ha acabat, o el banc demana a la persona que torni a iniciar sessió. | `connection_id`, `status`, `reason`, `renew_by`, `renewable_until` |
| `bank.connection.renewed` | Ha acabat un enllaç de renovació. | `connection_id`, `status`, `consent_version`, `link_id`, `consent_expires_at` |
| `bank.connection.revoked` | L'accés ha finalitzat. | `connection_id`, `status`, `ended_by`, `status_reason`, `ended_at`, `retain_until` |
| `bank.connection.deleted` | La connexió i les seves dades s'han eliminat. | `connection_id`, `status`, `erasure_status`, `reason`, `erased_at` |
| `bank.data.updated` | Una sincronització ha desat canvis. | `connection_id`, `sync_id`, `trigger`, `accounts` (identificadors amb recomptes), `balances_changed` |
| `bank.sync.completed` | Han acabat totes les sincronitzacions. | `connection_id`, `sync_id`, `trigger`, `outcome`, `changed` |
| `bank.sync.failed` | Una sincronització continua fallant. | `connection_id`, `sync_id`, `error_code`, `failing_since` |
| `bank.sync.recovered` | Una sincronització que fallava torna a funcionar. | `connection_id`, `sync_id` |

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

## Exemple

```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
}
```

## Com utilitzar-los

* **Dades noves.** `bank.data.updated` és només un senyal: no s'envia cap dada. Crida el [feed de canvis](https://docs.didit.me/ca/standalone-apis/bank-transactions-sync.md) 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](https://docs.didit.me/ca/standalone-apis/bank-connection-delete.md) 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

* [Alimentació bancària contínua per a comptabilitat](https://docs.didit.me/ca/use-cases/bank-data-for-accounting.md)
* [Sandbox](https://docs.didit.me/ca/core-technology/bank-verification/sandbox.md): el Didit Test Bank genera aquests esdeveniments.


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