MonduAction utilisateur avec décisionStable

Create hosted order (Mondu)

Crée ou réutilise un ordre Mondu à partir d’une commande Ormuz, ouvre le checkout hébergé et dirige le processus selon le résultat du parcours acheteur.

Session de checkout

Commande Ormuz

Authorized

Declined

Canceled

Expired

Ordre Mondu

Vue d’ensemble

Create hosted order (Mondu) est le point d’entrée du financement Mondu dans un checkout e-commerce. La checkout_session porte l’expérience utilisateur et l’URL de retour ; le platform.order porte le montant, la devise, les lignes, l’acheteur et l’identité durable du financement.

Le processus reste suspendu pendant que l’acheteur se trouve sur la page Mondu. À la fin du parcours, le node reprend sur authorized, declined, canceled ou expired selon le résultat Mondu.

order.id est toujours utilisé comme référence externe canonique.
La checkout session et l’order doivent concerner le même marchand, le même buyer et le même contact.
Une nouvelle exécution sur le même order réutilise l’ordre Mondu existant au lieu d’en créer un second.
Une autorisation réussie ne confirme pas encore la commande marchande et ne déclenche pas le payout.

Scénario type

Un acheteur commande 1 000 EUR avec paiement à 30 jours. Ormuz crée un order draft lié à la checkout session, puis ce node ouvre le parcours Mondu. Après autorisation, la route authorized reprend le checkout. Le CMS confirme ensuite la commande et un processus séparé appelle Confirm order (Mondu).

Prise en main

Préparez une checkout session liée à un order enregistré et suffisamment complet pour être envoyé à Mondu.

Objets requis

checkout_session.url valide
order.checkout_session_id = checkout_session.id
Buyer et contact référencés par l’order
Au moins une ligne de commande

Données commerciales

Montant total positif en unités mineures
Devise ISO
Adresses de facturation et livraison complètes
Prénom, nom et email du contact acheteur

Exemple de configuration

Paramètre	Binding	Rôle
`checkout_session`	`checkout_session`	Contexte du parcours hébergé
`order`	`draft_order`	Commande portée par le financement
`payment_method`	`invoice`	Paiement sur facture
`net_term`	`30`	Délai acheteur
`language`	`fr`	Langue du parcours

À retenir Ne créez pas un deuxième order à la confirmation ERP. Le draft utilisé ici doit être enrichi et confirmé comme le même objet Ormuz.

Routes de décision

authorized

Acheteur autorisé

Le parcours hébergé est terminé et Mondu a autorisé la transaction.

Action recommandéeCréer ou confirmer la commande définitive puis appeler Confirm order (Mondu).

declined

Demande refusée

Mondu a refusé l’autorisation après le parcours acheteur.

Action recommandéeAfficher une alternative de paiement ou arrêter la commande selon votre politique.

canceled

Parcours annulé

L’acheteur a annulé le parcours ou l’ordre a été annulé avant autorisation.

Action recommandéeRamener l’acheteur au choix du moyen de paiement ou permettre une nouvelle tentative contrôlée.

expired

Autorisation expirée

La fenêtre d’autorisation Mondu a expiré sans décision positive exploitable.

Action recommandéeCréer un nouveau parcours si l’acheteur souhaite réessayer et si la commande est toujours valide.

Attention Traitez chaque route comme un résultat métier distinct : seule authorized permet de poursuivre vers la confirmation de commande.

Exemple de processus

Checkout B2B

Créer une commande avec parcours d’achat hébergé (Mondu)

Authorized

Declined

Canceled

Expired

Créer la commande

Autre paiement

Retour au checkout

Nouvelle tentative

Créer l’ordre Mondu depuis le draft order, attendre l’acheteur, puis traiter la route correspondant au résultat du parcours.

Résolution des données

Le node déduit automatiquement les données nécessaires à partir des objets Ormuz reliés.

Donnée	Source ou règle
URL de retour	`checkout_session.url`
Référence Mondu	`order.id` uniquement
Montant et devise	`order.amount_including_tax` et `order.currency`
Buyer	`order.buyer_id` → company ; `order.buyer_contact_id` → contact
Adresses	Détails de l’order → adresse enregistrée de la company → facturation pour la livraison
Lignes	Lignes enregistrées du `platform.order`
Moyen de paiement	Paramètre → configuration → `invoice`
Délai net	Paramètre → configuration → `30`
Langue	Paramètre → configuration → `en`

Paramètres 12

Contexte principal

Objets et configuration qui déterminent l’opération Mondu.

extension_config_idRequisref(extension_config:mondu)

Configuration Mondu active utilisée pour l’opération. Elle définit notamment l’environnement, le moyen de paiement par défaut, le délai net, la langue et les options marketplace éventuelles.

checkout_sessionRequisCheckout session

Session de checkout Ormuz liée à la commande. Elle fournit l’URL de retour du parcours hébergé et doit concerner le même order, le même marchand, le même buyer et le même contact.

orderRequisOrder

Commande Ormuz enregistrée qui porte tout le cycle Mondu. Son identifiant order.id est utilisé comme external_reference_id puis comme external_order_id.

Conditions commerciales

Choix de paiement, délai et paramètres du parcours.

payment_methodOptionnelenum

Moyen de paiement demandé à Mondu. Si vous ne le renseignez pas, le node utilise la valeur par défaut de la configuration, puis invoice.

Valeur	Usage
`invoice`	Paiement différé sur facture
`installment_by_invoice`	Échelonnement par factures
`direct_debit`	Prélèvement
`installments`	Paiement en plusieurs fois
`billing_statement`	Relevé de facturation

net_termOptionnelinteger

Délai de paiement accordé à l’acheteur, en jours. S’il est absent, le node utilise le délai par défaut de la configuration, puis 30 jours.

languageOptionnelenum

Langue du parcours ou de la communication Mondu. S’il est absent, le node utilise la langue par défaut de la configuration, puis en.

vendor_external_reference_idOptionnelstring

Référence vendeur réservée au mode marketplace. Elle n’est acceptée que si marketplace_mode est activé sur la configuration Mondu.

notesOptionnelstring

Notes métier optionnelles transmises à Mondu avec l’ordre.

Reprise du processus

Réglages avancés qui encadrent 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 la valeur désactivée sauf si votre politique de reprise prévoit explicitement une nouvelle autorisation Mondu.

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 commande, modifier ses conditions ou dupliquer une interaction acheteur.

Autres paramètres

titleOptionnelstring

Titre affiché dans l’expérience hébergée pendant le checkout Mondu afin d’expliquer clairement l’action attendue de l’acheteur.

descriptionOptionnelstring

Texte d’accompagnement affiché sous le titre pendant le checkout Mondu. Utilisez-le pour donner le contexte métier sans répéter les informations déjà présentes dans la page provider.

Sorties 6

Objet Mondu

Objet Mondu principal produit ou actualisé par le node.

orderMondu order

Ordre Mondu avec son identifiant, son état, ses montants, sa devise, ses références externes et ses dates.

Décision et contrôle

Informations utilisées pour orienter la suite du processus.

hosted_checkout_urlurl

URL du parcours hébergé Mondu utilisée pour rediriger l’acheteur.

createdboolean

Indique si le node a créé un nouvel objet Mondu. false signifie que l’objet existait déjà et a été réutilisé.

selected_routeenum

Route choisie à partir du résultat métier retourné par Mondu.

selected_valuestring

Valeur Mondu ayant conduit au routage. Elle peut être plus précise que la route, par exemple un état avancé regroupé sous authorized ou confirmed.

Autres sorties

extension_object_mappingextension object mapping

Correspondance durable entre l’objet Mondu créé ou réutilisé et l’objet Ormuz qui constitue son ancre métier.

Comportement

Vérifier la cohérence du checkout

La session et la commande doivent concerner le même marchand, le même buyer et le même contact.

Préparer les données de la commande

Le node utilise l’acheteur, le contact, les adresses, les montants et les lignes portés par l’order.

Créer ou réutiliser l’ordre Mondu

Le même order.id correspond toujours au même ordre Mondu pour cette configuration.

Ouvrir le parcours Mondu

L’acheteur est envoyé vers la page hébergée Mondu et le processus attend son résultat.

Diriger la suite du parcours

Les résultats terminaux sélectionnent une route ; un traitement Mondu encore en cours laisse le processus en attente.

Limites et responsabilités

Le node ne confirme pas la commande marchande : utilisez Confirm order (Mondu) après création définitive dans le CMS ou l’ERP.
Il ne soumet aucune facture et ne déclenche pas directement le payout.
Fermer l’onglet avant la fin du parcours laisse l’action utilisateur en attente.
Une modification du montant après autorisation sera détectée lors de la confirmation.

Résolution des problèmes

Checkout et order incohérents

Vérifiez order.checkout_session_id, le marchand, le buyer et le buyer contact sur les deux objets.

Informations buyer incomplètes

Complétez raison sociale, immatriculation, pays, prénom, nom et email avant le checkout.

Adresse ou lignes manquantes

L’order doit disposer d’une adresse complète et d’au moins une ligne enregistrée.

Le parcours reste en attente

Mondu n’a pas encore rendu de résultat terminal. Attendez la fin du traitement ou prévoyez un suivi de l’état de la commande.

URL hébergée absente

Vérifiez le mode Hosted Checkout et la configuration Mondu utilisée.