Créer et gérer les Orchestrations
Qu'est-ce qu'une orchestration ?
Une orchestration est un flux de routage qui décide quel processeur traite chaque paiement. Vous pouvez définir différentes routes selon les variables de paiement, client ou carte, et ajouter des processeurs alternatifs en cas d'échec du principal.
Avant de créer une orchestration
- Vous pouvez uniquement orchestrer des processeurs de carte.
- Les processeurs doivent être ajoutés et actifs dans Connexions.
- Le processeur ne peut pas être en mode redirection.
La liste des Orchestrations
Allez à la section Orchestrations dans le menu latéral gauche. Vous verrez deux onglets : Actifs et Désactivées.
Vous pouvez filtrer par type de déclencheur avec le menu déroulant Tous les triggers.
Les colonnes de la vue liste sont : ORCHESTRATION, TRIGGER, CONNEXIONS, UTILISATION.
Comment créer une orchestration ?
- Allez à Orchestrations et cliquez sur « Créer une orchestration ».
- L'éditeur de canevas s'ouvre. Saisissez le nom de l'orchestration dans le champ en haut.
- Choisissez le déclencheur de cette orchestration.
- Construisez le flux en ajoutant des blocs depuis le canevas.
- Une fois terminé, cliquez sur Publier pour que les modifications prennent effet.
⚠️ Lors de la publication, les modifications prennent effet immédiatement pour tous les Checkouts utilisant cette orchestration.
Le canevas : comment ça fonctionne
L'éditeur d'orchestration est un canevas visuel. Vous pouvez naviguer en glissant et zoomer avec le défilement du trackpad.
Dans l'en-tête de l'éditeur vous trouverez :
- Toggle d'activation de l'orchestration.
- Date et heure de dernière mise à jour (Actualisé : [date]).
- Nom de l'orchestration (modifiable).
- Compteur d'utilisation : combien de Checkouts utilisent cette orchestration.
- Boutons Annuler (↶) et Rétablir (↷).
- Bouton Publier.
Déclencheurs
Lors de la création d'une orchestration, vous choisissez d'abord le déclencheur :
- Premier paiement : paiements initiés par l'utilisateur au checkout.
- Paiement récurrent : prélèvements récurrents d'abonnements.
- Paiement physique : paiements effectués à un terminal physique (POS).
Blocs
Il existe deux types : les blocs utilitaires (organisent le flux) et les blocs d'action (exécutent quelque chose sur le paiement).
Blocs utilitaires :
- Route : divise le flux en branches selon des conditions.
- Diviser le trafic : distribue le trafic entre branches selon des pourcentages configurables.
Blocs d'action :
- Compléter le paiement : envoie le paiement à un processeur.
- Exécuter 3DS : lance l'authentification 3D Secure indépendamment du processeur.
- Créer Network Token : tokenise la carte avec le schéma réseau avant traitement.
Le bloc Route
Le bloc Route fonctionne comme un switch/case : chaque Condition ajoutée est une branche de sortie indépendante avec son propre flux. Il existe toujours une branche par défaut « Tous les autres » qui s'exécute quand aucune condition n'est remplie.
Le bouton « + Ajouter une condition » permet d'ajouter plusieurs conditions. Toutes les variables d'une même condition doivent être remplies (logique ET).
Variables disponibles dans une Condition de Route (33 au total)
Opération (12) : Prix, Devise, Type, Langue, Autoriser uniquement, MOTO, Approbation partielle, POS, Terminal POS, Score de fraude, Autorisations récurrentes, Abonnements récurrents.
Client (9) : Variable personnalisée, Type d'appareil, Système d'exploitation, Navigateur, Pays IP, Région IP, Pays, Région, E-mail.
Carte (12) : Marque, Type, Niveau, Pays d'émission, Banque émettrice, Portefeuille utilisé, BIN, Network Token, Tentative Network Token, Titulaire, Mois d'expiration, Année d'expiration.
Comment modifier une orchestration ?
- Allez à Orchestrations, cliquez sur l'orchestration.
- L'éditeur de canevas s'ouvre.
- Effectuez les modifications et cliquez sur Publier.
Comment activer ou désactiver une orchestration ?
Depuis l'éditeur de canevas, utilisez le toggle d'activation dans l'en-tête.
Mis à jour le : 12/05/2026
Merci !
