Saltar al contenido principal
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 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

El acceso continuo solo funciona en un banco cuando ese banco lo permite. Consulta el endpoint de instituciones o lee la página de cobertura. 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_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/. 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.

Detener el acceso

Detener el acceso no es lo mismo que eliminar. Consulta Datos, consentimiento y eliminación 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/ 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.
Última modificación el 22 de noviembre de 2026