ormuz
Accueil/Intégrations/Bridge/Nodes/Check bank account (Bridge)
BridgeAction utilisateurStable

Check bank account (Bridge)

Fait réaliser un Account Check Bridge puis expose les informations de titulaire et de comptes retournées par le provider.

Vue d’ensemble

Bridge Account Check ouvre une interaction bancaire dédiée à la vérification de titulaire de compte pour le bridge_user fourni.

Après le retour, Ormuz lit les informations Account Check disponibles et les expose comme données sensibles. Le node ne déclare pas lui-même qu’un compte “appartient” au contact au-delà des informations effectivement retournées par Bridge.

  • La session Bridge est limitée à la capacité account_check.
  • verified_account_count compte les comptes présents dans les résultats retournés ; ce n’est pas un score de risque.
  • Aucun platform.payment ni autre objet métier n’est créé automatiquement à partir du résultat.

Scénario type

Un fournisseur renseigne ses coordonnées bancaires pendant son onboarding. Le processus résout son bridge_user, lance Account Check, puis compare les informations de titulaire retournées avec les règles métier avant d’accepter ou d’escalader le dossier.

Prise en main

Utilisez un bridge_user déjà lié au contact à vérifier et l’email de la personne qui réalise l’interaction.

Avant le contrôle

  • Configuration Bridge avec Account Check activé
  • bridge_user obtenu via bridge.ensure_user
  • Email du contact

Après le contrôle

  • Inspecter account_information
  • Appliquer vos propres règles de correspondance de nom/compte
  • Router explicitement les écarts si nécessaire
Exemple de configuration
ParamètreBindingRôle
bridge_usernodes.ensure_user.bridge_userUtilisateur Bridge associé au contact
user_emailcontact.emailPersonne qui effectue la vérification
À retenir Account Check fournit des informations vérifiées par Bridge ; la décision métier finale (accepter, refuser, demander une revue) reste à votre processus.

Exemple de processus

User Bridge + E-mail de l’utilisateur
Vérifier un compte bancaire (Bridge)
User Bridge + Account information Bridge

Exemple simplifié d’utilisation de Vérifier un compte bancaire (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éeSource ou règle
Utilisateurbridge_user.uuid.
Emailuser_email fourni au node.
Capacité Bridgeaccount_check uniquement.
RésultatsInformations de titulaire et comptes exposés par Bridge après la session.
Nombre de comptesSomme des comptes présents dans chaque entrée account_information.

Paramètres 7

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 : Verify my bank account.
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 verify bank-account ownership..

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.

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 4

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.
account_informationBridge account information[]
Résultats Account Check retournés par Bridge, avec l’identité du titulaire et les comptes vérifiés disponibles. Ces informations sont classées sensibles.
verified_account_countinteger
Nombre total de comptes présents dans les résultats Account Check retournés à la fin de l’action.

Session et traçabilité

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

account_check_session_idOptionnelstring
Identifiant de la session Bridge utilisée pour l’Account Check. Il sert à tracer l’interaction sans exposer l’URL hébergée ni le token d’autorisation.

Comportement

Préparer la session

Le node autorise temporairement le bridge_user puis crée une session Bridge dédiée à Account Check.

Faire vérifier le compte

Le participant suit l’expérience Bridge et sélectionne ou confirme son compte bancaire.

Relire les informations

Au retour, Ormuz récupère les informations de compte disponibles pour l’utilisateur.

Exposer le résultat

account_information et verified_account_count deviennent disponibles pour vos règles et étapes suivantes.

Limites et responsabilités

  • Le node ne transforme pas automatiquement le résultat en décision “match / mismatch”. Définissez explicitement vos règles de comparaison.
  • verified_account_count = 0 signifie qu’aucun compte n’est présent dans le résultat retourné ; cela ne doit pas être interprété automatiquement comme fraude ou refus.
  • La disponibilité d’Account Check dépend des capacités activées sur votre application Bridge.
  • Les informations de titulaire et IBAN sont sensibles et doivent être utilisées uniquement par les étapes qui en ont besoin.

Résolution des problèmes

Aucun résultat Account Check

Vérifiez que la session a été menée à son terme et que la capacité Account Check est activée sur la configuration Bridge utilisée.

Le nom retourné diffère du contact

Ne forcez pas une conclusion automatique : appliquez vos règles métier de normalisation, société/personne physique et revue manuelle.

Plusieurs comptes sont retournés

Utilisez account_information pour identifier le ou les comptes concernés ; verified_account_count ne choisit pas un compte à votre place.