> ## 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.

# Flux bancari per a comptabilitat: saldos i transaccions

> Amb Didit, crea un flux diari de saldos i transaccions per a cada client: enllaç continu, webhooks, cursor, reinici i aturada.

Un flux bancari continu ofereix a un producte de comptabilitat o de teneduria de llibres els saldos i les transaccions dels comptes bancaris de cada client cada dia, sense que el client hagi d'iniciar sessió de nou.

Amb Didit crees un enllaç amb accés continu, reps webhooks quan arriben dades noves, llegeixes només el que ha canviat amb un cursor, vigiles quan acaba el consentiment, i aturs o elimines l'accés quan el client se'n va.

Aquesta guia et porta de zero a un flux diari per a un client. El mateix codi funciona per a tots els clients: una connexió per client i banc.

## Què necessites

* Una clau d'API amb el permís de dades bancàries, per a la teva aplicació de sandbox. Consulta el [inici ràpid](https://docs.didit.me/ca/core-technology/bank-verification/quickstart.md#pas-1-crea-una-clau-d’api-amb-el-permís-bank-data).
* Una destinació del webhook que rebi els esdeveniments `bank.*`. Consulta [Webhooks bancaris](https://docs.didit.me/ca/core-technology/bank-verification/webhooks.md).
* Una taula a la teva base de dades per a l'identificador de connexió, el cursor del flux de canvis i el final del consentiment de cada client.

## Pas 1: crea un enllaç amb accés continu

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "segment": "business",
    "data": ["accounts", "balances", "transactions"],
    "history_from": "2026-01-01",
    "consent_days": 180,
    "ownership": { "compare": "none" },
    "end_user": { "reference": "client-7731", "email": "ana@example.com" },
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

* `access: ongoing` manté l'accés obert fins que acabi el consentiment. `consent_days` és una sol·licitud: el banc decideix la data real, que es mostra a la connexió.
* `history_from` demana l'historial a partir d'una data, per exemple l'inici de l'any. Fes servir `history_days` (de 1 a 365) si ho prefereixes, però mai les dues. El banc pot lliurar-ne menys: cada compte indica `history_coverage`.
* `ownership.compare: none` omet la comparació del titular, de manera que no cal cap identitat de referència. Fes servir `business` per comparar el titular amb una empresa verificada a Didit.
* `end_user.reference` és el teu identificador del client. És cercable i permet que Didit reconegui el mateix client quan connecta els mateixos comptes un altre cop.
* Envia el client a la [pàgina de verificació allotjada](https://docs.didit.me/ca/integration/bank-link/hosted-link.md) i torna'l al teu producte amb una [URL de redirecció](https://docs.didit.me/ca/integration/bank-link/return-to-your-site.md).

Guarda el `id` de l'enllaç amb el client.

## Pas 2: espera la connexió

Quan el client acaba, arriba `bank.link.completed` amb el `connection_id`.
Confirma-ho, perquè mai no es confia en el navegador:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

Desa el `connection_id` i espera `bank.connection.created`: aleshores es poden llegir els comptes, els saldos i les transaccions recents (`sync.initial_status` és `succeeded` o `partial`).
`bank.connection.history_complete` arriba quan acaba la càrrega de l'historial.
Per a cada compte, `history_coverage.oldest_booking_date` indica fins a quina data enrere el banc ha lliurat realment les dades.

## Pas 3: carrega la primera còpia

Un cursor buit retorna totes les transaccions actuals com a `added` amb `reset: true`.
Recorre'l pàgina a pàgina i emmagatzema el cursor només al final:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?limit=500" \
  -H "x-api-key: $DIDIT_API_KEY"
```

```python theme={null}
cursor, page_token = stored_cursor or "", None
while True:
    params = {"limit": 500, "page_token": page_token} if page_token else {"cursor": cursor, "limit": 500}
    page = get(f"/v3/bank/connections/{connection_id}/transactions/sync/", params)
    if page["reset"] and not page_token:
        wipe_local_copy(connection_id)       # replace, never append
    apply(page["added"], page["modified"], page["removed"])
    if not page["has_more"]:
        store_cursor(connection_id, page["next_cursor"])
        break
    page_token = page["next_page_token"]
```

* La primera lectura és una instantània real: retorna totes les transaccions que tenia la connexió quan va començar la lectura, cadascuna exactament una vegada com a `added`, en el seu estat actual, fins i tot si es fa una sincronització mentre pagines.
* Els canvis fets mentre pagines arriben en la lectura següent des de `next_cursor`: una transacció que ja has rebut torna com a `modified`, i una de nova, com a `added`.
* Emmagatzema `next_cursor` només després d'una resposta amb `has_more: false`.
* Si la paginació falla a mig camí, reinicia des del cursor que has emmagatzemat.
* Llegeix els saldos amb `GET /v3/bank/accounts/{account_id}/balances/`.

## Pas 4: mantén-te al dia amb cada webhook

Didit sincronitza cada connexió contínua activa automàticament entre una i quatre vegades al dia, segons el banc (`sync.frequency_per_day`).
Quan una sincronització emmagatzema canvis, `bank.data.updated` arriba amb el `connection_id`, els `account_ids` i els recomptes.
Crida el canal de canvis amb el cursor emmagatzemat:

* `added` són transaccions noves, incloses les pendents.
* `modified` són transaccions que han canviat, en el seu estat actual. Aplica cadascuna com una operació d'inserció o actualització per `id`: si ja la tens, s'actualitza, i si encara no la tens, s'afegeix.
* `removed` porten un `reason`. Ignora un `id` que no tinguis. Quan una transacció pendent es comptabilitza, surt a `removed` amb `pending_booked` i la comptabilitzada arriba a `added`.

Usa l'`id` de la transacció com a clau: es manté igual entre lectures, sincronitzacions i renovacions.
Revisa `identity_quality`: amb `derived`, una correcció bancària pot aparèixer com un `removed` i un `added`.
Les lectures no es facturen mai, però les dades només canvien quan s'executa una sincronització, de manera que n'hi ha prou amb una lectura per webhook.
Per obtenir-les abans, usa Sync Now: [Actualitza les dades bancàries sota demanda](https://docs.didit.me/ca/use-cases/refresh-bank-data-on-demand.md).

## Pas 5: gestionar el reinici

Un cursor més antic que la finestra de reproducció respon amb `410 cursor_expired` i `bootstrap: true`.
El registre de canvis es pot reproduir durant 90 dies, de manera que això és poc freqüent en una tasca diària.
Torna a començar des d'un cursor buit i substitueix la teva còpia pel resultat en lloc d'afegir-hi dades.
Cada lectura des d'un cursor buit inclou `reset: true`, de manera que el mateix camí de codi gestiona una connexió nova i un cursor caducat.

## Pas 6: controla quan caduca el consentiment

El consentiment té una data de caducitat: `consent.expires_at`.
Didit envia `bank.connection.consent_expiring` 14, 7 i 1 dies abans.

Crida [`renew_connection`](https://docs.didit.me/ca/standalone-apis/bank-connection-renew) quan vulguis renovar: respon `409 renewal_not_needed` fins que quedin 30 dies.
La pàgina on el client completa una renovació encara no està disponible.

Si el client deixa caducar el consentiment, la connexió passa a `renewal_required`: encara pots llegir les dades que s'han sincronitzat.
Els detalls són a [Renova un consentiment bancari](https://docs.didit.me/ca/use-cases/renew-bank-consent.md).

## Pas 7: atura l'accés i elimina

* El client abandona el teu producte: crida [`revoke_connection`](https://docs.didit.me/ca/standalone-apis/bank-connection-revoke) per aturar la lectura immediatament, o [`delete_connection`](https://docs.didit.me/ca/standalone-apis/bank-connection-delete) per aturar-la i eliminar les dades emmagatzemades.
* El client deixa de compartir des del banc: `bank.connection.revoked` arriba amb `ended_by`. Atura el flux de dades d'aquesta connexió.

## Preu

L'accés continu es factura per connexió activa al mes.
El preu inclou tots els comptes de la connexió, els saldos, les transaccions, fins a 365 dies d'historial quan el banc el facilita, les sincronitzacions automàtiques, les sincronitzacions en directe dins dels límits del banc, les renovacions, els webhooks i totes les lectures.
Un enllaç que ningú no completa és gratuït, i també ho són les connexions amb `renewal_required`, `paused` i `revoked`.
Consulta [Preus](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md#dades-bancàries-i-accés-continu).

## Checklist

* [ ] Una connexió per client i banc, emmagatzemada amb el seu cursor i la data de finalització del consentiment.
* [ ] El gestor de webhooks és idempotent, amb l'identificador de l'esdeveniment com a clau.
* [ ] `reset: true` substitueix la teva còpia, mai no l'afegeix.
* [ ] `removed` es gestiona, amb el seu motiu.
* [ ] Els recordatoris de consentiment estan connectats amb la teva pròpia notificació al client.
* [ ] `bank.connection.revoked` atura el flux.
* [ ] El pla de sandbox de [Sandbox](https://docs.didit.me/ca/core-technology/bank-verification/sandbox.md#un-bon-pla-de-proves) supera la prova.


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