> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Connexions bancàries: accés continu, consentiment i renovació

> Una connexió és el permís d'una persona per llegir un banc. Consulta'n els estats, com acaba el consentiment, com renovar-lo i com aturar l'accés a Didit.

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](https://docs.didit.me/ca/core-technology/bank-verification/bank-link.md) 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

| | Puntual | Continu |
| - | - | - |
| `access` | `one_time` (per defecte) | `ongoing` |
| Què passa | Les dades es llegeixen una sola vegada quan la persona es connecta, i després l'accés finalitza (`status_reason: collection_complete`). | L'accés es manté obert fins que acabi el consentiment o algú l'aturi. |
| Dades posteriors | Es poden consultar pels mateixos endpoints. | Es sincronitzen automàticament entre una i quatre vegades al dia, segons el banc, més sincronitzacions en temps real sota demanda. |
| Facturació | Per consulta, consulta [preus](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md) | Per connexió activa al mes, consulta [preus](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md) |

L'accés continu només funciona amb un banc quan aquest banc ho permet.
Consulta el [endpoint de les institucions](https://docs.didit.me/ca/standalone-apis/bank-institutions-list.md) o llegeix la [pàgina de cobertura](https://docs.didit.me/ca/core-technology/bank-verification/coverage.md).
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` | Significat | Dades llegibles | Sincronitzacions | Facturat |
| - | - | - | - | - |
| `pending` | L'enllaç s'ha completat i s'està executant la primera sincronització. | Encara no | En curs | No |
| `active` | El consentiment és vàlid i la sincronització funciona correctament o s'està reintentant. | Sí | Sí | Sí |
| `renewal_required` | El consentiment ha finalitzat, o el banc demana a la persona que torni a iniciar la sessió. `status_reason` indica quin dels dos casos és. | Segons l'última sincronització | No | No |
| `paused` | El saldo no cobreix el mes. | Segons l'última sincronització | No | No |
| `revoked` | L'accés l'ha aturat la persona, el banc o tu. `consent.ended_by` indica qui ho ha fet. | Fins a `consent.retain_until` | No | No |
| `deleted` | La connexió i les seves dades s'han eliminat. | No | No | No |
| `failed` | La primera sincronització no ha tingut èxit mai. | No | No | No |

`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/`](https://docs.didit.me/ca/standalone-apis/bank-connection-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](https://docs.didit.me/ca/use-cases/renew-bank-consent.md).

## Aturar l'accés

| Qui | Com | Què passa |
| - | - | - |
| La persona | **Deixa de compartir** al seu banc | `bank.connection.revoked` amb `ended_by: end_user` o `bank` |
| Tu | [`revoke_connection`](https://docs.didit.me/ca/standalone-apis/bank-connection-revoke) | Les consultes del banc s'aturen de seguida. El consentiment passa a `revocation_pending` i després a `revoked` quan el banc ho confirma. Les dades ja llegides continuen sent llegibles fins que elimines la connexió o passi `consent.retain_until`. |
| Tu | [`delete_connection`](https://docs.didit.me/ca/standalone-apis/bank-connection-delete) | Atura l'accés i elimina la connexió i els seus comptes, saldos i transaccions. És irreversible. |

Aturar l'accés no és eliminar.
Llegeix [Dades, consentiment i eliminació](https://docs.didit.me/ca/core-technology/bank-verification/data-consent-and-deletion.md) 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/`](https://docs.didit.me/ca/standalone-apis/bank-connections-list) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.