Vai al contenuto principale
L’API Bank data di Didit collega il conto bancario di una persona tramite Bank Link, mantiene attiva la connessione per tutto il tempo in cui la persona lo consente e fornisce conti, saldi e transazioni. URL di base https://verification.didit.me/v3/; le richieste sono autenticate con la chiave API della tua applicazione nell’intestazione x-api-key, come tutte le API autonome. Ogni operazione di scrittura accetta un Idempotency-Key. Gli elenchi accettano limit (predefinito 100, massimo 500) e proseguono con cursor, a eccezione delle letture delle transazioni: la lettura per intervallo di date prosegue con page_token, mentre il feed delle modifiche accetta un cursor durevole e prosegue la paginazione con page_token. Le letture non vengono mai addebitate. Gli errori contengono code, message, request_id, field, next_action e retry_after: distingui i casi in base a code. Ogni operazione, tranne la verifica del conto, richiede una chiave API con il permesso Bank data: l’accesso completo non lo include. La verifica del conto non usa quel permesso: richiede una chiave API con accesso in scrittura alle sessioni, oppure con accesso completo. Bank data è disponibile per le applicazioni sandbox. Le chiamate di un’applicazione live ricevono 404 finché l’accesso live non viene annunciato, e in sandbox non viene addebitato nulla.

Crea un link

POST /v3/bank/links/

Recupera un link

GET /v3/bank/links/{id}/

Annulla un link

POST /v3/bank/links/{id}/cancel/

Connessioni

Elenca connessioni

GET /v3/bank/connections/

Recupera una connessione

GET /v3/bank/connections/{id}/

Aggiorna

POST /v3/bank/connections/{id}/refresh/

Rinnova

POST /v3/bank/connections/{id}/renew/

Revoca

POST /v3/bank/connections/{id}/revoke/

Elimina

DELETE /v3/bank/connections/{id}/

Esecuzioni di sincronizzazione

GET /v3/bank/connections/{id}/sync-runs/

Recupera un'esecuzione di sincronizzazione

GET /v3/bank/connections/{id}/sync-runs/{sync_id}/

Conti, saldi e transazioni

Elenca i conti

GET /v3/bank/connections/{id}/accounts/

Ottieni un conto

GET /v3/bank/accounts/{account_id}/

Ottieni i saldi

GET /v3/bank/accounts/{account_id}/balances/

Elenca le transazioni

GET /v3/bank/accounts/{account_id}/transactions/

Feed delle modifiche alle transazioni

GET /v3/bank/connections/{id}/transactions/sync/

Banche e copertura

Elenca le istituzioni

GET /v3/bank/institutions/

Recupera un'istituzione

GET /v3/bank/institutions/{id}/

Recupera la copertura

GET /v3/bank/coverage/

Verifica del conto

POST /v3/bank/account-check/

Guide

Server SDK

I sette SDK server espongono queste operazioni sotto la risorsa bank, con il nome dell’operazione: create_link, get_connection, sync_transactions e così via.
Ultima modifica il 22 novembre 2026