> ## 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.

# Conexiones bancarias: acceso continuo, consentimiento y renovación

> En Didit, una conexión es el permiso de una persona para leer un banco. Consulta estados, fin del consentimiento, renovación y revocación.

Una conexión bancaria de Didit es el permiso de una persona o empresa para que tu aplicación lea los datos de un banco, con sus fechas de consentimiento, su estado de sincronización y sus cuentas.
Una [Bank Link](https://docs.didit.me/es/core-technology/bank-verification/bank-link.md) completada crea la conexión, y esta se mantiene activa mientras lo permitan el banco y la persona.

Los datos bancarios están disponibles para aplicaciones en sandbox; las llamadas de una aplicación en producción responden con `404` hasta que se anuncie el acceso en producción.

## Acceso único y continuo

| | Único | Continuo |
| - | - | - |
| `access` | `one_time` (por defecto) | `ongoing` |
| Qué ocurre | Los datos se leen una vez cuando la persona se conecta y, después, el acceso termina (`status_reason: collection_complete`). | El acceso permanece abierto hasta que termina el consentimiento o alguien lo detiene. |
| Datos posteriores | Se pueden leer mediante los mismos endpoints. | Se sincronizan automáticamente entre una y cuatro veces al día según el banco, además de sincronizaciones en tiempo real bajo demanda. |
| Facturación | Por verificación, consulta los [precios](https://docs.didit.me/es/getting-started/bank-verification-pricing.md) | Por conexión activa al mes, consulta los [precios](https://docs.didit.me/es/getting-started/bank-verification-pricing.md) |

El acceso continuo solo funciona en un banco cuando ese banco lo permite.
Consulta el [endpoint de instituciones](https://docs.didit.me/es/standalone-apis/bank-institutions-list.md) o lee la [página de cobertura](https://docs.didit.me/es/core-technology/bank-verification/coverage.md).
Cuando un banco no puede mantener el acceso abierto, se informa a la persona de que el banco no permite el acceso continuo y de que debe elegir otro banco.
Define `allow_one_time_fallback: true` para que la persona pueda continuar con una lectura única después de confirmar por su cuenta, en su propia pantalla, el acceso reducido: en ese caso, la conexión es `one_time`.

## Estados

| `status` | Significado | Datos legibles | Sincronizaciones | Facturado |
| - | - | - | - | - |
| `pending` | El enlace se completó y la primera sincronización está en curso. | Todavía no | En curso | No |
| `active` | El consentimiento es válido y la sincronización funciona correctamente o está reintentando. | Sí | Sí | Sí |
| `renewal_required` | El consentimiento terminó o el banco pide a la persona que vuelva a iniciar sesión. `status_reason` indica cuál. | Según la última sincronización | No | No |
| `paused` | El saldo no alcanza para cubrir el mes. | Según la última sincronización | No | No |
| `revoked` | La persona, el banco o tú detuvieron el acceso. `consent.ended_by` indica quién. | Hasta `consent.retain_until` | No | No |
| `deleted` | La conexión y sus datos se eliminaron. | No | No | No |
| `failed` | La primera sincronización nunca fue exitosa. | No | No | No |

`status_reason` es uno de los siguientes valores: `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` (reservado, ningún endpoint lo establece actualmente) y `first_sync_failed`.

## Consentimiento

El banco fija el fin del consentimiento, hasta el plazo que solicitaste en `consent_days`.
Cada conexión muestra sus fechas reales en `consent`:

* `expires_at` y `renew_by`: el fin del consentimiento. Renueva antes de esa fecha para no tener interrupciones.
* `renewable_until`: el último momento en que la misma conexión puede reactivarse tras terminar el consentimiento.
* `renewed_count`, `version`, `scopes_granted` y `accounts_granted`: lo que se concedió y cuántas veces se renovó.

El consentimiento dura todo el tiempo que permite el banco.
Consulta el valor real en cada conexión y el valor por banco en la institución.

## Renovación

Una renovación conserva el id de la conexión y todos los ids de cuenta, y el historial continúa sin duplicados.

1. Didit envía `bank.connection.consent_expiring` 14 días, 7 días y 1 día antes del vencimiento.
2. Invoca [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/es/standalone-apis/bank-connection-renew). Responde `409 renewal_not_needed` mientras queden más de 30 días y `409 renewal_window_expired` después de `consent.renewable_until`. En caso contrario, responde `201` con un enlace de renovación.

La página en la que la persona completa una renovación todavía no está disponible, así que hoy no envíes a las personas a un enlace de renovación.

Si la persona deja caducar el consentimiento, la conexión pasa a `renewal_required`: los datos siguen estando disponibles para lectura, tal como se sincronizaron por última vez, y no se cobra nada.
Después de `consent.renewable_until`, pasa a `revoked` con `status_reason: consent_lapsed` y la persona vuelve a conectarse.

Para ver el flujo completo, consulta [Renovar un consentimiento bancario](https://docs.didit.me/es/use-cases/renew-bank-consent.md).

## Detener el acceso

| Quién | Cómo | Qué ocurre |
| - | - | - |
| La persona | **Dejar de compartir** en su banco | `bank.connection.revoked` con `ended_by: end_user` o `bank` |
| Tú | [`revoke_connection`](https://docs.didit.me/es/standalone-apis/bank-connection-revoke) | La obtención de datos del banco se detiene de inmediato. El consentimiento muestra `revocation_pending` y, cuando el banco lo confirma, `revoked`. Los datos ya leídos siguen siendo legibles hasta que elimines la conexión o pase `consent.retain_until`. |
| Tú | [`delete_connection`](https://docs.didit.me/es/standalone-apis/bank-connection-delete) | Detiene el acceso y elimina la conexión y sus cuentas, saldos y transacciones. Es irreversible. |

Detener el acceso no es lo mismo que eliminar.
Consulta [Datos, consentimiento y eliminación](https://docs.didit.me/es/core-technology/bank-verification/data-consent-and-deletion.md) para saber exactamente qué se elimina al borrar.

## Una conexión eliminada

Una conexión eliminada solo devuelve `id`, `status` (`deleted`), `status_reason`, `created_at` y `erasure`.
`status_reason` tiene uno de estos valores: `deleted_by_customer`, `consent_lapsed`, `retention_elapsed` o `application_deleted`.
Todos los demás campos están ausentes.

## Duplicados

Un enlace nuevo que se resuelve en exactamente las cuentas que ya compartes con el mismo `end_user.reference` en el mismo banco se completa como una renovación de esa conexión (`reused: true`) y no se cobra dos veces.
Cualquier otro solapamiento hace que el enlace termine en `failed` con `duplicate_conflict` y `conflicts_with`, antes de que se guarde o se cobre nada.
Renueva la conexión existente o vuelve a crear el enlace con `"duplicates": "allow"` para obtener una segunda conexión independiente.

## Gestiona las conexiones de tus clientes

* Lista con filtros: [`GET /v3/bank/connections/`](https://docs.didit.me/es/standalone-apis/bank-connections-list) acepta `status`, `access`, `institution_id`, `country`, `vendor_data`, `end_user_reference`, `consent_expires_before` y `created_after`.
* Consulta cuánto cuesta una conexión con su objeto `billing`: la unidad, el precio y el mes ya liquidado.


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