Qu'est-ce qu'une orchestration ?

Une orchestration est un flux de routage qui décide quelle connexion gère chaque paiement. Vous pouvez définir des routes différentes selon des variables du paiement, du client ou de la carte, et ajouter des connexions alternatives qui prennent le relais si la principale échoue.

Pour en savoir plus sur ce qu'est l'orchestration des paiements et à quoi elle sert, vous pouvez lire cet article de l'Academy.

Avant de créer une orchestration

• Vous pouvez orchestrer trois choses différentes, selon le trigger que vous choisissez : des processeurs de carte entre eux, des organismes de financement entre eux, ou les comptes d'un même moyen de paiement. Ce que vous ne pouvez pas faire, c'est router entre des moyens différents, par exemple passer de Bizum à PayPal.
• Les connexions que vous voulez utiliser doivent être ajoutées et actives dans Connexions. Si vous ne les avez pas ajoutées au préalable, elles n'apparaîtront pas lors de la construction de l'orchestration.
• Si vous allez orchestrer des processeurs de carte, le processeur ne peut pas être en mode redirection. Lors de son ajout dans Connexions, assurez-vous qu'il indique « Sans redirection ». S'il indique « avec redirection », le flux sort de Zru et ne peut pas être redirigé vers un autre processeur.

La liste des orchestrations

Allez à la section Orchestrations du menu vertical de gauche. Vous verrez deux onglets : Actifs et Désactivées.

• Vous pouvez basculer entre la vue grille et la vue liste avec le toggle en haut à droite.
• Le menu déroulant Tous les triggers filtre la liste par trigger : Premier paiement, Paiement récurrent, Paiement physique, Financement et Méthodes alternatives.
• En vue liste, le menu « ... » de l'en-tête du tableau ouvre Personnaliser le tableau, où vous choisissez et réordonnez les colonnes. Cela s'applique avec Appliquer les modifications.
• Le bouton Exporter un fichier CSV, dans l'en-tête à côté de Créer une orchestration, télécharge le contenu de la liste.

✋ Exporter un fichier CSV n'apparaît que si votre rôle possède la permission Exporter dans Environnement → Orchestrations. Elle fonctionne comme la permission d'exportation des Connexions.

Comment créer une orchestration ?

• Allez à la section Orchestrations du menu vertical de gauche.
• Cliquez sur « Créer une orchestration ».
• Le canevas de l'éditeur s'ouvre. Saisissez le nom de l'orchestration dans le champ du haut.
• Choisissez le trigger avec lequel vous voulez déclencher cette orchestration (voir la section suivante).
• Si vous choisissez Méthode alternative, la prochaine chose demandée est le moyen de paiement au sein duquel vous allez router (voir La carte Méthode).
• À partir de là, construisez le flux en ajoutant des blocs depuis le panneau de droite.
• Quand vous avez terminé, cliquez sur Publier pour que les modifications prennent effet.

⚠️ À la publication, les modifications s'appliquent immédiatement à tous les Checkouts qui utilisent cette orchestration.

Le canevas : comment ça fonctionne

L'éditeur d'orchestrations est un canevas visuel. Vous pouvez vous y déplacer en faisant glisser la souris et zoomer avec le scroll du trackpad.

Quand vous ouvrez une orchestration, vous entrez en mode consultation, avec le flux dessiné mais non modifiable. Dans l'en-tête vous trouverez :

• Le toggle d'activation de l'orchestration.
• La date de dernière mise à jour.
• Le nom de l'orchestration.
• Le compteur d'utilisation : combien de Checkouts utilisent cette orchestration.
• Le bouton Modifier.

En cliquant sur Modifier, vous passez en édition et l'en-tête ajoute :

• Les boutons annuler (↶) et rétablir (↷).
• Le bouton Publier.

🧐 En mode consultation, les menus de suppression ne sont pas proposés et le toggle d'activation ne peut pas être déplacé. Le bouton Modifier n'apparaît que si votre rôle a la permission d'édition.

Les triggers

Lors de la création d'une orchestration, la première chose à faire est de choisir le trigger, c'est-à-dire quel type de paiement va la déclencher :

• Premier paiement : paiements initiés par l'utilisateur au moment du checkout.
• Paiement récurrent : prélèvements récurrents d'autorisations ou d'abonnements.
• Paiement physique : paiements effectués sur un terminal physique (POS).
• Financement : paiements réglés par un organisme de financement. Il va directement du trigger à l'action et ne liste que des organismes de financement.
• Méthode alternative : route entre les comptes d'un même moyen de paiement, comme Bizum, PayPal ou Klarna.

🧐 Le trigger détermine quels blocs et quelles connexions sont disponibles sur le canevas. Par exemple, avec le trigger « Paiement physique », seuls les processeurs qui acceptent le paiement en présentiel apparaissent.

✋ Financement et Méthode alternative routent au sein d'un même moyen de paiement, pas entre processeurs de carte. C'est pourquoi ils n'offrent ni Exécuter 3DS, ni Créer Network Token, ni chaîne de nouvelles tentatives : seulement Route et Diviser le trafic comme utilitaires, et Finaliser le paiement ou Refuser le paiement comme actions. En choisissant Finaliser le paiement, la sélection du compte s'ouvre directement, sans écran intermédiaire.

Les comptes proposés dans chaque bloc dépendent du trigger : des processeurs avec les triggers de carte, des organismes de financement avec Financement, et des connexions du moyen choisi avec Méthode alternative.

La carte Méthode

Elle n'apparaît qu'avec le trigger Méthode alternative. C'est une carte à part, appelée Méthode, située entre le trigger et la première étape du flux.

• À la création de l'orchestration, la première chose demandée est le moyen de paiement.
• Pour le changer, cliquez sur le moyen dans la carte : un panneau s'ouvre avec un champ de recherche et la liste des moyens disponibles.
• Pour le retirer, utilisez le menu « ... » de la carte, qui propose l'option de suppression.
• À partir de ce moyen, les blocs d'action ne proposent que des comptes de ce moyen.

⚠️ En supprimant la carte Méthode, le trigger et tout ce que vous avez construit en dessous sont également retirés.

Les blocs

Une fois le trigger choisi, vous construisez le flux en combinant des blocs. Il y en a deux types : les blocs d'utilité (ils organisent le flux) et les blocs d'action (ils exécutent quelque chose sur le paiement).

Blocs d'utilité :

• Route : divise le flux en branches selon des conditions. Fonctionne comme un switch/case (voir la section suivante).
• Diviser le trafic : répartit le trafic entre les branches selon des pourcentages configurables.

Blocs d'action :

• Finaliser le paiement : envoie le paiement à une connexion pour qu'elle le traite. Dans la carte, + Ajouter un fallback ajoute des connexions de nouvelle tentative qui prennent le relais si la précédente échoue.
• Refuser le paiement : coupe le flux et renvoie le paiement comme refusé. Lors de sa configuration, vous choisissez quelle erreur vous voulez renvoyer, et la carte affiche son code et son texte.
• 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 le traitement.

Tous les blocs ne sont pas disponibles avec tous les triggers :

Le bloc Route

Le bloc Route est le plus puissant de l'éditeur. Ce n'est pas un simple « si/sinon » : il fonctionne comme un switch/case, où chaque condition que vous ajoutez est une branche de sortie indépendante avec son propre flux.

En ajoutant un bloc Route, vous verrez :

• Condition 1, Condition 2... : chacune est une branche. Vous pouvez en ajouter autant que nécessaire avec le bouton « + Ajouter une condition » et supprimer chacune avec son icône de corbeille.
• Tous les autres : branche de repli qui s'exécute quand aucune condition n'est remplie. Elle est toujours présente et ne peut pas être supprimée.

Dans chaque condition, vous définissez les variables que le paiement doit remplir pour passer par cette branche. Si vous ajoutez plusieurs variables à une même condition, toutes doivent être remplies en même temps (logique AND).

Variables disponibles dans une condition (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.

🧐 La catégorie Carte est exclusive aux orchestrations. Les données de la carte ne sont connues qu'au moment du traitement du paiement, pas avant, c'est pourquoi cette catégorie n'est pas disponible dans les Checkouts. Le Score de fraude est également exclusif aux orchestrations pour la même raison.

Configuration d'une connexion dans un bloc

Pour configurer une connexion déjà présente dans un bloc, cliquez directement dessus. Un panneau s'ouvre à droite, et son contenu dépend du bloc et du trigger.

Dans tous les cas, l'en-tête du panneau affiche la connexion avec un bouton Modifier pour la remplacer, et un bouton Enregistrer en bas.

Avec Finaliser le paiement et un trigger de carte, le panneau s'intitule « Configuration du processeur » et contient les quatre sections ci-dessous. Avec Financement, il vous laisse seulement changer la connexion : pas de 3D Secure, pas de Network Token, pas de condition générale et pas de connexions secondaires, car ils ne s'appliquent pas. Dans Exécuter 3DS, le panneau porte le nom du bloc et vous laisse également seulement changer la connexion.

Condition générale

Elle permet que cette connexion ne soit utilisée que si certaines conditions sont remplies (mêmes variables : Opération 10 + Client 9 + Carte 12). Quand il n'y en a aucune, la section affiche « Sans condition », et vous les ajoutez avec + Ajouter une condition. Si vous n'ajoutez aucune condition, la connexion sera toujours exécutée.

Connexions secondaires

Elle permet de définir des connexions alternatives du même processeur qui seront utilisées à la place de la principale selon certaines conditions. Vous les ajoutez avec + Ajouter une connexion.

✋ Vous ne pouvez ajouter que des connexions du même processeur que la principale. Par exemple, si la principale est Adyen, les secondaires doivent aussi être des connexions Adyen.

C'est utile quand vous avez plusieurs comptes du même processeur pour différents marchés (Europe, LATAM, US) et que vous voulez utiliser le bon compte selon Pays IP ou Devise, sans avoir à créer des blocs séparés.

3D Secure

Disponible uniquement dans le bloc Finaliser le paiement.

Choisissez comment vous voulez appliquer l'authentification 3DS sur ce processeur :

• Agnostique : utilise l'information 3DS déjà produite par un bloc antérieur (« Exécuter 3DS ») et l'envoie au processeur, sans redemander d'authentification.
• Processeur : applique le 3DS en suivant la décision du processeur et de la banque émettrice, selon leurs règles de risque.
• Processeur (Forcer 3DS) : force l'authentification 3DS sur toutes les opérations, indépendamment du montant ou du risque.
• Sans 3DS : n'applique pas l'authentification 3DS, même si l'émetteur pourrait la demander malgré tout.

Network Token

Disponible uniquement dans le bloc Finaliser le paiement.

• Utiliser si disponible : si la carte possède un network token, il sera utilisé à la place du PAN pour traiter le paiement, ce qui améliore la sécurité et le taux d'acceptation.
• Ne pas utiliser : le paiement est traité avec les données originales de la carte, même s'il existe un network token disponible.

Comment modifier une orchestration ?

• Allez à la section Orchestrations du menu vertical de gauche.
• Cliquez sur l'orchestration que vous voulez modifier. Elle s'ouvre en mode consultation.
• Cliquez sur Modifier pour passer en édition.
• Effectuez les modifications nécessaires.
• Cliquez sur Publier pour qu'elles prennent effet.

⚠️ À la publication, les modifications s'appliquent immédiatement à tous les Checkouts qui utilisent cette orchestration.

🧐 Si vous quittez une orchestration avec des modifications non publiées, le panel vous demande confirmation avant de sortir. Activer ou désactiver l'orchestration compte comme une modification, donc cela ne se perd pas non plus sans avertissement.

Comment activer ou désactiver une orchestration ?

Depuis le canevas, utilisez le toggle d'activation de l'en-tête pour activer ou désactiver l'orchestration. En mode consultation, le toggle ne peut pas être déplacé : passez d'abord par Modifier.

Vous pouvez aussi le faire depuis la liste : en vue liste, chaque orchestration affiche son état et vous pouvez la gérer depuis là.

Mis à jour le : 01/09/2026