BridgeConnecteurStable

List accounts (Bridge)

Liste les comptes bancaires Bridge accessibles pour un utilisateur, avec filtre d’item et pagination.

User Bridge

Lister les comptes bancaires (Bridge)

Account Bridge

Vue d’ensemble

List Bridge accounts retourne les comptes bancaires accessibles pour un utilisateur et peut limiter la recherche à une connexion bancaire précise.

Par défaut, les comptes dont data_access = disabled sont retirés de la sortie afin d’éviter de les utiliser involontairement dans les étapes suivantes.

Fournissez item pour limiter les comptes à une banque connectée.
include_disabled = false est le comportement par défaut recommandé.
Soldes et autres montants sont exposés en unités mineures de la devise du compte.

Exemple de processus

User Bridge

Lister les comptes bancaires (Bridge)

Account Bridge

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

Résolution des données

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

Donnée	Source ou règle
Utilisateur	`bridge_user.uuid`.
Banque optionnelle	`item.id` lorsque `item` est fourni.
Comptes désactivés	Exclus sauf si `include_disabled = true`.
Pagination	`limit`, `starting_after`, `has_more` et `next_uri`.
Montants	Convertis du format provider vers `common.amount` en unités mineures selon la devise du compte.

Paramètres 6

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.

itemOptionnelBridge item

Connexion bancaire Bridge (item) à consulter ou à utiliser comme filtre. Un item représente la relation d’un utilisateur avec un établissement bancaire et peut contenir plusieurs comptes.

Filtres et pagination

Paramètres qui bornent les listes et synchronisations de données bancaires.

include_disabledRequisboolean

Inclut les comptes dont data_access vaut disabled. Par défaut ils sont exclus afin que les étapes suivantes travaillent uniquement sur les comptes dont les données restent accessibles.

limitRequisinteger

Nombre maximal d’éléments demandés à Bridge pour cette page. Une valeur plus faible réduit le volume retourné ; utilisez has_more et next_uri pour savoir si d’autres résultats existent.

starting_afterOptionnelstring

Curseur de pagination Bridge permettant de continuer une liste après un élément déjà reçu. Utilisez la valeur correspondant à la page précédente plutôt qu’un index calculé localement.

Sorties 3

Données bancaires

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

accountsBridge account[]

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

Pagination

Indicateurs permettant de poursuivre une liste Bridge.

has_moreboolean

Indique qu’une page supplémentaire de résultats Bridge est disponible.

next_uriOptionnelstring

URI de pagination fournie par Bridge pour poursuivre la liste. Elle est null lorsqu’aucune page supplémentaire n’est disponible.

Comportement

Définir le périmètre

Le node travaille sur tous les comptes du bridge_user ou uniquement ceux de l’item fourni.

Lire une page

Bridge retourne une page selon limit et le curseur éventuel.

Filtrer l’accès

Les comptes désactivés sont retirés sauf demande explicite via include_disabled.

Exposer la pagination

La page finale est accompagnée de has_more et next_uri.

Limites et responsabilités

Un compte disabled peut toujours être retourné explicitement avec include_disabled = true, mais cela ne réactive pas son accès aux données.
Le node ne parcourt pas automatiquement toutes les pages.
Les IBAN et données bancaires sont sensibles même si les montants eux-mêmes utilisent le type monétaire normalisé.

Résolution des problèmes

Un compte a disparu de la liste

Vérifiez s’il a data_access = disabled. Activez temporairement include_disabled uniquement pour diagnostiquer son état.

Plus de comptes que prévu

Fournissez l’item correspondant à la banque à cibler au lieu de lister l’ensemble des comptes de l’utilisateur.

La liste est incomplète

Contrôlez has_more et utilisez le curseur de pagination pour récupérer la page suivante.

Référence

include_disabled	Comptes retournés
`false` (défaut)	Comptes dont `data_access` reste exploitable.
`true`	Inclut également les comptes marqués `disabled` par Bridge.