BridgeAction utilisateurStable

Collect payment (Bridge)

Collecte un paiement bancaire Bridge à partir d’un `platform.psp_payment` existant et reprend le processus selon la politique de complétion choisie.

Paiement PSP

Collecter un paiement (Bridge)

Payment link Bridge

Paiement PSP

Vue d’ensemble

Collect Bridge payment est le node haut niveau recommandé pour un paiement bancaire interactif. Il part toujours d’un platform.psp_payment déjà créé : le designer ne saisit donc ni montant ni devise dans Bridge.

Le node orchestre l’autorisation bancaire, le retour du payeur et la synchronisation du paiement Ormuz. Le processus ne reprend qu’au niveau défini par completion_policy.

PDNG signifie que l’initiation est en cours ou acceptée, pas que les fonds sont encaissés.
initiated est le choix recommandé lorsque la banque ne fournit pas systématiquement un statut final d’exécution.
Un Payment Link déjà associé au même psp_payment est réutilisé plutôt que recréé.

Scénario type

Un checkout crée un psp_payment de 1 250,00 EUR puis appelle ce node. Le payeur sélectionne sa banque et confirme le virement. Avec completion_policy = initiated, le checkout peut reprendre dès l’initiation confirmée alors que le paiement Ormuz reste pending jusqu’à un état Bridge final.

Prise en main

Préparez d’abord le paiement PSP Ormuz, puis choisissez explicitement le niveau de confirmation attendu avant de reprendre le processus.

Minimum requis

Configuration Bridge active
psp_payment de type payment avec montant et devise
Une identité payeur : entreprise ou prénom + nom

Politique recommandée

initiated pour un checkout fluide
executed uniquement si votre cas exige un résultat final et que les banques ciblées l’exposent

Exemple de configuration

Paramètre	Binding	Rôle
`psp_payment`	`nodes.create_psp_payment.psp_payment`	Source de vérité financière
`completion_policy`	`initiated`	Recommandé pour la majorité des parcours
`payer_company_name`	`buyer.legal_name`	Ou prénom + nom pour une personne physique

À retenir Ne dupliquez pas le montant ou la devise dans des variables Bridge : ils sont toujours dérivés du psp_payment fourni.

Exemple de processus

Paiement PSP

Collecter un paiement (Bridge)

Payment link Bridge + Paiement PSP

Exemple simplifié d’utilisation de Collecter un paiement (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
Montant	`psp_payment.amount` ; Ormuz le convertit au format attendu par Bridge uniquement à la frontière provider.
Devise	`psp_payment.currency`.
Référence paiement	`psp_payment.id` comme `client_reference` Bridge.
Identité du payeur	`payer_company_name` ou couple `payer_first_name` + `payer_last_name`.
Référence payeur	`payer_external_reference` → `psp_payment.buyer_id` → `psp_payment.id`.
URL de retour	Gérée automatiquement par l’action utilisateur ; aucun `callback_url` n’est demandé.
Banque	`provider_id` si une banque doit être imposée ; sinon sélection par le payeur.

Paramètres 17

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.

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 : Continue to my bank.

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 choose your bank and authorize the payment..

Identité du payeur ou de l’utilisateur

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

payer_first_nameOptionnelstring

Prénom de la personne physique qui effectue le paiement. À utiliser avec payer_last_name lorsque le payeur est une personne physique ; ces champs ne sont pas nécessaires si payer_company_name identifie une entreprise.

payer_last_nameOptionnelstring

Nom de famille de la personne physique qui effectue le paiement. À utiliser avec payer_first_name lorsque le payeur n’est pas renseigné comme entreprise.

payer_company_nameOptionnelstring

Raison sociale de l’entreprise qui effectue le paiement. Utilisez ce champ à la place du couple payer_first_name / payer_last_name lorsque le payeur est une personne morale.

payer_emailOptionnelemail

Adresse email du payeur transmise à Bridge lorsqu’elle est disponible. Elle permet d’identifier le payeur dans le parcours bancaire sans modifier le contact Ormuz.

payer_external_referenceOptionnelstring

Référence métier du payeur transmise à Bridge. Si elle est absente, Ormuz utilise psp_payment.buyer_id lorsqu’il existe, puis l’identifiant du psp_payment comme valeur de repli.

Options de paiement

Choix appliqués à l’initiation bancaire et au retour de l’expérience Bridge.

completion_policyRequisenum

Détermine à quel moment Ormuz considère l’action de paiement terminée. initiated reprend le processus dès que l’initiation bancaire est confirmée, même si le paiement reste pending ; executed attend un statut Bridge final ACSC ou RJCT. Valeur par défaut : initiated.

countryOptionnelenum

Pays utilisé pour orienter l’expérience de sélection bancaire Bridge. Renseignez-le lorsqu’un parcours doit être limité à un marché supporté (fr, es, de ou gb).

provider_idOptionnelinteger

Identifiant numérique du provider bancaire Bridge à imposer. Laissez ce champ vide pour laisser le payeur choisir sa banque dans le parcours Bridge.

labelOptionnelstring

Libellé du virement transmis à Bridge et, selon la banque, visible sur l’opération bancaire. Utilisez un libellé métier compréhensible par le payeur et le bénéficiaire.

end_to_end_idOptionnelstring

Référence end-to-end du paiement bancaire. Renseignez-la uniquement si votre système possède déjà une référence de paiement stable qui doit être propagée jusqu’à la banque.

expired_atOptionneldatetime

Date et heure après lesquelles le lien de paiement Bridge ne doit plus être utilisable. Utilisez une date ISO 8601 cohérente avec la durée de validité du checkout ou de l’échéance métier.

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 7

Paiement

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

payment_linkBridge payment link

Lien de paiement Bridge courant, avec son identifiant, ses statuts et ses informations de paiement. Son URL hébergée est classée secrète lorsqu’elle est présente.

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

completion_policyenum

Politique effectivement appliquée par l’action de paiement : initiated ou executed.

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

payment_link_mappingOptionnelextension object mapping

Lien de traçabilité entre le Payment Link Bridge et le psp_payment Ormuz. Cette sortie est présente lorsqu’un mapping du lien est disponible.

Comportement

Valider le paiement

Vérifie que le psp_payment est exploitable et que les données payeur permettent de créer l’initiation Bridge.

Créer ou réutiliser le Payment Link

Réutilise le lien déjà associé au paiement Ormuz ou en crée un nouveau avec les références et options fournies.

Faire autoriser le paiement

Le participant est redirigé vers Bridge puis revient dans le parcours sans que l’URL provider devienne une donnée durable du processus.

Appliquer la politique de complétion

initiated accepte une initiation suffisamment avancée ; executed attend ACSC ou RJCT.

Synchroniser le PSP payment

Le statut Bridge courant est appliqué au paiement Ormuz avant que les sorties finales soient rendues disponibles.

Limites et responsabilités

Le node couvre un paiement unitaire : un psp_payment Ormuz correspond à une initiation Bridge, pas à un bulk payment.
PDNG n’est jamais transformé en succeeded ; le paiement Ormuz reste pending tant que Bridge ne remonte pas ACSC.
Avec executed, certaines banques peuvent ne pas exposer de statut final d’exécution. Dans ce cas le node demande d’utiliser initiated plutôt que d’inventer un succès.
Le node ne rapproche pas le paiement avec une facture ou une créance ; utilisez ensuite les nodes de rapprochement Ormuz appropriés.

Résolution des problèmes

Identité payeur incomplète

Renseignez soit payer_company_name, soit les deux champs payer_first_name et payer_last_name.

Le paiement reste pending

Vérifiez le statut Bridge. PDNG est volontairement conservé comme pending dans Ormuz jusqu’à un résultat final.

La politique executed ne termine pas

La banque peut ne pas fournir de statut final. Passez à initiated si votre processus n’a pas besoin d’attendre l’exécution bancaire.

La banque attendue n’apparaît pas

Vérifiez country et, si vous imposez une banque, que provider_id correspond à un provider Bridge compatible avec le parcours de paiement.

Référence

Statut Bridge	Statut PSP Ormuz	Sens
`CREA`	`pending`	Initiation créée.
`ACTC`	`pending`	Initiation acceptée techniquement.
`PDNG`	`pending`	Paiement initié/en cours ; exécution non confirmée.
`ACSC`	`succeeded`	Exécution confirmée par Bridge.
`RJCT`	`failed`	Paiement rejeté.

completion_policy	Quand le node peut terminer	Usage conseillé
`initiated`	Après confirmation de l’initiation (`PDNG`, `ACSC`, `RJCT` ou lien terminé).	Checkout et parcours où l’exécution finale peut arriver plus tard.
`executed`	Uniquement sur `ACSC` ou `RJCT`.	Processus qui exigent un résultat bancaire terminal avant de continuer.