BridgeConnecteurStable

List transactions (Bridge)

Liste les transactions bancaires agrégées par Bridge pour un utilisateur ou un compte, avec filtres temporels et pagination.

User Bridge

Lister les transactions bancaires (Bridge)

Transaction Bridge

Vue d’ensemble

List Bridge transactions récupère les mouvements bancaires agrégés pour le bridge_user, avec un filtre de compte optionnel, une période métier et/ou un curseur de synchronisation.

Les transactions restent des objets extension.bridge.transaction. Le node ne les transforme pas automatiquement en paiements Ormuz, car un mouvement bancaire n’est pas nécessairement un paiement métier à rapprocher.

since sert à une lecture incrémentale des changements ; min_date / max_date bornent la date métier des transactions.
Fournissez account pour éviter de mélanger les mouvements de plusieurs comptes lorsque le traitement est compte-spécifique.
Les montants sont normalisés en unités mineures de leur devise avant d’être exposés au processus.

Exemple de processus

User Bridge

Lister les transactions bancaires (Bridge)

Transaction Bridge

Exemple simplifié d’utilisation de Lister les transactions 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`.
Compte	`account.id` si un compte est fourni ; sinon le périmètre utilisateur Bridge.
Synchronisation incrémentale	`since` : changements depuis le curseur temporel fourni.
Période métier	`min_date` et `max_date` : bornes sur les dates de transaction.
Pagination	`limit`, `starting_after`, `has_more` et `next_uri`.
Montant	Valeur Bridge convertie en `common.amount` selon `currency_code`.

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.

accountOptionnelBridge account

Compte bancaire Bridge à consulter ou à utiliser comme filtre de transactions. Utilisez un objet retourné par bridge.list_accounts ou bridge.retrieve_account.

Filtres et pagination

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

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.

sinceOptionneldatetime

Curseur temporel Bridge pour ne récupérer que les transactions modifiées depuis une synchronisation précédente. Utilisez-le pour les synchronisations incrémentales plutôt que pour définir une période métier.

min_dateOptionneldate

Date de transaction minimale incluse dans la recherche. Utilisez-la avec max_date pour limiter la période métier interrogée, indépendamment du curseur incrémental since.

max_dateOptionneldate

Date de transaction maximale incluse dans la recherche. Elle borne la période métier interrogée et peut être combinée avec min_date.

Sorties 3

Données bancaires

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

transactionsBridge transaction[]

Transactions bancaires Bridge correspondant au compte, à la période et aux paramètres de pagination demandés. Les montants sont exposés en unités mineures de leur devise.

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 la stratégie de lecture

Choisissez un compte, une période ou un curseur since selon que vous faites une analyse ponctuelle ou une synchronisation incrémentale.

Récupérer une page

Le node transmet les filtres Bridge documentés et récupère les transactions correspondantes.

Normaliser les montants

Chaque somme est convertie en unités mineures de sa devise sans arithmétique flottante exposée au processus.

Continuer si nécessaire

Utilisez has_more et next_uri pour décider de récupérer une autre page.

Limites et responsabilités

Le node ne crée pas de platform.payment et ne rapproche aucune facture automatiquement.
La description provider d’une transaction peut contenir des informations bancaires ou personnelles ; l’ensemble de la sortie est classé sensible.
Une lecture paginée doit être poursuivie explicitement si has_more = true.
since et les bornes de dates n’ont pas le même objectif : n’utilisez pas since comme substitut approximatif à min_date / max_date.

Résolution des problèmes

Transactions manquantes sur une période

Vérifiez min_date, max_date, le compte fourni et la pagination avant de conclure que Bridge ne possède pas les mouvements.

Doublons lors d’une synchronisation

Conservez vos identifiants ou curseurs de synchronisation et traitez les transactions Bridge comme des objets provider identifiables plutôt que comme de nouveaux paiements à chaque lecture.

Montant inattendu

Les valeurs Ormuz sont en unités mineures : 19400 avec EUR représente 194,00 EUR.

Référence

Filtre	Objectif
`account`	Limiter la lecture à un compte Bridge.
`since`	Récupérer les transactions créées ou modifiées depuis une synchronisation précédente.
`min_date`	Fixer la date métier minimale incluse.
`max_date`	Fixer la date métier maximale incluse.
`starting_after`	Continuer la pagination après la page précédente.