BridgeConnecteurStable

Sync PSP payment (Bridge)

Synchronise explicitement l’état d’une transaction de paiement Bridge vers le `platform.psp_payment` Ormuz correspondant.

Paiement PSP

Payment transaction Bridge

Synchroniser un paiement PSP (Bridge)

Payment transaction Bridge

Paiement PSP

Vue d’ensemble

Sync Bridge PSP payment est le point explicite où un état de transaction Bridge devient un changement de statut du platform.psp_payment Ormuz.

Le node relit le paiement Ormuz actuel avant la mise à jour afin d’éviter qu’un événement plus ancien ne fasse régresser un paiement déjà terminal.

Montant et devise Bridge doivent correspondre au paiement Ormuz lorsqu’ils sont présents.
CREA, ACTC et PDNG restent pending ; seul ACSC devient succeeded et RJCT devient failed.
Une transition terminale contradictoire est refusée plutôt qu’écrasée.

Scénario type

Un processus déclenché par extension.bridge.payment_transaction_terminal reçoit la transaction Bridge et le psp_payment associé. Ce node applique le résultat final sur le paiement Ormuz, puis le processus peut lancer le rapprochement métier.

Prise en main

Fournissez toujours le psp_payment concerné et la transaction Bridge corrélée au même paiement.

Entrées attendues

psp_payment existant
payment_transaction Bridge correspondante

Après synchronisation

Utiliser le psp_payment retourné
Déclencher le rapprochement uniquement si votre logique métier le permet

Exemple de configuration

Paramètre	Binding	Rôle
`psp_payment`	`event.psp_payment`	Paiement Ormuz corrélé
`payment_transaction`	`event.payment_transaction`	Transaction Bridge terminale ou relue

À retenir Ne mappez jamais PDNG vers un succès dans une décision parallèle : ce node conserve volontairement cet état en pending.

Exemple de processus

Paiement PSP + Payment transaction Bridge

Synchroniser un paiement PSP (Bridge)

Payment transaction Bridge + Paiement PSP

Exemple simplifié d’utilisation de Synchroniser un paiement PSP (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
Paiement courant	Relu à partir de `psp_payment.id` avant toute mutation.
Statut cible	`ACSC` → `succeeded`, `RJCT` → `failed`, autres états → `pending`.
Montant reçu	Le montant total du `psp_payment` uniquement lorsque le statut devient `succeeded`; sinon la valeur déjà enregistrée est conservée.
Traçabilité	Identifiants Bridge de transaction, Payment Request et Payment Link disponibles dans les métadonnées du paiement lorsqu’ils existent.

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.

psp_paymentRequisPSP payment

Paiement PSP Ormuz déjà créé et appartenant au processus. Pour les nodes de paiement Bridge, son montant et sa devise sont la source de vérité : ils ne sont pas redemandés dans des paramètres séparés.

payment_transactionRequisBridge payment transaction

Transaction de paiement Bridge à consulter ou à synchroniser. Pour la synchronisation Ormuz, elle doit correspondre au même paiement que le psp_payment fourni.

Sorties 4

Paiement

Objets et état résultant du cycle de paiement.

payment_requestOptionnelBridge payment request

Payment Request Bridge associé au paiement, avec son état et les transactions connues. Il peut être absent tant que Bridge n’a pas encore créé la requête correspondante.

payment_transactionBridge payment transaction

Transaction Bridge représentant l’initiation bancaire et son état d’exécution (CREA, ACTC, PDNG, ACSC ou RJCT).

psp_paymentPSP payment

Paiement PSP Ormuz après synchronisation avec l’état Bridge. Son montant et sa devise restent ceux du paiement Ormuz initial.

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é.

Comportement

Relire le PSP payment

Le node travaille sur l’état Ormuz actuel et non sur un snapshot potentiellement ancien du processus.

Valider la transaction

Contrôle la cohérence du montant et de la devise lorsque Bridge les fournit.

Protéger les états terminaux

Un état terminal existant n’est pas régressé vers pending; une contradiction terminale est refusée.

Mettre à jour et tracer

Applique le statut autorisé puis retourne le paiement actualisé et le mapping de transaction.

Limites et responsabilités

Le node ne crée pas de psp_payment : celui-ci doit déjà exister.
Il ne rapproche pas automatiquement le paiement avec une facture, une commande ou une créance.
Le statut Bridge PART, utilisé dans certains contextes provider, n’est pas assimilé à partially_funded dans le modèle Ormuz de ce flux.
Une contradiction entre deux statuts terminaux est considérée comme une erreur à investiguer.

Résolution des problèmes

Montant ou devise incohérent

Vérifiez que la transaction Bridge provient bien de l’initiation créée pour ce psp_payment et que vous n’avez pas mélangé deux paiements.

Le statut reste succeeded malgré un PDNG tardif

C’est volontaire : un événement moins avancé ne peut pas faire régresser un paiement terminal.

Transition terminale refusée

Un paiement déjà succeeded ne peut pas devenir failed (ou inversement) sans investigation explicite du conflit provider.

Référence

Statut Bridge	Statut PSP Ormuz
`CREA`	`pending`
`ACTC`	`pending`
`PDNG`	`pending`
`ACSC`	`succeeded`
`RJCT`	`failed`