Documentation

1Le concept de base des processeurs

Il est important d’avoir une compréhension claire des différents termes et de leur signification. Il est particulièrement important que vous compreniez la différence et la manière dont ces concepts sont liés les uns aux autres. En particulier la différence entre mode de paiement, processeur et connecteur.

1.1Anatomie

Pour qu’un mode de paiement apparaisse sur la page de paiement, les entités suivantes doivent être configurées correctement :

  • Processeur : Un processor représente une intégration unique vers un tiers capable de traiter des paiements. Pour chaque processor, une configuration doit être créée afin d’accepter des paiements via le processor.

  • Mode de paiement : Un payment method représente un moyen unique par lequel un client peut payer. Un payment method peut également être configuré pour contrôler des propriétés spécifiques du payment method. Afin d’accepter des paiements avec un mode de paiement particulier, une configuration pour ce payment method doit être créée.

  • Connecteur : Un connector relie le payment method au processor. Il s’agit en quelque sorte d’une connexion unique vers le processor. Un processor dispose d’un ensemble défini de connectors. Pour utiliser un connector, celui-ci doit être configuré. Le connector exécute effectivement le paiement et vous avez donc besoin de la configuration du connector afin d’accepter des paiements.

Pour chacune de ces entités, vous pouvez bien entendu avoir plusieurs configurations. Vous pouvez également avoir plusieurs configurations du même type et les séparer par des conditions ou les lier à une vue d’espace spécifique.

1.2Processeur

Vous pouvez créer une configuration de processeur sous Space > Paiement > Configuration > Processeurs.

Un processeur représente l’intégration API vers un tiers. La liste des processeurs montre tous les processeurs pris en charge.

Dans la configuration du processeur, vous pouvez généralement définir les paramètres suivants :

  • Activer ou désactiver la configuration du processeur. Lorsque la configuration du processeur est désactivée, toutes les configurations de connecteur liées à la configuration du processeur ne sont plus prises en compte pour l’autorisation des transactions. Une configuration désactivée peut être réactivée.

  • Basculer entre le mode live et le mode test.

  • Définir les identifiants afin d’utiliser l’API du processeur. Il s’agit par exemple des identifiants fournis par le processeur.

Vous pouvez avoir plusieurs instances du même processeur, ce qui permet d’utiliser plusieurs comptes du même processeur. Cela permet d’utiliser différents comptes en fonction d’une propriété de la transaction (par exemple le montant, le pays, etc.).

Exemple

Utiliser différents terminaux selon un critère spécifique :

Si vous souhaitez utiliser un processeur différent selon un critère de la transaction (par exemple le montant de la transaction), vous pouvez appliquer les conditions sur la configuration de connecteur correspondante (voir ci-dessous) afin de sélectionner le bon prestataire de services de paiement.

1.3Modes de paiement

Pour créer une configuration pour un mode de paiement, allez sous Space > Paiement > Configuration > Modes de paiement.

Une configuration de mode de paiement définit la manière dont le paiement est traité. Nous prenons en charge une multitude de modes de paiement différents. Notez que tous les modes de paiement ne peuvent pas être traités par tous les processeurs. La liste des modes de paiement montre tous les modes de paiement pris en charge.

Dans la configuration du mode de paiement, vous pouvez généralement définir les paramètres suivants :

  • Activer et désactiver une configuration de mode de paiement. Lorsqu’une configuration de mode de paiement est désactivée, cette configuration de mode de paiement n’est plus utilisée pour l’autorisation des transactions. Une configuration désactivée peut être réactivée.

  • Définir le nom du mode de paiement affiché au client.

  • Définir l’ordre dans lequel le mode de paiement est affiché au client.

  • Définir l’image utilisée pour le mode de paiement.

  • Certains modes de paiement permettent la collecte des informations de paiement directement sur notre page de paiement. Dans ce cas, vous pouvez choisir si vous préférez collecter les données sur la page de paiement du tiers (offsite) ou si nous devons collecter les données (onsite). Cette option n’apparaît que lorsque vous pouvez contrôler cela pour un mode de paiement particulier. Tous les connecteurs de paiement ne prennent pas en charge les deux modes de collecte des données, vous devriez donc d’abord vérifier si votre connecteur préféré prend en charge le type de collecte de données sélectionné. Une fois le type de collecte de données défini sur une configuration de mode de paiement, il ne peut plus être modifié.

Vous pouvez créer plusieurs configurations du même mode de paiement.

1.4Configurations de connecteur

Pour créer une configuration de connecteur, allez sous Space > Paiement > Configuration > Connecteurs.

Une configuration de connecteur relie les caractéristiques des modes de paiement aux capacités de votre processeur (c’est-à-dire que tous les modes de paiement ne peuvent pas être traités par tous les processeurs de paiement. Certains processeurs ne peuvent traiter certains modes de paiement qu’en offsite ou uniquement en onsite).

Les paramètres disponibles dépendent très fortement des capacités du connecteur et des caractéristiques du mode de paiement.

Dans la configuration du mode de paiement, vous pouvez généralement définir les paramètres suivants :

  • Activer et désactiver la configuration du connecteur. Une configuration de connecteur désactivée n’est pas prise en compte pour l’autorisation des transactions. Une configuration désactivée peut être réactivée.

  • L’ordre dans lequel les connecteurs sont appliqués aux transactions.

  • Les conditions qui sont appliquées au connecteur. Cela permet de contrôler dans quelles circonstances le connecteur sera utilisé.

  • Restreindre le connecteur à un ensemble de vues d’espace.

  • Le modèle d’e-mail d’autorisation et le modèle d’e-mail de facture.

  • Le modèle de facture appliqué aux transactions de ce connecteur.

  • Les paramètres spécifiques au connecteur, tels que les paramètres de fraude.

Afin de relier votre mode de paiement configuré au processeur, vous pouvez créer une configuration de connecteur distincte pour chacun de vos cas prévus.

Exemple

Utiliser différents terminaux selon un critère spécifique

Si vous souhaitez utiliser un processeur différent selon un critère de la transaction (par exemple le montant de la transaction), vous pouvez créer plusieurs configurations puis appliquer les conditions dans la configuration de connecteur correspondante.

2Appliquer des conditions sur les connecteurs

Les conditions sont notre moyen de sélectionner une configuration de connecteur pour une transaction. Vous pouvez créer des configurations de condition sous Space > Paiement > Configuration > Conditions.

Les conditions peuvent être définies sur la base de plusieurs critères de transaction. La liste des types de condition montre tous les types possibles. Chaque type définit différents critères pour filtrer les transactions. Ces conditions peuvent également être regroupées dans un groupe logique or, ce qui permet de formuler des conditions complexes.

Les conditions sont gérées de manière centralisée car elles peuvent être appliquées à plusieurs configurations, telles que :

  • Configuration de connecteur : les conditions agissent ici comme mécanisme de routage des transactions.

  • Configuration de charge flow : les conditions contrôlent quel flux est appliqué à la transaction.

Note
S’il reste encore plusieurs options après l’application d’une condition, la sélection est effectuée sur la base de la priorité définie dans la configuration. L’application des conditions et la priorité permettent de définir un routage des transactions.

3Collecte des données de paiement

Les informations de paiement peuvent être collectées soit par notre formulaire de paiement hébergé (onsite), soit nous pouvons rediriger le client vers le processeur pour la collecte des données (offsite).

  • La collecte de données onsite implique que le formulaire de collecte de données est généré par nous et qu’il peut donc être personnalisé en modifiant les éléments de formulaire correspondants via l’éditeur de ressources.

  • La collecte de données offsite implique que la personnalisation du formulaire doit être effectuée via les outils du processeur.

Note
Certains modes de paiement ne prennent en charge qu’un seul des deux types de collecte. Dans ce cas, la configuration du mode de paiement peut être définie pour la collecte de données offsite ou onsite. Cela signifie que selon la configuration du mode de paiement, il se peut que vous ne puissiez pas sélectionner chaque processeur lorsque vous mettez en place votre configuration de connecteur.
Staging 2.218.3