404 hasta que se anuncie el acceso en producción, y en sandbox no se cobra nada.
Este inicio rápido te lleva desde una aplicación de sandbox hasta las cuentas, los saldos y las transacciones del Didit Test Bank, con solicitudes listas para copiar y pegar.
Cada respuesta que aparece a continuación se ha acortado para mostrar solo los campos relevantes.
Guarda la clave de API en tu servidor: nunca llega a un navegador ni a una aplicación.
Paso 1: crea una clave de API con el permiso Bank data
Bank data no forma parte del acceso completo. Una clave con acceso completo, incluido el secreto principal de la aplicación, se rechaza en todas las llamadas de Bank data con403 bank_data_access_denied.
- En la Business Console, abre tu aplicación de sandbox y ve a API keys.
- Crea una clave con acceso personalizado y añade Bank data: Read para las lecturas y Write para las llamadas que crean, modifican o eliminan algo.
- Copia la clave y expórtala:
Paso 2: crear un enlace
Un enlace es un recorrido por las pantallas en las que una persona conecta su banco. Crea uno de acceso continuo para el Test Bank:country es el código de país de tres letras del banco de la persona y es opcional.
Envíalo cuando lo conozcas, para que la persona vea solo los bancos de ese país; si no lo envías, puede elegir entre todos los países que atiendes.
Para un acceso de un solo uso, envía "access": "one_time" (el valor por defecto).
id del enlace junto con tu usuario.
El url y el client_token se devuelven una sola vez, al crear el enlace.
Paso 3: abre el enlace y conecta el Didit Test Bank
Abre elurl en un navegador o envíaselo a la persona por correo electrónico o chat.
La persona ve la pantalla de consentimiento, elige Didit Test Bank, inicia sesión con uno de los clientes de prueba y elige las cuentas que quiere compartir.
La página del sandbox enumera los clientes de prueba y lo que aporta cada uno.
Para devolver a la persona a tu sitio después, consulta Volver a tu sitio.
Si no incluyes un redirect_url, la persona termina en la página de resultados de Didit y te enteras del resultado a través del webhook o de una consulta.
Paso 4: recibe los webhooks y confirma
Suscribe un destino de webhook a los eventosbank.* en la consola, como con cualquier webhook.
Cuando la persona completa el proceso, llega bank.link.completed con el link_id y el connection_id. Después llega bank.connection.created, cuando la primera sincronización haya guardado las cuentas.
No confíes nunca en un id del enlace que te envíe el navegador.
Consulta tú mismo el enlace:
status es completed o un estado final (cancelled, expired, failed). Un enlace failed trae un error.code; uno cancelled trae error: null.
Paso 5: leer cuentas, saldos y transacciones
next_page_token mientras queden más datos por leer.
Consulta Cuentas, saldos y transacciones.
Paso 6: sigue el feed de cambios
El feed de cambios devuelve solo lo que ha cambiado desde tu última lectura. Tu primera lectura, sin cursor, es la instantánea completa: cada transacción que tiene la conexión, cada una comoadded, con reset: true.
Una primera página puede incluir has_more: true con un next_page_token y todavía sin next_cursor.
Sigue leyendo con page_token mientras has_more sea true, y guarda el next_cursor de la última página (la que tiene has_more: false) para la próxima vez:
reset: true significa que la respuesta es una instantánea completa: reemplaza tu copia con ella en lugar de añadirla.
bank.data.updated te indica cuándo una sincronización almacenó algo nuevo.
Paso 7: sincronizar ahora
Una conexión en curso se sincroniza por sí sola. Para leer el banco ahora, solicita una sincronización:sync.live_syncs_left_today y sync.budgets de la conexión indican cuántas quedan y cuándo se restablecen. Una llamada que supere el límite devuelve 429 refresh_limit_reached con la hora del restablecimiento.
Consulta Actualizar los datos bancarios bajo demanda.
Paso 8: detener el acceso y eliminar
Detener el acceso y eliminar son dos llamadas a la API distintas.id, status, status_reason, created_at y erasure.
Consulta Datos, consentimiento y eliminación.
Próximos pasos
- Conexiones: acceso de un solo uso y continuo, consentimiento y renovación.
- Webhooks bancarios
- Precios
- Referencia de la API