BridgeAction utilisateurStable

Connect bank accounts (Bridge)

Ouvre l’expérience Bridge permettant à un utilisateur d’ajouter, renouveler ou gérer ses connexions bancaires, puis restitue l’état bancaire visible.

User Bridge

E-mail de l’utilisateur

Connecter des comptes bancaires (Bridge)

Item Bridge

Account Bridge

Vue d’ensemble

Connect Bridge bank accounts permet à un utilisateur déjà représenté par un bridge_user de gérer ses connexions bancaires dans l’expérience Bridge.

Au retour, le node relit les connexions et comptes accessibles. Les comptes dont data_access = disabled sont exclus de cette restitution initiale.

Le token d’autorisation Bridge reste temporaire et n’est jamais exposé comme sortie du processus.
La sortie peut être partielle : vérifiez items_has_more et accounts_has_more.
Le node ne garantit pas qu’un nouveau compte a été ajouté ; l’utilisateur peut uniquement gérer ou renouveler une connexion existante.

Scénario type

Pendant un onboarding, le contact principal est d’abord associé à un utilisateur Bridge avec bridge.ensure_user. Il ouvre ensuite ce node pour connecter sa banque. À son retour, le processus dispose immédiatement des premières connexions et comptes accessibles.

Prise en main

Créez ou résolvez d’abord le bridge_user, puis fournissez l’email de la personne qui va réellement interagir avec Bridge.

Séquence recommandée

bridge.ensure_user
bridge.connect_bank_accounts
bridge.list_accounts ou bridge.list_transactions si une lecture exhaustive est nécessaire

Choix UX

show_add_item_button = true pour autoriser une nouvelle banque
false pour limiter la session à la gestion des connexions existantes

Exemple de configuration

Paramètre	Binding	Rôle
`bridge_user`	`nodes.ensure_user.bridge_user`	Utilisateur Bridge du contact
`user_email`	`contact.email`	Email de la personne qui agit
`show_add_item_button`	`true`	Autorise l’ajout d’une banque

À retenir Les sorties items et accounts servent à poursuivre rapidement le parcours ; si *_has_more vaut true, utilisez ensuite les nodes de liste pour parcourir les pages restantes.

Exemple de processus

User Bridge + E-mail de l’utilisateur

Connecter des comptes bancaires (Bridge)

Item Bridge + Account Bridge

Exemple simplifié d’utilisation de Connecter des comptes bancaires (Bridge) dans un processus Ormuz.

Résolution des données

Le node résout ces données à partir de ses entrées et du contexte Bridge.

Donnée	Source ou règle
Utilisateur bancaire	`bridge_user.uuid` obtenu en général via `bridge.ensure_user`.
Email de session	`user_email` fourni au node.
URL de retour	Gérée automatiquement par l’action utilisateur.
Comptes retournés	Première page Bridge, limitée aux comptes dont `data_access` n’est pas `disabled`.
Token d’accès	Créé temporairement pour la session et les lectures, jamais exposé comme entrée ou sortie du processus.

Paramètres 8

Contexte principal

Objets et configuration qui déterminent l’opération Bridge.

extension_config_idRequisref(extension_config:bridge)

Configuration Bridge active utilisée pour cette opération. Elle détermine les identifiants API et l’environnement Bridge ; le marchand reste celui du processus en cours.

bridge_userRequisBridge user

Utilisateur Bridge représentant la personne dont les comptes bancaires doivent être connectés, consultés ou vérifiés. Obtenez-le généralement avec bridge.ensure_user plutôt qu’en construisant l’objet manuellement.

Présentation de l’action

Textes visibles par le participant avant de poursuivre vers Bridge.

titleOptionnelstring

Titre affiché au participant pour présenter l’action Bridge. Utilisez un libellé court qui décrit clairement l’action attendue, par exemple poursuivre vers sa banque ou vérifier son compte. Valeur par défaut : Manage my bank accounts.

descriptionOptionnelstring

Texte d’accompagnement affiché avec le titre de l’action Bridge. Utilisez-le pour expliquer au participant pourquoi il est redirigé vers Bridge et ce qu’il devra y faire. Valeur par défaut : Continue securely with Bridge to connect or maintain your bank accounts..

Identité du payeur ou de l’utilisateur

Informations permettant d’identifier la personne ou l’entreprise qui interagit avec Bridge.

user_emailRequisemail

Adresse email présentée à Bridge pour l’expérience de connexion bancaire ou de vérification de compte. Utilisez l’email du contact qui réalise effectivement l’action.

Expérience bancaire

Réglages de l’interface Bridge présentée à l’utilisateur.

show_add_item_buttonRequisboolean

Indique si l’utilisateur peut ajouter une nouvelle connexion bancaire dans l’interface Bridge. Désactivez cette option lorsqu’il doit uniquement gérer ou rafraîchir des connexions existantes. Valeur par défaut : true.

Reprise du processus

Réglages avancés qui contrôlent le rejeu de l’action utilisateur.

allow_replay_from_hereOptionnelboolean

Autorise un opérateur habilité à reprendre ultérieurement le processus depuis cette action utilisateur. Laissez cette option désactivée sauf si votre politique de reprise prévoit explicitement de rejouer l’interaction Bridge.

replay_boundaryOptionnelboolean

Marque cette action comme point de non-retour pour la reprise du processus. Activez cette option lorsque rejouer les étapes antérieures pourrait recréer une initiation de paiement ou répéter une connexion bancaire sensible.

Sorties 6

Données bancaires

Objets d’agrégation ou de vérification bancaire disponibles pour les étapes suivantes.

bridge_userBridge user

Utilisateur Bridge représentant le contact Ormuz pour les opérations d’agrégation bancaire et de vérification de compte.

itemsBridge item[]

Connexions bancaires Bridge visibles pour l’utilisateur après l’opération. Chaque item représente une relation avec un établissement bancaire.

accountsBridge account[]

Comptes bancaires Bridge accessibles pour l’utilisateur ou correspondant au filtre demandé. Les informations bancaires de ces objets sont classées sensibles.

Session et traçabilité

Identifiants de session, mappings et indicateurs de création.

banking_session_idOptionnelstring

Identifiant de la session Bridge utilisée pour la connexion ou la gestion des banques. L’URL hébergée et le token d’autorisation ne sont pas exposés comme sorties du processus.

Pagination

Indicateurs permettant de poursuivre une liste Bridge.

items_has_moreboolean

Indique que Bridge possède d’autres items au-delà de la page retournée par l’action de connexion bancaire.

accounts_has_moreboolean

Indique que Bridge possède d’autres comptes au-delà de la page retournée par l’action de connexion bancaire.

Comportement

Autoriser temporairement l’utilisateur

Ormuz obtient l’autorisation Bridge nécessaire à partir du bridge_user, sans exposer le token au processus.

Ouvrir la gestion bancaire

Le participant est redirigé vers Bridge pour ajouter, renouveler ou gérer ses connexions.

Revenir dans le parcours

Le retour Bridge permet de finaliser l’action sans conserver l’URL de session comme donnée métier.

Relire items et comptes

Le node retourne jusqu’aux premières pages de connexions et comptes accessibles ainsi que les indicateurs *_has_more.

Limites et responsabilités

Le retour du participant ne prouve pas qu’une nouvelle banque a été ajoutée ; utilisez les sorties pour constater l’état réellement disponible.
Les sorties initiales peuvent être paginées. Elles ne remplacent pas bridge.list_items / bridge.list_accounts pour une lecture exhaustive.
Le node ne retourne pas les transactions bancaires ; utilisez bridge.list_transactions après avoir sélectionné le périmètre voulu.
Les comptes désactivés ne figurent pas dans la sortie accounts de cette action.

Résolution des problèmes

Aucun compte après le retour

Vérifiez que l’utilisateur a effectivement connecté une banque et que les comptes concernés n’ont pas data_access = disabled.

La liste semble incomplète

Contrôlez items_has_more et accounts_has_more, puis utilisez les nodes de liste pour continuer la pagination.

La mauvaise personne voit la session

Vérifiez que bridge_user et user_email correspondent au même contact métier dans votre processus.