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 enconsent_days.
Cada conexión muestra sus fechas reales en consent:
expires_atyrenew_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_grantedyaccounts_granted: lo que se concedió y cuántas veces se renovó.
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.- Didit envía
bank.connection.consent_expiring14 días, 7 días y 1 día antes del vencimiento. - Invoca
POST /v3/bank/connections/{id}/renew/. Responde409 renewal_not_neededmientras queden más de 30 días y409 renewal_window_expireddespués deconsent.renewable_until. En caso contrario, responde201con un enlace de renovación.
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 devuelveid, 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 mismoend_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/aceptastatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeycreated_after. - Consulta cuánto cuesta una conexión con su objeto
billing: la unidad, el precio y el mes ya liquidado.