Connexions bancaires

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 ; les établissements que Sahl liste sont sur Couverture bancaire. 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.

Passez à l'offre supérieure pour les connexions bancaires réelles

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.

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, 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
`GET /v1/bank-connections`	List bank connections
`GET /v1/bank-connections/stats`	Count bank connections by status
`GET /v1/bank-connections/{connection_id}`	Get a bank connection
`POST /v1/bank-connections/{connection_id}/refresh`	Refresh a bank connection
`GET /v1/bank-connections/{connection_id}/transactions`	List the transactions
`GET /v1/bank-connections/{connection_id}/analysis`	Get the cash-flow analysis

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, 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.
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 et Couverture bancaire.

Démarrer