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.
- Una destinació del webhook que rebi els esdeveniments
bank.*. Consulta Webhooks bancaris.
- 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
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 i torna’l al teu producte amb una URL de redirecció.
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:
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:
- 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.
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 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.
Pas 7: atura l’accés i elimina
- El client abandona el teu producte: crida
revoke_connection per aturar la lectura immediatament, o delete_connection 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.
Checklist
Darrera modificació el 22 de novembre del 2026