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 deconsent_days que has sol·licitat.
Cada connexió mostra les dates reals a consent:
expires_atirenew_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_grantediaccounts_granted: el que s’ha concedit i quantes vegades s’ha renovat.
Renovació
Una renovació manté l’identificador de la connexió i tots els identificadors de compte, i l’historial continua sense duplicats.- Didit envia
bank.connection.consent_expiring14, 7 i 1 dia abans del final. - Crida
POST /v3/bank/connections/{id}/renew/. Respon409 renewal_not_neededmentre queden més de 30 dies i409 renewal_window_expireddesprés deconsent.renewable_until. En cas contrari, respon201amb un enllaç de renovació.
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 retornaid, 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 mateixend_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/acceptastatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeicreated_after. - Consulta el cost d’una connexió amb el seu objecte
billing: la unitat, el preu i el mes ja liquidat.