> ## 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).

# Ajouter et gérer les Connexions

# Qu'est-ce qu'une connexion dans Zru ?

Zru est un agrégateur de moyens de paiement. Mais au-delà de la connexion aux processeurs de paiement, il vous permet aussi de vous connecter à d'autres outils : antifraude, gestion des chargebacks, 3DS Agnostique, Network Token, etc.

C'est pourquoi la section s'appelle **Connexions** et pas simplement « moyens de paiement » : vous pouvez l'utiliser pour ajouter aussi bien des processeurs que des outils de gestion des paiements, le tout en quelques clics depuis le panneau.

**Tout au long de ce guide, nous utiliserons le terme « fournisseur » pour désigner aussi bien les moyens de paiement que les outils.**

# La différence entre une Connexion et un Moyen de paiement

Dans le panneau, nous distinguons une **connexion** et un **moyen de paiement** pour faciliter la gestion. Tout est regroupé par fournisseur.

Quelques points clés :

- Une connexion peut regrouper un ou plusieurs moyens de paiement.
- Il existe des connexions sans moyens de paiement, comme 3DS Agnostique, qui est un fournisseur de services et non de paiement.
- Les moyens de paiement vivent toujours à l'intérieur d'une connexion.
- Les identifiants se saisissent une seule fois au niveau de la connexion, pas pour chaque moyen de paiement séparément.

Quelques exemples :

- **Redsys** est une connexion avec trois moyens de paiement : Carte, Bizum et Carte Redirection.
- **dLocal** est une connexion avec plusieurs moyens de paiement : Carte, dLocal Redirection, 7-eleven, etc.
- **Inespay** est une connexion avec un seul moyen de paiement : Virement.
- **3DS Agnostique** est une connexion sans moyens de paiement.

# Avant d'ajouter une connexion

Zru est une **plateforme technologique** : elle vous connecte au fournisseur, mais vous devez d'abord avoir un compte chez lui.

- Dans certains cas, nous avons des accords avec le fournisseur et pouvons vous mettre directement en relation. Vous le verrez en ajoutant la connexion : l'étiquette **« Partner »** apparaît.
- Dans d'autres cas, nous nous en chargeons et vous n'avez besoin d'aucun compte chez un fournisseur externe, comme c'est le cas avec 3DS Agnostique ou Network Token.

Une fois votre compte créé chez le fournisseur, celui-ci vous remettra des **identifiants** que vous saisirez dans le panneau pour configurer la connexion.

> ✋ Gardez à l'esprit que selon la région ou le pays où se trouve votre entreprise, vous pourrez ou non utiliser certains fournisseurs, car chacun opère dans des pays déterminés.

# La liste des Connexions

Allez dans la section **Connexions** du menu vertical de gauche. Vous verrez deux onglets : **Actives** et **Désactivées**.

Vous pouvez rechercher par nom de connexion ou de moyen, et affiner avec les filtres **Toutes les catégories** et **Toutes les devises**. Le bouton **Exporter CSV** télécharge la liste.

Les colonnes de la liste sont :

- **Connexion** : le nom du fournisseur.
- **Catégorie** : le type de connexion (Processeur, Banque, BNPL, Marketplace, Sécurité, etc.).
- **Moyens de paiement** : les moyens actifs au sein de cette connexion.
- **Utilisation** : deux icônes indiquant si la connexion est utilisée dans des orchestrations et/ou des Checkouts. En survolant chaque icône, une infobulle affiche les noms précis.
- **Date de connexion** : quand elle a été ajoutée.

# Comment ajouter une connexion ?

L'ajout d'une connexion se fait dans une **vue dédiée étape par étape**.

**Étape 1 — Sélectionnez la connexion**

- Allez dans la section **Connexions** du menu vertical de gauche.
- Cliquez sur **« Nouvelle connexion »**.
- Recherchez la connexion souhaitée par **nom**, ou affinez avec les filtres de **devise** et de **catégorie**.
- Chaque carte affiche le fournisseur, une brève description, sa catégorie et les moyens de paiement pris en charge. Si nous avons un accord avec le fournisseur, vous verrez l'étiquette **« Partner »**.
- Cliquez sur la connexion de votre choix.

**Étape 2 — Configurez les identifiants**

Un **panneau latéral** s'ouvre avec la configuration de la connexion.

- Saisissez le **nom** sous lequel la connexion apparaîtra au checkout.
- Dans le bloc **Identifiants de [fournisseur]**, saisissez les identifiants qui vous ont été fournis.

> ✋ Si vous êtes dans un environnement de test, saisissez les identifiants de test. S'il s'agit d'un environnement de production, ceux de production.

Dans les environnements de test, si le processeur est compatible, vous pourrez choisir entre deux options :

- **Mes identifiants** : utilisez vos propres identifiants de test du processeur. Choisissez cette option si vous avez déjà un compte actif chez lui.
- **Identifiants de Zru** : Zru vous fournit les identifiants sandbox. Utile pour commencer à tester sans avoir votre propre compte chez le processeur.

Selon le fournisseur, vous verrez des champs et des options spécifiques (par exemple, activer ou forcer le 3DS). Si vous souhaitez attribuer votre propre identifiant à la connexion, dépliez **Configuration avancée** et remplissez le champ **Code interne**.

- Cliquez sur **« Continuer »**.

**Étape 3 — Ajoutez les moyens de paiement**

Dans le panneau latéral **Ajouter des moyens de paiement** :

- Sélectionnez les moyens que vous souhaitez activer, ou utilisez **« Tout sélectionner »**.
- Cliquez sur **« Ajouter des moyens »**.

La connexion est créée **active** par défaut. Vous verrez un message qui vous invite à commencer à opérer en ajoutant la connexion à vos **Orchestrations** ou **Checkouts**.

# Le détail d'une connexion

En cliquant sur une connexion, vous verrez son détail. L'en-tête affiche la **Connexion** (fournisseur), la **Catégorie**, l'**Utilisation** dans les orchestrations et les Checkouts, la **Date de connexion** et son **statut**.

En dessous se trouve la section **Moyens de paiement**, avec sa propre recherche et ses filtres (**Tous les statuts**, **Toutes les devises**). Pour chaque moyen, vous pouvez consulter :

- **Utilisation** : dans combien d'orchestrations et de Checkouts il est utilisé.
- **Paiements / Acceptation** : le nombre de paiements traités et leur taux d'acceptation.
- **Devises** : les devises dans lesquelles le moyen opère.
- **Dernière modification** : quand il a été mis à jour pour la dernière fois.
- **Statut** : activez ou désactivez le moyen avec le toggle, sans quitter le tableau.

D'ici, vous pouvez aussi supprimer un moyen avec l'icône de corbeille.

> 🧐 Si une connexion n'a aucun moyen actif, le panneau vous invite à en ajouter un pour que la connexion puisse commencer à opérer.

# Configuration avancée d'une connexion

Dans le détail d'une connexion, cliquez sur **« Configuration »** en haut à droite. Un panneau s'ouvre avec l'accordéon **Configuration avancée**, qui inclut le champ **Code interne**.

> 🧐 Le code interne est envoyé dans la notification à l'intérieur de `_gateway`, dans le champ `internal_code`. Il est utile si vous devez identifier de quelle connexion provient un paiement dans vos systèmes.

Vous pouvez aussi remplir ce champ lors de la création de la connexion, à l'étape des identifiants.

# Comment activer ou désactiver une connexion ?

### Pour désactiver une connexion

- Allez dans la section **Connexions** du menu vertical de gauche.
- Cliquez sur la connexion que vous souhaitez désactiver, dans l'onglet **Actives**.
- Cliquez sur **« Configuration »** en haut à droite et désactivez **« Statut de la connexion »** en bas du module.
- Cliquez sur **« Mettre à jour »**.

La connexion passera dans l'onglet **Désactivées**.

### Pour activer une connexion

- Allez dans la section **Connexions** du menu vertical de gauche.
- Cliquez sur l'onglet **Désactivées**.
- Cliquez sur la connexion que vous souhaitez activer.
- Cliquez sur **« Configuration »** en haut à droite et activez **« Statut de la connexion »** en bas du module.
- Cliquez sur **« Mettre à jour »**.

> ✋ Gardez à l'esprit qu'activer la connexion n'active pas automatiquement les moyens qu'elle contient. Vous devez entrer dans la connexion et activer les moyens souhaités avec le toggle de **Statut**.

# Comment modifier une connexion ?

- Allez dans la section **Connexions** du menu vertical de gauche.
- Cliquez sur la connexion que vous souhaitez modifier.
- Cliquez sur **« Configuration »** en haut à droite.
- Modifiez les paramètres nécessaires.
- Cliquez sur **« Mettre à jour »** pour enregistrer les modifications.

# Puis-je supprimer une connexion ?

Il n'est actuellement pas possible de supprimer une connexion. Si vous n'en avez plus besoin, gardez-la désactivée. Vous pouvez toujours la réactiver quand vous le souhaitez.

# Où puis-je utiliser les connexions ?

Les moyens de paiement de chaque connexion (ou la connexion elle-même, si ce n'est pas un processeur de paiement) seront disponibles comme option lorsque vous configurez vos **Orchestrations** et vos **Checkouts**.