Saltar al contingut principal
GET
curl
L’endpoint Get a Bank Link de Didit retorna l’estat d’un enllaç i, una vegada completat, el seu connection_id i el seu check_id. Crida’l des del servidor després de onSuccess o de bank.link.completed: no confiïs mai en un identificador d’enllaç enviat per un navegador. Un enllaç fallit retorna 200 amb status: failed i un error amb un codi com duplicate_conflict o reduced_grant.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau principal té accés complet. Una clau amb nom es pot limitar: cap, lectura o escriptura per recurs, limitada a alguns fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 vol dir que la clau és incorrecta, revocada o caducada; 403 vol dir que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud ve d'una adreça fora de la seva llista d'adreces IP; 404 en una ruta de sessió vol dir que la sessió queda fora dels fluxos de treball o estats de la clau. Una clau sense accés a multimèdia rep les URL d'imatges, vídeos i PDF com a null, i una clau sense escriptura de sessions rep els enllaços i els tokens de sessió com a null. Vegeu https://docs.didit.me/console/api-keys.

Paràmetres de ruta

id
string<uuid>
requerit

L'identificador de l'enllaç.

Resposta

L'enllaç.

Una execució de Bank Link per a una persona: connectar un banc o renovar una connexió. Confirma tu mateix un enllaç amb get_link: no confiïs mai en un identificador enviat pel navegador.

id
string<uuid>
requerit

Identificador de l'enllaç.

mode
enum<string>
requerit
Opcions disponibles:
connect,
renew
access
enum<string>
requerit
Opcions disponibles:
one_time,
ongoing
status
enum<string>
requerit

Estat de l'enllaç. completed, cancelled, expired i failed són estats finals.

Opcions disponibles:
created,
opened,
connecting,
completed,
cancelled,
expired,
failed
url
string<uri> | null
requerit

La pàgina allotjada a la qual cal enviar la persona. Només es retorna en crear l'enllaç; és null en lectures posteriors, perquè el token no s'emmagatzema.

client_token
string | null
requerit

El token del Bank Link integrat de Didit, que encara no està disponible: obre url avui. Només es retorna en crear l'enllaç; null en lectures posteriors. Té un únic propòsit i és de vida curta. No conté dades personals. No el registris mai.

expires_at
string<date-time>
requerit

Quan deixa de funcionar un enllaç no utilitzat.

connection_id
string<uuid> | null
requerit

La connexió que aquest enllaç ha creat o renovat, quan status és completed.

check_id
string<uuid> | null
requerit

El resultat de titularitat d'aquest enllaç, quan s'ha sol·licitat ownership.compare amb un valor diferent de none.

reused
boolean
requerit

true quan l'enllaç s'ha completat com a renovació d'una connexió existent perquè la persona ja comparteix exactament aquests comptes (duplicates: reuse). No es cobra res dues vegades.

error
object | null
requerit

Per què ha fallat l'enllaç, quan status és failed. En cas contrari, null.

quote
object
requerit

El preu d'un enllaç, fixat en el moment de crear-lo. El preu cobrat és el de la cotització. Les lectures no es facturen mai.

vendor_data
string | null
requerit

La vostra referència de la sol·licitud.

Darrera modificació el 22 de novembre del 2026