Vai al contenuto principale
POST
curl
Didit’s Renew a Bank Connection endpoint crea un link di rinnovo per una connessione, una scorciatoia per creare un link con mode: renew. L’ID della connessione e l’ID di ogni account restano invariati. Risponde con 409 renewal_not_needed finché restano più di 30 giorni. Consulta Rinnova un consenso bancario.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere ambiti limitati: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o solo alle sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 significa che la chiave è errata, revocata o scaduta; 403 significa che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo esterno alla sua lista IP; 404 su una route di sessione significa che la sessione è al di fuori dei workflow o degli stati consentiti alla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permesso di scrittura sulle sessioni riceve i link e i token delle sessioni come null. Vedi https://docs.didit.me/console/api-keys.

Intestazioni

Idempotency-Key
string

Chiave facoltativa per la sicurezza dei nuovi tentativi, da scegliere per una singola operazione, fino a 255 caratteri (va bene un UUID). Una richiesta ripetuta con la stessa chiave, lo stesso endpoint, la stessa query e lo stesso body riceve la prima risposta, con lo stesso status e lo stesso body, e non viene eseguita né fatturata una seconda volta. Con la stessa chiave ma un altro endpoint, query o body viene restituito 409 idempotency_key_reused; mentre la prima richiesta è ancora in esecuzione, viene restituito 409 idempotency_key_in_progress con Retry-After. Una richiesta non riuscita (qualsiasi 4xx o 5xx) non viene memorizzata, quindi puoi inviarla di nuovo con la stessa chiave. Le chiavi appartengono alla tua applicazione, sia che tu chiami con una chiave API sia con un token di accesso. Vedi Nuovi tentativi e idempotenza.

Required string length: 1 - 255

Parametri del percorso

id
string<uuid>
obbligatorio

L'id della connessione.

Corpo

application/json

Impostazioni facoltative di un link di rinnovo. Il resto deriva dalla connessione.

redirect_url
string<uri>

Dove va il browser alla fine. In un'applicazione sandbox un indirizzo http semplice di localhost, 127.0.0.1 o [::1] non richiede registrazione. Qualsiasi altro indirizzo restituisce 400 redirect_url_not_registered: la registrazione di altri indirizzi non è ancora disponibile.

Maximum string length: 2048
allowed_origins
string<uri>[]

Accettato ma non usato oggi: riservato alla Bank Link integrata di Didit, che non è ancora disponibile. Origini HTTPS, fino a 50.

Maximum array length: 50
language
string
Maximum string length: 16
Pattern: ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$
expires_in
integer
predefinito:3600

Durata in secondi, da 300 a 86400.

Intervallo richiesto: 300 <= x <= 86400

Risposta

Il link di rinnovo.

Un'esecuzione di Bank Link per una persona: collega una banca oppure rinnova una connessione. Conferma tu stesso un link con get_link: non fidarti mai di un id inviato dal browser.

id
string<uuid>
obbligatorio

Identificativo del link.

mode
enum<string>
obbligatorio
Opzioni disponibili:
connect,
renew
access
enum<string>
obbligatorio
Opzioni disponibili:
one_time,
ongoing
status
enum<string>
obbligatorio

Stato del link. completed, cancelled, expired e failed sono stati definitivi.

Opzioni disponibili:
created,
opened,
connecting,
completed,
cancelled,
expired,
failed
url
string<uri> | null
obbligatorio

La pagina ospitata a cui inviare la persona. Restituita solo alla creazione del link; null nelle letture successive, perché il token non viene memorizzato.

client_token
string | null
obbligatorio

Il token per il Bank Link incorporato di Didit, che non è ancora disponibile: apri url oggi. Viene restituito solo alla creazione del link; null nelle letture successive. Ha uno scopo unico e una validità breve. Non contiene dati personali. Non registrarlo mai nei log.

expires_at
string<date-time>
obbligatorio

Quando un link non riscattato smette di funzionare.

connection_id
string<uuid> | null
obbligatorio

La connessione creata o rinnovata da questo link, quando status è completed.

check_id
string<uuid> | null
obbligatorio

L'esito dell'assetto proprietario di questo link, quando ha richiesto ownership.compare diverso da none.

reused
boolean
obbligatorio

true quando il link è stato completato come rinnovo di una connessione esistente, perché la persona condivide già esattamente questi conti (duplicates: reuse). Nessun importo viene addebitato due volte.

error
object | null
obbligatorio

Perché il link non è riuscito, quando status è failed. Altrimenti null.

quote
object
obbligatorio

Il prezzo di un link, fissato al momento della creazione. Il costo addebitato è quello del preventivo. Le letture non addebitano nulla.

vendor_data
string | null
obbligatorio

Il tuo riferimento della richiesta.

Ultima modifica il 22 novembre 2026