Saltar al contingut principal
L’API de dades bancàries de Didit emmagatzema els comptes, els saldos i les transaccions de cada connexió i els serveix mitjançant endpoints de lectura amb paginació (cursor a les llistes, page_token a les lectures de transaccions). Els imports són cadenes decimals amb un currency ISO 4217 separat, les dates són ISO 8601 i els països són ISO alpha-3. Les lectures mai no es facturen.

Comptes

GET /v3/bank/connections/{id}/accounts/ llista els comptes d’una connexió, i GET /v3/bank/accounts/{account_id}/ en retorna un. Fes servir account_ref per reconèixer un compte bancari quan una persona el torna a connectar, i id per a tot el que hi ha dins d’una mateixa connexió.

Saldos

GET /v3/bank/accounts/{account_id}/balances/ retorna els saldos tipificats amb les seves dates de referència.
type és booked, available o expected, i iso_type conté el codi ISO 20022 del banc quan el banc el proporciona.

Transaccions

GET /v3/bank/accounts/{account_id}/transactions/ llegeix un interval de dates. Accepta date_from i date_to (dates de calendari tal com les informa el banc, incloses), status (booked o pending, els dos per defecte), limit (fins a 500) i page_token. Ordena per effective_date de manera descendent i, després, per id.
  • id és de Didit i s’emmagatzema la primera vegada que es veu. El mateix moviment conserva el seu id entre lectures, sincronitzacions i renovacions.
  • identity_quality indica com de sòlida és aquesta garantia. bank_reference i route_id són estables. derived vol dir que el moviment s’ha identificat pel seu contingut, de manera que una correcció del banc pot aparèixer com un removed i un added.
  • status és booked o pending. Una transacció pendent té el seu propi id. Quan el banc la comptabilitza, la transacció comptabilitzada arriba com a added, i la pendent com a removed amb reason: pending_booked. pending_id només s’informa quan el banc les enllaça.
  • amount és amb signe: un valor negatiu vol dir diners que surten. direction repeteix el signe.
  • bank_reference és la referència d’entrada immutable del banc, i és null quan el banc no la facilita. Didit mai no la inventa.
  • category és la categorització pròpia de Didit, quan és aplicable.
  • Una correcció del banc sobre una transacció comptabilitzada és modified. Una anul·lació és una transacció nova, amb reverses_id quan el banc la enllaça.

Els camps que un banc no envia són null

Tots els camps que un banc no envia són null. L’entitat enumera a transaction_fields els camps que se sap que envia, juntament amb pending_transactions, pending_linkage, balance_types i history_days_max, perquè ningú descobreixi buits en producció. Utilitza el client de prova sparse_fields del sandbox per provar el teu codi amb un banc que envia poca informació.

Paginació d’un interval de dates

Continua llegint amb page_token mentre has_more sigui true. El token fixa la instantània de la lectura durant una hora: les addicions posteriors a la primera pàgina no hi són, cada fila es serveix en el seu estat actual, i una fila eliminada durant la paginació deixa de sortir a les pàgines següents i apareix al flux de canvis. Un token caducat respon amb 410 page_expired: reinicia la lectura des de la seva consulta original.

El flux de canvis

GET /v3/bank/connections/{id}/transactions/sync/ retorna els canvis de tots els comptes d’una connexió des d’un cursor.
  • Un cursor buit retorna totes les transaccions actuals com a added amb reset: true. Substitueix la teva còpia per aquestes dades en lloc d’afegir-les-hi.
  • Continua paginant amb page_token mentre has_more sigui true. 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 havies emmagatzemat.
  • Un cursor és opac i està vinculat a la connexió i a l’entorn. El registre de canvis es pot reproduir durant 90 dies. Un cursor més antic respon amb 410 cursor_expired i bootstrap: true: torna a començar des d’un cursor buit i substitueix la teva còpia.
  • removed[].reason és pending_booked, pending_expired, bank_removed o access_removed.
La versió pas a pas és a Flux bancari continu per a la comptabilitat.

Capçaleres

Totes dues consultes de transaccions retornen les capçaleres X-RateLimit-* (600 lectures i 300 escriptures per minut per aplicació, i un 429 amb Retry-After quan se superen aquests límits) i X-Bank-Last-Synced-At. Els límits de l’API i els límits propis del banc per a les consultes són coses diferents: consulta Actualitzar les dades bancàries sota demanda.
Darrera modificació el 22 de novembre del 2026