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 amb403 bank_data_access_denied.
- A la Business Console, obre la teva aplicació de sandbox i ves a API keys.
- 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.
- Copia la clau i exporta-la:
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).
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 elurl 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 esdevenimentsbank.* 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ç:
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
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 aadded, 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ó: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.id, status, status_reason, created_at i erasure.
Consulta Dades, consentiment i supressió.
Següents passos
- Connexions: accés puntual i continu, consentiment i renovació.
- Webhooks bancaris
- Preus
- Referència de l’API