Saltar al contingut principal
Una connexió bancària de Didit és el permís d’una persona o d’una empresa perquè la teva aplicació llegeixi les dades d’un banc, amb les dates de consentiment, l’estat de sincronització i els comptes corresponents. Una Bank Link completada crea la connexió, i aquesta es manté activa durant el temps que el banc i la persona ho permetin. Les dades bancàries estan disponibles per a les aplicacions de sandbox; les crides d’una aplicació en entorn de producció responen amb 404 fins que s’anunciï l’accés a producció.

Accés puntual i continu

L’accés continu només funciona amb un banc quan aquest banc ho permet. Consulta el endpoint de les institucions o llegeix la pàgina de cobertura. Quan un banc no pot mantenir l’accés obert, s’informa la persona que el banc no permet l’accés continu i que ha de triar un altre banc. Defineix allow_one_time_fallback: true perquè la persona pugui continuar amb una lectura puntual després de confirmar l’accés reduït a la seva pròpia pantalla: en aquest cas la connexió és one_time.

Estats

status_reason és un d’aquests valors: collection_complete, consent_expired, consent_lapsed, bank_requires_sign_in, revoked_by_end_user, revoked_by_bank, revoked_by_customer, insufficient_balance, paused_by_customer (reservat, cap endpoint no l’estableix avui) i first_sync_failed.

Consentiment

El banc fixa la fi del consentiment, fins al valor de consent_days que has sol·licitat. Cada connexió mostra les dates reals a consent:
  • expires_at i renew_by: la fi del consentiment. Renova’l abans perquè no hi hagi cap interrupció.
  • renewable_until: el darrer moment en què la mateixa connexió es pot reactivar després que el consentiment hagi acabat.
  • renewed_count, version, scopes_granted i accounts_granted: el que s’ha concedit i quantes vegades s’ha renovat.
El consentiment dura tot el temps que permet el banc. Consulta el valor real de cada connexió i el valor específic per banc a la institució.

Renovació

Una renovació manté l’identificador de la connexió i tots els identificadors de compte, i l’historial continua sense duplicats.
  1. Didit envia bank.connection.consent_expiring 14, 7 i 1 dia abans del final.
  2. Crida POST /v3/bank/connections/{id}/renew/. Respon 409 renewal_not_needed mentre queden més de 30 dies i 409 renewal_window_expired després de consent.renewable_until. En cas contrari, respon 201 amb un enllaç de renovació.
La pàgina on la persona completa una renovació encara no està disponible, així que, avui, no enviïs les persones a cap enllaç de renovació. Si la persona deixa caducar el consentiment, la connexió passa a renewal_required: les dades continuen accessibles tal com estaven en l’última sincronització i no es cobra res. Després de consent.renewable_until passa a revoked amb status_reason: consent_lapsed, i la persona es torna a connectar. Per al flux complet, consulta Renova un consentiment bancari.

Aturar l’accés

Aturar l’accés no és eliminar. Llegeix Dades, consentiment i eliminació per saber exactament què s’elimina en eliminar.

Una connexió eliminada

Una connexió eliminada només retorna id, status (deleted), status_reason, created_at i erasure. status_reason és deleted_by_customer, consent_lapsed, retention_elapsed o application_deleted. La resta de camps no apareixen.

Duplicats

Un enllaç nou que apunta exactament als mateixos comptes que ja tens compartits amb el mateix end_user.reference al mateix banc es completa com una renovació d’aquesta connexió (reused: true) i no es cobra res dues vegades. Qualsevol altra coincidència fa que l’enllaç acabi com a failed amb duplicate_conflict i conflicts_with, abans que s’emmagatzemi o es cobri res. Renova la connexió existent o torna a crear l’enllaç amb "duplicates": "allow" per a una segona connexió independent.

Gestiona les connexions dels teus clients

  • Llista amb filtres: GET /v3/bank/connections/ accepta status, access, institution_id, country, vendor_data, end_user_reference, consent_expires_before i created_after.
  • Consulta el cost d’una connexió amb el seu objecte billing: la unitat, el preu i el mes ja liquidat.
Darrera modificació el 22 de novembre del 2026