> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Créer et gérer les Orchestrations

# 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](https://academy.zrupay.com/fr/article/quest-ce-quun-orchestrateur-de-paiements-17m7etd/).

# 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 :

| Bloc | Premier paiement | Paiement récurrent | Paiement physique | Financement | Méthode alternative |
|---|---|---|---|---|---|
| Route | ✅ | ✅ | ✅ | ✅ | ✅ |
| Diviser le trafic | ✅ | ✅ | ✅ | ✅ | ✅ |
| Finaliser le paiement | ✅ | ✅ | ✅ | ✅ | ✅ |
| Refuser le paiement | ✅ | ✅ | ✅ | ✅ | ✅ |
| Exécuter 3DS | ✅ | ❌ | ❌ | ❌ | ❌ |
| Créer Network Token | ✅ | ✅ | ❌ | ❌ | ❌ |

# 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 (35 au total)

**Opération (12) :** Prix, Devise, Type, Langue, Autoriser uniquement, MOTO, Approbation partielle, POS, Terminal POS, Score de fraude, Récurrent d'autorisation, Récurrent d'abonnement.

**Client (9) :** Variable personnalisée, Type d'appareil, Système d'exploitation, Navigateur, Pays IP, Région IP, Pays, Région, E-mail.

**Carte (14) :** Marque, Type, Niveau, Pays d'émission, Banque émettrice, Portefeuille utilisé, BIN, Network Token, Tentative Network Token, Titulaire, Mois d'expiration, Année d'expiration, Prépayé, Entreprise.

> 🧐 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. Les orchestrations **Financement** et **Méthode alternative** n'offrent pas non plus les variables Carte : elles aboutissent à un seul moyen de paiement, il n'y a donc pas de carte à évaluer.

# Notes sur les blocs

Chaque bloc peut porter une **note** interne qui explique pourquoi il est configuré ainsi. Toute l'équipe comprend ainsi le flux sans avoir à demander à la personne qui l'a construit.

- Pour l'écrire, ouvrez le menu **« ... »** du bloc et choisissez **Ajouter une note**. La fenêtre **Notes** s'ouvre : saisissez votre texte et cliquez sur **Enregistrer**.
- Lorsqu'un bloc a une note, un bouton apparaît dans son en-tête pour l'ouvrir et la lire. Depuis cette même fenêtre, vous pouvez la modifier ou la retirer avec **Supprimer**.
- En mode consultation, la note peut être lue mais pas modifiée.

> 🧐 Les notes sont enregistrées dès que vous cliquez sur **Enregistrer**, sans publier l'orchestration, et elles ne sont pas affectées par annuler/rétablir. Seule exception : un bloc qui vient d'être ajouté et n'est pas encore publié ; sa note est enregistrée à la publication.

> 🧐 C'est une note interne : elle n'affecte pas le routage et n'apparaît jamais dans le checkout.

# 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 12 + Client 9 + Carte 14). 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à.