404 finché l’accesso live non viene annunciato, e in sandbox non viene addebitato nulla.
Questa guida rapida ti accompagna da un’applicazione sandbox ai conti, ai saldi e alle transazioni della Didit Test Bank, con richieste da copiare e incollare.
Ogni risposta qui sotto è abbreviata ai soli campi rilevanti.
Conserva la chiave API sul tuo server: non arriva mai a un browser o a un’app.
Passaggio 1: crea una chiave API con l’autorizzazione Bank data
Bank data non fa parte dell’accesso completo. Una chiave con accesso completo, inclusa la chiave segreta principale dell’applicazione, viene rifiutata in tutte le chiamate a Bank data con403 bank_data_access_denied.
- Nella Business Console, apri la tua applicazione sandbox e vai su Chiavi API.
- Crea una chiave con accesso personalizzato e aggiungi Bank data: Read per le letture, Write per le chiamate che creano, modificano o eliminano qualcosa.
- Copia la chiave ed esportala:
Passo 2: crea un link
Un link corrisponde a un percorso attraverso le schermate in cui una persona collega una banca. Crea un link continuativo per la Test Bank:country è il paese, in formato di tre lettere, della banca della persona ed è facoltativo.
Invialo quando lo conosci, così la persona vede solo le banche di quel paese; senza di esso sceglie tra tutti i paesi che puoi servire.
Per un accesso una tantum invia "access": "one_time" (il valore predefinito).
id del link insieme al tuo utente.
url e client_token vengono restituiti una sola volta, al momento della creazione del link.
Passaggio 3: apri il link e collega la Didit Test Bank
Apri l’url in un browser oppure invialo alla persona via email o chat.
La persona vede la schermata di consenso, sceglie Didit Test Bank, accede con uno dei clienti di prova e sceglie i conti da condividere.
La pagina sandbox elenca i clienti di prova e ciò che ciascuno ti consente di ottenere.
Per riportare la persona sul tuo sito al termine, consulta Torna al tuo sito.
Senza un redirect_url la persona termina sulla pagina dei risultati di Didit e tu conosci l’esito tramite il webhook o da una lettura.
Passaggio 4: ricevi i webhook e conferma
Sottoscrivi una destinazione webhook agli eventibank.* nella console, come per qualsiasi webhook.
Quando l’utente completa il processo, arriva bank.link.completed con il link_id e il connection_id, poi bank.connection.created quando la prima sincronizzazione ha salvato i conti.
Non fidarti mai di un ID del link che ti invia il browser.
Leggi tu stesso il link:
status è completed oppure uno stato finale (cancelled, expired, failed). Un link failed riporta un error.code; uno cancelled riporta error: null.
Passaggio 5: leggere conti, saldi e transazioni
next_page_token finché sono disponibili altri dati da leggere.
Consulta Conti, saldi e transazioni.
Passaggio 6: segui il flusso delle modifiche
Il flusso delle modifiche restituisce solo ciò che è cambiato dall’ultima lettura. La prima lettura, senza cursore, è l’istantanea completa: ogni transazione della connessione, ciascuna comeadded, con reset: true.
Una prima pagina può contenere has_more: true con un next_page_token e nessun next_cursor per ora.
Continua a leggere con page_token finché has_more è true, e conserva il next_cursor dell’ultima pagina (quella con has_more: false) per la lettura successiva:
reset: true indica che la risposta è un’istantanea completa: sostituisci la tua copia con quella invece di aggiungere dati.
bank.data.updated ti avvisa quando una sincronizzazione ha salvato dati nuovi.
Passaggio 7: sincronizza ora
Una connessione attiva si sincronizza da sola. Per leggere subito i dati della banca, richiedi una sincronizzazione:sync.live_syncs_left_today e sync.budgets sulla connessione indicano quante ne restano e quando vengono azzerate. Una chiamata oltre il limite restituisce 429 refresh_limit_reached con l’orario di reset.
Vedi Aggiornare i dati bancari su richiesta.
Passaggio 8: interrompi l’accesso ed elimina
Interrompere l’accesso ed eliminare sono due chiamate diverse.id, status, status_reason, created_at ed erasure.
Vedi Dati, consenso ed eliminazione.
Prossimi passi
- Connessioni: accesso una tantum e continuo, consenso e rinnovo.
- Webhook bancari
- Prezzi
- Riferimento API