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_qualityindica com de sòlida és aquesta garantia.bank_referenceiroute_idsón estables.derivedvol dir que el moviment s’ha identificat pel seu contingut, de manera que una correcció del banc pot aparèixer com unremovedi unadded.statusésbookedopending. Una transacció pendent té el seu propi id. Quan el banc la comptabilitza, la transacció comptabilitzada arriba com aadded, i la pendent com aremovedambreason: pending_booked.pending_idnomés s’informa quan el banc les enllaça.amountés amb signe: un valor negatiu vol dir diners que surten.directionrepeteix el signe.bank_referenceés la referència d’entrada immutable del banc, i ésnullquan 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, ambreverses_idquan el banc la enllaça.
Els camps que un banc no envia són null
Tots els camps que un banc no envia sónnull.
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 ambpage_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
addedambreset: true. Substitueix la teva còpia per aquestes dades en lloc d’afegir-les-hi. - Continua paginant amb
page_tokenmentrehas_moresigui true. Emmagatzemanext_cursornomés després d’una resposta ambhas_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_expiredibootstrap: true: torna a començar des d’un cursor buit i substitueix la teva còpia. removed[].reasonéspending_booked,pending_expired,bank_removedoaccess_removed.
Capçaleres
Totes dues consultes de transaccions retornen les capçaleresX-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.