BridgeConnecteurStable

Create payment link (Bridge)

Crée ou réutilise un Payment Link Bridge pour un paiement PSP Ormuz existant sans piloter l’interaction utilisateur.

Paiement PSP

Créer un lien de paiement (Bridge)

Payment link Bridge

extension_object_mapping

Vue d’ensemble

Create Bridge payment link est la primitive bas niveau utilisée lorsque vous voulez piloter vous-même la diffusion ou la redirection vers Bridge.

Comme le node haut niveau, il part d’un psp_payment existant et réutilise le lien déjà associé à ce paiement lorsqu’il existe.

Le montant et la devise viennent exclusivement du psp_payment.
La sortie created distingue une création d’une réutilisation.
Le callback_url est sous votre responsabilité avec ce node bas niveau.

Scénario type

Un marchand souhaite envoyer un lien de paiement bancaire dans son propre canal de communication. Il crée d’abord le psp_payment, génère le Payment Link Bridge, puis utilise l’URL sécurisée dans son expérience personnalisée.

Prise en main

Utilisez ce node uniquement si vous avez besoin de contrôler le lien Bridge vous-même ; sinon préférez bridge.collect_payment.

À fournir

psp_payment existant
Identité du payeur
callback_url si le navigateur doit revenir vers votre propre expérience

À ne pas dupliquer

Montant
Devise
Référence principale du paiement

Exemple de configuration

Paramètre	Binding	Rôle
`psp_payment`	`payment`	Détermine montant, devise et référence
`callback_url`	`merchant_return_url`	Requis uniquement pour votre scénario de redirection

À retenir Si votre objectif est simplement de collecter le paiement dans un parcours Ormuz, utilisez bridge.collect_payment : il gère le retour et la synchronisation pour vous.

Exemple de processus

Paiement PSP

Créer un lien de paiement (Bridge)

Payment link Bridge + extension_object_mapping

Exemple simplifié d’utilisation de Créer un lien de 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`.
Devise	`psp_payment.currency`.
Référence Bridge	`psp_payment.id`.
Référence payeur	`payer_external_reference` → `psp_payment.buyer_id` → `psp_payment.id`.
Lien existant	Mapping Bridge déjà associé au même `psp_payment` ; le node le relit et retourne `created = false`.

Paramètres 14

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.

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.

callback_urlOptionnelurl

URL vers laquelle Bridge renvoie le navigateur après l’autorisation bancaire. Ce paramètre est destiné au node bas niveau de création de lien ; l’action utilisateur bridge.collect_payment gère automatiquement son propre retour.

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.

sender_ibanOptionnelstring

IBAN du compte émetteur lorsqu’il doit être imposé au parcours de paiement. Cette donnée bancaire est sensible et ne doit être renseignée que si le cas d’usage exige de pré-sélectionner le compte payeur.

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.

Sorties 3

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.

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

createdboolean

Indique si le node a créé un nouvel objet Bridge. false signifie qu’un objet déjà associé a été retrouvé et réutilisé.

Comportement

Chercher un lien existant

Le node vérifie d’abord si le paiement Ormuz est déjà associé à un Payment Link Bridge.

Relire ou créer

S’il existe, le lien est relu ; sinon Bridge reçoit une nouvelle demande construite à partir du psp_payment et des options fournies.

Tracer la correspondance

Le lien est associé au paiement Ormuz et le mapping est retourné avec created.

Limites et responsabilités

Ce node ne redirige pas l’utilisateur et n’attend pas la fin du parcours bancaire.
Il ne synchronise pas à lui seul le statut final du psp_payment ; utilisez bridge.sync_psp_payment ou le node haut niveau lorsque nécessaire.
Un paiement Ormuz déjà associé à un autre Payment Link est considéré comme incohérent plutôt que remappé silencieusement.

Résolution des problèmes

Le lien est réutilisé alors que je voulais en créer un nouveau

C’est le comportement voulu pour un même psp_payment. Créez un nouveau paiement Ormuz si vous avez réellement besoin d’une nouvelle initiation indépendante.

Bridge refuse l’identité du payeur

Fournissez une entreprise ou le couple prénom/nom ; ne laissez pas les deux modes incomplets.

Le retour navigateur ne fonctionne pas

Vérifiez que callback_url est une URL HTTP(S) valide et qu’elle correspond à l’expérience que vous contrôlez.