> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sahlfinancial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connexions bancaires

> Routes de la console, et routes de l'API Partenaire par clé pour les espaces activés par Sahl (offre Growth). La production répond 409 tant qu'aucun fournisseur de données bancaires n'est branché.

Les connexions bancaires récupèrent les données de comptes après accord du client. La console affiche chaque connexion avec son statut, ses revenus et ses dépenses. Leur fonctionnement est dans [Connexions bancaires et open banking](/fr/guides/open-banking) ; les établissements que Sahl liste sont sur [Couverture bancaire](/fr/bank-coverage). Le code n'enregistre aucun type de connecteur par banque, et aucun fournisseur de données bancaires réelles n'est branché sur l'API aujourd'hui.

<Card title="Passez à l'offre supérieure pour les connexions bancaires réelles" icon="building-columns" href="https://sahlfinancial.com/fr/use-cases" horizontal>
  Les connexions bancaires réelles font partie de l'offre Growth, activées par Sahl pour votre espace. D'ici là, le bac à sable les simule. Voir les offres et parler à l'équipe commerciale.
</Card>

## Routes de la console

Les sept routes que la console appelle sont documentées dans la [référence de l'API de la console](/fr/console-api/overview), distincte. Elles exigent une session de connexion à la console, pas une clé d'API.

| Route | Référence |
| - | - |
| `POST /v1/bank-connections` | [Create a bank connection](/fr/console-api/reference/bank-connections/create-a-bank-connection) |
| `GET /v1/bank-connections` | [List bank connections](/fr/console-api/reference/bank-connections/list-bank-connections) |
| `GET /v1/bank-connections/stats` | [Count bank connections by status](/fr/console-api/reference/bank-connections/count-bank-connections-by-status) |
| `GET /v1/bank-connections/{connection_id}` | [Get a bank connection](/fr/console-api/reference/bank-connections/get-a-bank-connection) |
| `POST /v1/bank-connections/{connection_id}/refresh` | [Refresh a bank connection](/fr/console-api/reference/bank-connections/refresh-a-bank-connection) |
| `GET /v1/bank-connections/{connection_id}/transactions` | [List the transactions](/fr/console-api/reference/bank-connections/list-the-transactions-of-a-bank-connection) |
| `GET /v1/bank-connections/{connection_id}/analysis` | [Get the cash-flow analysis](/fr/console-api/reference/bank-connections/get-the-cash-flow-analysis-of-a-bank-connection) |

## Routes de l'API Partenaire (clé d'API)

Les mêmes sept opérations existent pour un usage serveur à serveur, sous `/v1/partner/bank-connections`, avec une clé d'API au lieu d'une session de connexion. Elles figurent dans la [référence de l'API Partenaire](/fr/api-reference/introduction), sous « Bank connections (Growth) ».

* **Offre :** Growth.
* **Activées par Sahl, espace par espace.** Tant que Sahl n'a pas activé votre espace, vous ne pouvez pas émettre de clé avec les scopes `bank:read` ou `bank:write`, et un appel répond `403` avec le code `bank_scope_not_allowed`. Écrivez à [contact@sahlfinancial.com](mailto:contact@sahlfinancial.com).
* **Scopes :** `bank:read` pour la liste, les statistiques, une connexion, les transactions et l'analyse. `bank:write` pour la création et le rafraîchissement.
* **Même règle que la console :** aucun fournisseur de données bancaires n'est branché. Les données sont une simulation sandbox, et en production la création, le rafraîchissement, les transactions et l'analyse répondent `409` `bank_connect_unavailable`.
* Chaque appel est limité à votre propre espace : l'identifiant d'une connexion d'un autre espace répond `404`.

| Route | Scope |
| - | - |
| `POST /v1/partner/bank-connections` | `bank:write` |
| `GET /v1/partner/bank-connections` | `bank:read` |
| `GET /v1/partner/bank-connections/stats` | `bank:read` |
| `GET /v1/partner/bank-connections/{connection_id}` | `bank:read` |
| `POST /v1/partner/bank-connections/{connection_id}/refresh` | `bank:write` |
| `GET /v1/partner/bank-connections/{connection_id}/transactions` | `bank:read` |
| `GET /v1/partner/bank-connections/{connection_id}/analysis` | `bank:read` |

## Sandbox et production

En sandbox, une connexion simulée fournit instantanément des données fictives : aucune coordonnée bancaire réelle n'est nécessaire.

En production, l'API répond aujourd'hui `409` avec le code `bank_connect_unavailable` pour la création, le rafraîchissement, les transactions et l'analyse. La simulation ne tourne que si la requête se déclare Sandbox (`X-Sahl-Environment: sandbox`) ; une requête sans environnement est refusée aussi. La liste, les statistiques et la lecture d'une connexion ne renvoient jamais 409. Voir [Couverture](/fr/coverage) et [Couverture bancaire](/fr/bank-coverage).


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