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

# Démarrage rapide Bank Data : connecter une banque test et lire les transactions

> De l'application sandbox aux comptes, soldes et transactions de la Test Bank Didit : créez une clé et un lien, connectez, lisez, synchronisez et supprimez.

Les données bancaires sont disponibles pour les applications sandbox.
Les appels d'une application en environnement de production renvoient `404` tant que l'accès en production n'a pas été annoncé, et rien n'est facturé en sandbox.
Ce démarrage rapide vous guide depuis une application sandbox jusqu'aux comptes, soldes et transactions du Didit Test Bank, à l'aide de requêtes prêtes à copier-coller.

> [!NOTE]
>
> Chaque réponse ci-dessous est réduite aux champs essentiels.
> Conservez la clé API sur votre serveur : elle n'atteint jamais un navigateur ni une application.

## Étape 1 : créer une clé API avec l'autorisation Bank data

Les données bancaires ne font pas partie de l'accès complet.
Une clé à accès complet, y compris le secret principal de l'application, est refusée sur chaque appel aux données bancaires avec `403 bank_data_access_denied`.

1. Dans le [Business Console](https://business.didit.me), ouvrez votre application sandbox et accédez à **API keys**.
2. Créez une clé avec un accès personnalisé et ajoutez **Bank data** : **Read** pour les lectures, **Write** pour les appels qui créent, modifient ou suppriment quelque chose.
3. Copiez la clé et exportez-la :

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

Consultez [Clés API](https://docs.didit.me/fr/console/api-keys.md) pour la liste complète des ressources.

## Étape 2 : créer un lien

Un lien correspond à une exécution des écrans dans lesquels une personne connecte sa banque.
Créez un lien continu pour la 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` est le pays de la banque de la personne, au format à trois lettres, et ce champ est facultatif.
Envoyez-le lorsque vous le connaissez afin que la personne ne voie que les banques de ce pays ; sans lui, elle choisit parmi tous les pays que vous pouvez desservir.
Pour un accès ponctuel, envoyez `"access": "one_time"` (valeur par défaut).

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

Conservez l'`id` du lien avec votre utilisateur.
Les champs `url` et `client_token` ne sont renvoyés qu'une seule fois, lors de la création du lien.

## Étape 3 : ouvrez le lien et connectez-vous à Didit Test Bank

Ouvrez l'`url` dans un navigateur, ou envoyez-la à la personne par e-mail ou par messagerie.
La personne voit l'écran de consentement, sélectionne **Didit Test Bank**, se connecte avec l'un des clients de test et choisit les comptes à partager.
La [page sandbox](https://docs.didit.me/fr/core-technology/bank-verification/sandbox.md) répertorie les clients de test et ce que chacun vous fournit.

Pour renvoyer la personne sur votre site ensuite, consultez [Retour vers votre site](https://docs.didit.me/fr/integration/bank-link/return-to-your-site.md).
Sans `redirect_url`, la personne termine sur la page de résultat de Didit et vous obtenez le résultat via le webhook ou en effectuant une lecture.

## Étape 4 : recevoir les webhooks et confirmer

Abonnez une destination de webhook aux événements `bank.*` dans la console, comme pour tout [webhook](https://docs.didit.me/fr/integration/webhooks.md).
Lorsque la personne termine, `bank.link.completed` est reçu avec le `link_id` et le `connection_id`, puis `bank.connection.created` une fois que la première synchronisation a enregistré les comptes.

Ne faites jamais confiance à un identifiant de lien envoyé par un navigateur.
Consultez vous-même le lien :

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

Le `status` vaut `completed` ou un statut final (`cancelled`, `expired`, `failed`). Un lien `failed` contient un `error.code` ; un lien `cancelled` affiche `error: null`.

## Étape 5 : lire les comptes, les soldes et les transactions

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

Les montants sont des chaînes décimales, négatives pour les sorties d'argent.
Une page de transactions contient `next_page_token` tant qu'il reste des données à lire.
Consultez [Comptes, soldes et transactions](https://docs.didit.me/fr/core-technology/bank-verification/accounts-balances-transactions.md).

## Étape 6 : suivre le flux des modifications

Le flux des modifications ne renvoie que ce qui a changé depuis votre dernière lecture.
Votre première lecture, sans curseur, est l'instantané complet : chaque transaction de la connexion, chacune marquée `added`, avec `reset: true`.
Une première page peut contenir `has_more: true`, un `next_page_token` et pas encore de `next_cursor`.
Continuez à lire avec `page_token` tant que `has_more` vaut `true`, puis conservez le `next_cursor` de la dernière page (celle où `has_more: false`) pour la prochaine lecture :

```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` signifie que la réponse est un instantané complet : remplacez votre copie par cette réponse au lieu d'y ajouter les données.
`bank.data.updated` vous indique qu'une synchronisation a enregistré de nouvelles données.

## Étape 7 : synchroniser maintenant

Une connexion continue se synchronise automatiquement.
Pour lire les données de la banque maintenant, demandez une synchronisation :

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

Une banque autorise un nombre limité de lectures sans intervention par jour.
Les champs `sync.live_syncs_left_today` et `sync.budgets` de la connexion indiquent combien de lectures sans intervention il reste et quand ces budgets sont réinitialisés. Un appel qui dépasse la limite reçoit la réponse `429 refresh_limit_reached`, accompagnée de l'heure de réinitialisation.
Voir [Actualiser les données bancaires à la demande](https://docs.didit.me/fr/use-cases/refresh-bank-data-on-demand.md).

## Étape 8 : arrêter l'accès et supprimer

Arrêter l'accès et supprimer sont deux appels différents.

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

Une connexion supprimée ne renvoie que les champs `id`, `status`, `status_reason`, `created_at` et `erasure`.
Voir [Données, consentement et suppression](https://docs.didit.me/fr/core-technology/bank-verification/data-consent-and-deletion.md).

## Prochaines étapes

* [Connexions](https://docs.didit.me/fr/core-technology/bank-verification/connections.md) : accès ponctuel et continu, consentement et renouvellement.
* [Webhooks bancaires](https://docs.didit.me/fr/core-technology/bank-verification/webhooks.md)
* [Tarifs](https://docs.didit.me/fr/getting-started/bank-verification-pricing.md)
* [Référence API](https://docs.didit.me/fr/standalone-apis/bank-data.md)


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