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

# Inicio rápido de datos bancarios: conecta un banco de prueba y lee transacciones

> Desde una aplicación sandbox hasta cuentas, saldos y transacciones del Test Bank de Didit: crea una clave y un enlace, conecta, lee, sincroniza y elimina.

Los datos bancarios están disponibles para las aplicaciones de sandbox.
Las llamadas de una aplicación en producción devuelven `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.

> [!NOTE]
>
> 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 con `403 bank_data_access_denied`.

1. En la [Business Console](https://business.didit.me), abre tu aplicación de sandbox y ve a **API keys**.
2. 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.
3. Copia la clave y expórtala:

```bash theme={null}
export DIDIT_API_KEY="your-sandbox-key"
```

Consulta [API keys](https://docs.didit.me/es/console/api-keys.md) para ver la lista completa de recursos.

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

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "history_days": 90,
    "vendor_data": "client-7731"
  }'
```

`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).

```json theme={null}
{
  "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
  "mode": "connect",
  "access": "ongoing",
  "status": "created",
  "url": "https://verify.didit.me/bank/link/...",
  "expires_at": "2026-11-22T13:00:00Z",
  "connection_id": null
}
```

Guarda el `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 el `url` 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](https://docs.didit.me/es/core-technology/bank-verification/sandbox.md) 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](https://docs.didit.me/es/integration/bank-link/return-to-your-site.md).
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 eventos `bank.*` en la consola, como con cualquier [webhook](https://docs.didit.me/es/integration/webhooks.md).
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:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

```json theme={null}
{ "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40", "status": "completed", "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6" }
```

El `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

```bash theme={null}
curl https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/accounts/ -H "x-api-key: $DIDIT_API_KEY"
curl https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/balances/ -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/transactions/?date_from=2026-01-01" -H "x-api-key: $DIDIT_API_KEY"
```

Los importes son cadenas decimales, negativas para las salidas de dinero.
Una página de transacciones incluye `next_page_token` mientras queden más datos por leer.
Consulta [Cuentas, saldos y transacciones](https://docs.didit.me/es/core-technology/bank-verification/accounts-balances-transactions.md).

## 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 como `added`, 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:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?page_token=$NEXT_PAGE_TOKEN" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?cursor=$NEXT_CURSOR" -H "x-api-key: $DIDIT_API_KEY"
```

`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:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ -H "x-api-key: $DIDIT_API_KEY"
```

Un banco permite un número limitado de lecturas desatendidas al día.
`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](https://docs.didit.me/es/use-cases/refresh-bank-data-on-demand.md).

## Paso 8: detener el acceso y eliminar

Detener el acceso y eliminar son dos llamadas a la API distintas.

```bash theme={null}
# Stop access at the bank. The connection keeps its data until you delete it.
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/revoke/ -H "x-api-key: $DIDIT_API_KEY"

# Delete the connection and its data. Irreversible.
curl -X DELETE https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

Una conexión eliminada responde únicamente con su `id`, `status`, `status_reason`, `created_at` y `erasure`.
Consulta [Datos, consentimiento y eliminación](https://docs.didit.me/es/core-technology/bank-verification/data-consent-and-deletion.md).

## Próximos pasos

* [Conexiones](https://docs.didit.me/es/core-technology/bank-verification/connections.md): acceso de un solo uso y continuo, consentimiento y renovación.
* [Webhooks bancarios](https://docs.didit.me/es/core-technology/bank-verification/webhooks.md)
* [Precios](https://docs.didit.me/es/getting-started/bank-verification-pricing.md)
* [Referencia de la API](https://docs.didit.me/es/standalone-apis/bank-data.md)


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