BridgeConnecteurStable

Ensure user (Bridge)

Crée ou réutilise l’utilisateur Bridge associé à un contact Ormuz pour les fonctions d’agrégation bancaire.

Vue d’ensemble

Ensure Bridge user établit l’identité Bridge d’un contact une seule fois et la réutilise dans les opérations bancaires suivantes.

Le designer de processus travaille ainsi avec un contact Ormuz et un objet typé bridge_user, sans avoir à stocker ou rechercher lui-même un UUID Bridge.

  • Un mapping existant est réutilisé et retourne created = false.
  • En l’absence de mapping, Ormuz crée l’utilisateur Bridge puis associe son UUID au contact.
  • Le token d’autorisation bancaire n’est ni créé comme sortie ni conservé dans le processus.

Exemple de processus

Contact Ormuz
Créer ou réutiliser un utilisateur (Bridge)
User Bridge + extension_object_mapping

Exemple simplifié d’utilisation de Créer ou réutiliser un utilisateur (Bridge) dans un processus Ormuz.

Résolution des données

Le node applique les règles suivantes à partir des objets et filtres fournis.

DonnéeSource ou règle
Contact canoniquecontact.id.
Référence externe par défautcontact.id lorsque external_user_id n’est pas renseigné.
Utilisateur existantMapping Bridge user → contact pour la configuration active.
Utilisateur crééNouveau Bridge User uniquement lorsqu’aucune association n’existe.

Paramètres 3

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.
contactRequisContact
Contact Ormuz à associer durablement à un utilisateur Bridge. Ce contact représente la personne dont les connexions bancaires et données d’agrégation seront consultées.

Identité du payeur ou de l’utilisateur

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

external_user_idOptionnelstring
Référence externe optionnelle utilisée lors de la création de l’utilisateur Bridge. Si elle est absente, Ormuz utilise l’identifiant du contact, ce qui fournit une référence stable et réutilisable.

Sorties 3

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.

Session et traçabilité

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

extension_object_mappingextension object mapping
Lien de traçabilité entre l’objet Bridge principal produit par le node et l’objet Ormuz auquel il est associé.
createdboolean
Indique si le node a créé un nouvel objet Bridge. false signifie qu’un objet déjà associé a été retrouvé et réutilisé.

Comportement

Chercher le mapping

Le node vérifie si le contact possède déjà un utilisateur Bridge pour cette configuration.

Réutiliser ou créer

L’utilisateur existant est relu ; sinon un nouvel utilisateur Bridge est créé avec la référence externe choisie.

Tracer l’association

Le mapping vers le contact est retourné avec l’indicateur created.

Limites et responsabilités

  • external_user_id doit contenir uniquement lettres, chiffres, - ou _ et ne pas dépasser 128 caractères.
  • Plusieurs utilisateurs Bridge mappés au même contact sont considérés comme une ambiguïté et ne sont pas départagés automatiquement.
  • Le node ne connecte aucune banque ; il prépare uniquement l’identité Bridge nécessaire aux actions suivantes.

Résolution des problèmes

external_user_id refusé

Utilisez une référence de 1 à 128 caractères composée uniquement de lettres, chiffres, tirets et underscores.

Plusieurs utilisateurs pour le même contact

Corrigez les mappings Bridge concernés au lieu de choisir arbitrairement un utilisateur dans le processus.

Référence

ParamètreRègle
external_user_id absentUtilise contact.id.
external_user_id fourniDoit respecter [a-zA-Z0-9-_]{1,128}.