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

# Inici ràpid de dades bancàries: connectar un banc de prova i llegir transaccions

> De l'aplicació de sandbox als comptes, saldos i transaccions del Test Bank de Didit: crea una clau i un enllaç, connecta, llegeix, sincronitza i elimina.

Les dades bancàries estan disponibles per a les aplicacions de sandbox.
Les crides d'una aplicació en producció retornen `404` fins que s'anunciï l'accés en producció, i a la sandbox no es cobra res.
Aquesta guia ràpida et porta des d'una aplicació de sandbox fins als comptes, els saldos i les transaccions del Didit Test Bank, amb sol·licituds per copiar i enganxar.

> [!NOTE]
>
> Cada resposta següent s'ha reduït als camps rellevants.
> Guarda la clau d'API al servidor: mai arriba a un navegador ni a una aplicació.

## Pas 1: crea una clau d'API amb el permís Bank data

Bank data no forma part de l'accés complet.
Una clau amb accés complet, inclòs el secret principal de l'aplicació, és rebutjada en totes les crides de Bank data amb `403 bank_data_access_denied`.

1. A la [Business Console](https://business.didit.me), obre la teva aplicació de sandbox i ves a **API keys**.
2. Crea una clau amb accés personalitzat i afegeix **Bank data**: **Read** per a les lectures, **Write** per a les crides que creen, modifiquen o eliminen alguna cosa.
3. Copia la clau i exporta-la:

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

Consulta [API keys](https://docs.didit.me/ca/console/api-keys.md) per a la llista completa de recursos.

## Pas 2: crea un enllaç

Un enllaç és un recorregut per les pantalles en què una persona connecta un banc.
Crea'n un de continu per al 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` és el codi de tres lletres del país del banc de la persona i és opcional.
Envia'l quan el coneguis, perquè la persona només vegi els bancs d'aquest país; si no l'envies, pot triar entre tots els països que pots atendre.
Per a un accés d'un sol ús, envia `"access": "one_time"` (el valor per defecte).

```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 l'`id` de l'enllaç amb el teu usuari.
La `url` i el `client_token` es retornen una sola vegada, quan es crea l'enllaç.

## Pas 3: obre l'enllaç i connecta el Didit Test Bank

Obre el `url` en un navegador o envia'l a la persona per correu electrònic o per xat.
La persona veu la pantalla de consentiment, tria **Didit Test Bank**, inicia sessió amb un dels clients de prova i tria els comptes que vol compartir.
La [pàgina de sandbox](https://docs.didit.me/ca/core-technology/bank-verification/sandbox.md) enumera els clients de prova i què et proporciona cadascun.

Per fer tornar la persona al teu lloc web després, consulta [Tornar al teu lloc](https://docs.didit.me/ca/integration/bank-link/return-to-your-site.md).
Sense un `redirect_url`, la persona acaba a la pàgina de resultats de Didit i tu coneixes el resultat pel webhook o mitjançant una consulta.

## Pas 4: rebre els webhooks i confirmar

Subscriu una destinació del webhook als esdeveniments `bank.*` a la consola, igual que per a qualsevol [webhook](https://docs.didit.me/ca/integration/webhooks.md).
Quan la persona acaba, arriba `bank.link.completed` amb el `link_id` i el `connection_id`, i després `bank.connection.created` quan la primera sincronització hagi desat els comptes.

No confiïs mai en un identificador d'enllaç que t'envii el navegador.
Consulta tu mateix l'enllaç:

```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" }
```

L'`status` és `completed` o un estat final (`cancelled`, `expired`, `failed`). Un enllaç `failed` inclou un `error.code`; un de `cancelled` mostra `error: null`.

## Pas 5: llegeix comptes, saldos i transaccions

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

Els imports són cadenes decimals i són negatius quan representen sortides de diners.
Una pàgina de transaccions inclou `next_page_token` mentre encara hi hagi més dades per llegir.
Consulta [Comptes, saldos i transaccions](https://docs.didit.me/ca/core-technology/bank-verification/accounts-balances-transactions.md).

## Pas 6: segueix el canal de canvis

El canal de canvis retorna només el que ha canviat des de la teva última lectura.
La primera lectura, sense cursor, és la instantània completa: totes les transaccions que té la connexió, cadascuna com a `added`, amb `reset: true`.
Una primera pàgina pot portar `has_more: true` amb un `next_page_token` i encara sense `next_cursor`.
Continua llegint amb `page_token` mentre `has_more` sigui `true`, i guarda el `next_cursor` de l'última pàgina (la que té `has_more: false`) per a la pròxima vegada:

```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` vol dir que la resposta és una instantània completa: substitueix la teva còpia per aquesta en lloc d'afegir-hi dades.
`bank.data.updated` t'indica quan una sincronització ha desat alguna cosa nova.

## Pas 7: sincronitza ara

Una connexió contínua es sincronitza sola.
Per llegir les dades del banc ara mateix, demana una sincronització:

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

Un banc permet un nombre limitat de lectures sense intervenció de l'usuari al dia.
`sync.live_syncs_left_today` i `sync.budgets` de la connexió indiquen quantes en queden i quan es reinicien, i una crida que superi el límit respon `429 refresh_limit_reached` amb l'hora del reinici.
Consulta [Actualitza les dades del banc sota demanda](https://docs.didit.me/ca/use-cases/refresh-bank-data-on-demand.md).

## Pas 8: atura l'accés i suprimeix

Aturar l'accés i suprimir són dues crides diferents.

```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 connexió suprimida només respon amb els camps `id`, `status`, `status_reason`, `created_at` i `erasure`.
Consulta [Dades, consentiment i supressió](https://docs.didit.me/ca/core-technology/bank-verification/data-consent-and-deletion.md).

## Següents passos

* [Connexions](https://docs.didit.me/ca/core-technology/bank-verification/connections.md): accés puntual i continu, consentiment i renovació.
* [Webhooks bancaris](https://docs.didit.me/ca/core-technology/bank-verification/webhooks.md)
* [Preus](https://docs.didit.me/ca/getting-started/bank-verification-pricing.md)
* [Referència de l'API](https://docs.didit.me/ca/standalone-apis/bank-data.md)


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