Saltar al contingut principal
Les dades bancàries estan disponibles per a les aplicacions de sandbox. Les crides d’una aplicació en producció retornen 404 fins que s’anunciï l’accés en producció, i a la sandbox no es cobra res. Aquesta guia ràpida et porta des d’una aplicació de sandbox fins als comptes, els saldos i les transaccions del Didit Test Bank, amb sol·licituds per copiar i enganxar.
Cada resposta següent s’ha reduït als camps rellevants. Guarda la clau d’API al servidor: mai arriba a un navegador ni a una aplicació.

Pas 1: crea una clau d’API amb el permís Bank data

Bank data no forma part de l’accés complet. Una clau amb accés complet, inclòs el secret principal de l’aplicació, és rebutjada en totes les crides de Bank data amb 403 bank_data_access_denied.
  1. A la Business Console, obre la teva aplicació de sandbox i ves a API keys.
  2. Crea una clau amb accés personalitzat i afegeix Bank data: Read per a les lectures, Write per a les crides que creen, modifiquen o eliminen alguna cosa.
  3. Copia la clau i exporta-la:
Consulta API keys per a la llista completa de recursos.

Pas 2: crea un enllaç

Un enllaç és un recorregut per les pantalles en què una persona connecta un banc. Crea’n un de continu per al Test Bank:
country és el codi de tres lletres del país del banc de la persona i és opcional. Envia’l quan el coneguis, perquè la persona només vegi els bancs d’aquest país; si no l’envies, pot triar entre tots els països que pots atendre. Per a un accés d’un sol ús, envia "access": "one_time" (el valor per defecte).
Guarda l’id de l’enllaç amb el teu usuari. La url i el client_token es retornen una sola vegada, quan es crea l’enllaç.

Pas 3: obre l’enllaç i connecta el Didit Test Bank

Obre el url en un navegador o envia’l a la persona per correu electrònic o per xat. La persona veu la pantalla de consentiment, tria Didit Test Bank, inicia sessió amb un dels clients de prova i tria els comptes que vol compartir. La pàgina de sandbox enumera els clients de prova i què et proporciona cadascun. Per fer tornar la persona al teu lloc web després, consulta Tornar al teu lloc. Sense un redirect_url, la persona acaba a la pàgina de resultats de Didit i tu coneixes el resultat pel webhook o mitjançant una consulta.

Pas 4: rebre els webhooks i confirmar

Subscriu una destinació del webhook als esdeveniments bank.* a la consola, igual que per a qualsevol webhook. Quan la persona acaba, arriba bank.link.completed amb el link_id i el connection_id, i després bank.connection.created quan la primera sincronització hagi desat els comptes. No confiïs mai en un identificador d’enllaç que t’envii el navegador. Consulta tu mateix l’enllaç:
L’status és completed o un estat final (cancelled, expired, failed). Un enllaç failed inclou un error.code; un de cancelled mostra error: null.

Pas 5: llegeix comptes, saldos i transaccions

Els imports són cadenes decimals i són negatius quan representen sortides de diners. Una pàgina de transaccions inclou next_page_token mentre encara hi hagi més dades per llegir. Consulta Comptes, saldos i transaccions.

Pas 6: segueix el canal de canvis

El canal de canvis retorna només el que ha canviat des de la teva última lectura. La primera lectura, sense cursor, és la instantània completa: totes les transaccions que té la connexió, cadascuna com a added, amb reset: true. Una primera pàgina pot portar has_more: true amb un next_page_token i encara sense next_cursor. Continua llegint amb page_token mentre has_more sigui true, i guarda el next_cursor de l’última pàgina (la que té has_more: false) per a la pròxima vegada:
reset: true vol dir que la resposta és una instantània completa: substitueix la teva còpia per aquesta en lloc d’afegir-hi dades. bank.data.updated t’indica quan una sincronització ha desat alguna cosa nova.

Pas 7: sincronitza ara

Una connexió contínua es sincronitza sola. Per llegir les dades del banc ara mateix, demana una sincronització:
Un banc permet un nombre limitat de lectures sense intervenció de l’usuari al dia. sync.live_syncs_left_today i sync.budgets de la connexió indiquen quantes en queden i quan es reinicien, i una crida que superi el límit respon 429 refresh_limit_reached amb l’hora del reinici. Consulta Actualitza les dades del banc sota demanda.

Pas 8: atura l’accés i suprimeix

Aturar l’accés i suprimir són dues crides diferents.
Una connexió suprimida només respon amb els camps id, status, status_reason, created_at i erasure. Consulta Dades, consentiment i supressió.

Següents passos

Darrera modificació el 22 de novembre del 2026