Introduction

La plateforme de paiement Axepta BNP Paribas accepte les ordres de paiement, traite les données et effectue les opérations de paiement du commerçant de manière sécurisée.

Afin d’envoyer des ordres de paiement à la plateforme de paiement Axepta BNP Paribas, le commerçant :

● Se connecte via Internet à la plateforme de paiement.

● Envoie les données de paiement requises dans un format homogène défini.

Quel que soit le mode de paiement, les mêmes paramètres sont transmis afin que tous les modes de paiement fonctionnent de la même manière et ne nécessitent aucun effort supplémentaire. 

Le connecteur Axepta BNP Paribas permet aux commerçants de gérer les différents modes de paiement et leurs différentes options (Remboursement, Paiement en un clic). Il offre plusieurs options pour ajouter des détails spécifiques au paiement (informations de carte de crédit ou de débit) pendant le processus de paiement : via une page hébergée, externe à la plateforme Salesforce Commerce Cloud ou via un iframe sur la vitrine Salesforce Commerce Cloud du marchand.

Ce document décrit entièrement comment installer le connecteur et l’intégrer dans la boutique en ligne. Il est nécessaire pour le commerçant de contacter d’abord Axepta BNP Paribas et de demander un compte pour que l’intégration fonctionne correctement. Le support Axepta fournit des comptes de test et de production pour le commerçant. Il existe également une configuration à effectuer dans Salesforce Commerce Cloud Business Manager.

Le module Axepta BNP Paribas prend actuellement en charge les modes de paiement suivants :

• CB / Visa / Mastercard
• American Express
• FLOA Pay (en cours)

Le module Axepta BNP Paribas est développé en anglais (US), mais peut être configuré dans n’importe quelle langue/région nécessaire. L’emplacement de stockage des données de paiement est très important pour la sécurité des paiements en ligne. Les organisations de cartes ont mis en place un programme de sécurité avec l’autorisation de sécurité PCI (Payment Card Industry) afin de garantir le stockage sécurisé des données de carte. En outre, la cartouche n’effectue aucune demande d’informations sensibles PCI.

Cette cartouche est disponible pour les 2 versions de SFCC (SFRA ou Sitegenesis)

Compatibilité

La cartouche d’intégration Axepta a été certifiée avec la version de Salesforce Commerce Cloud : actuellement API version 22.10, Site Genesis version 104.1.3 et SFRA version 5.3.0. Il est généralement rétrocompatible avec les anciennes versions car il utilise des méthodes courantes et stables pour accéder aux objets système Client, Commande et Paiement. Actuellement, SFRA version 6.x et supérieure ne sont pas pris en charge.

Présentation globale 

Présentation fonctionnelle

Gestion de l'extension Axepta 

Les commerçants peuvent configurer les fonctionnalités de la cartouche Axepta à partir de Salesforce Commerce Cloud BM. Sur la page Business Manager, chaque commerçant peut configurer la connexion à Axepta. Le commerçant devra saisir les informations d’identification reçues lors de l’ouverture d’un compte avec Axepta afin de créer une connexion à la plateforme.

Hébergement en Mode iFrame 

La cartouche permet au commerçant d’utiliser les solutions de paiement Axepta via un iframe intégré à sa propre implémentation Salesforce Commerce Cloud.

Hébergement en mode formulaire

La cartouche prend en charge l’approche de la page de paiement hébergée, où les informations de paiement sont entrées directement sur les pages hébergées et fournies par Axepta. Au cours du processus de paiement, lorsque le client choisit d’utiliser l’un des modes de paiement pour lesquels le mode de formulaire hébergé est activé, il / elle sera redirigé vers les pages de paiement hébergées Axepta afin de compléter la commande. Une fois la commande terminée, le client est renvoyé à la boutique du commerçant, où il / elle peut examiner le résumé de la commande.

Moyens de paiement

La cartouche permet au client de sélectionner et d’utiliser une variété de méthodes de paiement afin de compléter le processus de paiement. Les méthodes de paiement disponibles et les configurations afférentes sont gérées via une clé d’activation fournie par Axepta et configurée dans Business Manager.

Configuration du compte

La cartouche prend en charge la configuration de plusieurs comptes. Chaque compte peut être personnalisé en fonction des besoins du commerçant, en accédant à l’écran Module Axepta > Configuration des comptes et en modifiant les options.

Gestion des commandes

L’écran de gestion des commandes personnalisé fourni avec la cartouche Axepta permet au commerçant d’effectuer des opérations sur chaque commande individuelle, ainsi que de visualiser les informations de commande, les détails de paiement et les notes.

Signature d'Axepta

Un mécanisme de vérification de signature est disponible pour vérifier le contenu des demandes et redirections entre le site marchand et la plateforme Axepta. Chaque requête est signée avec un paramètre de chaîne qui assure l’origine et l’intégrité de la requête, hachée avec un algorithme SHA256.

Types d'opérations prises en charge

La cartouche prend en charge les opérations d’autorisation et de paiement, ainsi que les remboursements partiels ou totaux. Chaque opération est déclenchée selon le mode de paiement choisi par le client lors du processus de paiement.

Paiement

Dans ce cas, la capture est demandée automatiquement après l’autorisation. Si la capture n’est pas réussie, le client (l’acheteur) est redirigé vers une page d’erreur. Si la capture est réussie, le client est redirigé vers une page de réussite et termine le processus de paiement.

Autorisation 

Dans ce cas, le client (l’acheteur) n’est pas facturé automatiquement ou directement après la commande. Le commerçant dispose d’un laps de temps défini pour saisir le montant d’argent auprès du client. Seule la capture totale est prise en charge par la cartouche. La capture peut être déclenchée de plusieurs façons :

• automatiquement dans un délai défini, qui peut être configuré par le commerçant dans le paramètre de l’option de paiement différé

• via une tâche , qui saisira le montant pour toutes les commandes dont le statut d’expédition est « Expédié »

Annulation

Il est possible d’annuler une commande en accédant à l’écran Module Axepta > Gérer les commandes > Détails de la commande. Une commande ne peut être annulée que si elle n’a pas encore été saisie. Sinon, le commerçant se verra offrir d’effectuer un remboursement.

Remboursement

La cartouche offre au commerçant la possibilité d’effectuer un remboursement partiel ou total d’une commande, en accédant à l’écran Module Axepta > Gérer les commandes > Détails de la commande. Cette opération permet au commerçant de créditer des fonds à un utilisateur final à la suite d’un débit précédent et elle est toujours liée à une transaction de paiement ou de capture réussie.

Cas d'usages

Lors du passage au checkout , le client peut choisir de terminer le processus en utilisant l’un des modes de paiement disponibles :

• Carte bancaire (CB, Visa, MasterCard)

• American Express

Chaque mode de paiement peut être personnalisé par le commerçant dans la section Business Manager > Module Axepta > Configuration des comptes. Différentes options peuvent également être activées et personnalisées, options qui seront prises en compte lors du processus de paiement, selon les spécifications définies par le commerçant :

• Paiement standard : cette option déclenche une opération de paiement

• Paiement différé : cette option déclenche une opération d’autorisation, qui doit être suivie d’une capture

• Manuellement pour chaque commande, en accédant aux détails de la commande depuis le module Axepta > Gérer les commandes

Deux modes d’intégration sont utilisés pour la cartouche Axepta afin de traiter les transactions :

• Formulaire hébergé : l’acheteur est redirigé vers la page de paiement hébergée d’Axepta.

• Formulaire hébergé dans un iframe : la page de paiement hébergée d’Axepta est affichée dans un iframe.

Une fois le paiement effectué, l’acheteur est renvoyé à l’URL de notification de la boutique. Cette URL de notification peut être configurée et contient le résultat du paiement (succès ou échec). Les données reçues dans les notifications sont ajoutées sous forme de notes aux détails de la commande.

Les clients inscrits et invités suivront le processus de paiement standard, avec les branches suivantes :

• Lorsque l’acheteur sélectionne un mode de paiement pour lequel le mode de formulaire hébergé est activé, il n’entrera plus les détails de sa carte de crédit dans la page de paiement de la boutique, mais sera redirigé vers la page de paiement Axepta. Une fois que le client a confirmé la commande, il / elle est retournée à la boutique du commerçant, sur la page de résumé de la commande après une transaction réussie ou sur la page de confirmation de la commande si la commande a été annulée ou le paiement a été refusé.
• Lorsque l’acheteur est authentifié et sélectionne un mode de paiement par carte de crédit, plusieurs options lui sont présentées et, une fois la sélection effectuée, le processus de paiement normal se poursuit : 

                                     - Utilisez une nouvelle carte de crédit et enregistrez-la

                                     - Utiliser une nouvelle carte de crédit sans l’enregistrer

                                     - Utiliser une carte de crédit déjà enregistrée

                                     - Modifier et utiliser une carte existante

Exemple de scénarios d’essai :

• Tous les scénarios de test impliquent des paiements réussis et refusés

• Les scénarios de test doivent être effectués avec chaque méthode et option de paiement disponibles

• La devise utilisée doit être EUR ou USD

• Si, pour une méthode de paiement sur une page hébergée, il y a une page d’émulation, toutes les options (p. ex., annulation, exception, refus) doivent être utilisées pour tester le comportement du système.

• Lors d’un paiement, un objet de commande Salesforce Commerce Cloud change son statut comme suit :

                        - CRÉE : la page iFrame a été affichée – le panier a été effacé – la commande peut rester dans ce statut si le processus n’a pas été correctement terminé (bug) ou si l’utilisateur abandonne la page Iframe ou hébergé et ne termine pas le paiement

                       - NOUVEAU : l’iframe a été clôturé avec une acceptation – l’Ordre a changé son statut

                       - OUVERT : la commande a été affichée dans DW Business Manager après avoir été au statut NEW

                       - ÉCHEC : tous les cas d’annulation et de refus

Cas d'usage 1

Sommaire : 

Le client passe une commande en tant qu’invité ou authentifié, en utilisant un mode de paiement avec le mode de formulaire hébergé activé.

Conditions préalables : 

• Les méthodes de paiement par carte bancaire ou American Express sont activées dans Business Manager > Outils marchands > Module Axepta > Configuration du compte

• Le mode de formulaire hébergé est sélectionné pour le mode de paiement activé

Étapes :

1. Le client accède au site, sélectionne certains produits et les ajoute au panier.

2. Le client lance le processus de paiement et remplit les informations requises dans le formulaire d’expédition

3. Le client remplit les informations requises dans le formulaire de facturation

4. Le client passe à l’étape de paiement, sélectionne le mode de paiement et passe à la dernière étape.

5. Le client est redirigé vers la page de paiement Axepta où il ajoutera les informations de carte de crédit et passera la commande.

6. Après un paiement complet réussi, il est redirigé vers la page Récapitulatif de la commande.

7. Le client peut vérifier les renseignements du résumé de la commande.

8. Le commerçant peut vérifier les détails de la commande, les informations de paiement et les notifications Business Manager >Outils Marchands >  Module Axepta > Gestion des commandes.

9. Le commerçant peut vérifier les informations dans la plateforme extranet Axepta.

Cas d'usage 2

Sommaire : 

Le client passe une commande en tant qu’invité ou authentifié, en utilisant un mode de paiement avec le mode formulaire iframe activé.

Conditions préalables : 

• Les méthodes de paiement par carte bancaire ou American Express sont activées dans Business Manager > Outils marchands > Module Axepta > Configuration du compte.

• Le mode de formulaire Iframe est sélectionné pour le mode de paiement activé.

Étapes :

1. Le client accède au site, sélectionne certains produits et les ajoute au panier.

2. Le client lance le processus de paiement et remplit les informations requises dans le formulaire d’expédition.

3. Le client remplit les informations requises dans le formulaire de facturation.

4. Le client passe à l’étape de paiement, sélectionne le mode de paiement et passe à la dernière étape.

5. L’iFrame avec le formulaire est affiché où le client ajoutera les informations de carte de crédit et procède à la commande.

6. Après un paiement complet réussi, il est redirigé vers la page Récapitulatif de la commande.

7. Le client peut vérifier les renseignements du résumé de la commande.

8. Le commerçant peut vérifier les détails de la commande, les informations de paiement et les notifications Business Manager > Outils marchands > Module Axepta > Gérer les commandes.

9. Le commerçant peut vérifier les informations dans la plateforme extranet Axepta.

Cas d'usage 3

Sommaire : 

Le client passe une commande en tant qu’utilisateur authentifié, en utilisant la carte bancaire ou la méthode de paiement American Express avec l’option One-Click activée.

Conditions préalables : 

• Les méthodes de paiement par carte bancaire et/ou American Express sont activées dans Business Manager > Outils marchands > Module Axepta > Configuration du compte.

Étapes : 

1. Le client accède au magasin et se connecte avec un compte existant.

2. Le client sélectionne certains produits et les ajoute au panier, puis lance le processus de paiement.

3. Le client remplit les informations requises dans les formulaires d’expédition et de facturation.

4. Le client passe à l’étape de paiement et choisit le mode de paiement.

5. Le client choisit dans le formulaire une des options présentées : utiliser la nouvelle carte, utiliser la carte préenregistrée ou modifier et utiliser la carte préenregistrée.

6. Le client passe à la dernière étape de paiement et appuie sur le bouton Passer commande.

7. Après un paiement complet réussi, il est redirigé vers la page Récapitulatif de la commande.

8. Le commerçant peut vérifier les détails de la commande, les informations de paiement et les notifications dans Business Manager > Outils marchands > Module Axepta > Gérer les commandes.

9. Le commerçant peut vérifier les informations dans la plateforme extranet Axepta.

Cas d'usage 4

Sommaire : 

Le commerçant effectue des opérations manuelles de saisie/remboursement sur une nouvelle commande.

Conditions préalables : 

Les commandes ont été passées au statut Nouveau ou Ouvert.

Étapes : 

1.Le commerçant accède à Business Manager > Outils marchands > Module Axepta > Gérer les commandes et ouvre l’écran des détails de la commande pour une commande existante.

2. Le commerçant déclenche l’opération disponible (saisie ou remboursement).

3. Un message est présenté au commerçant avec le statut de l’opération (succès ou échec)

4. Le commerçant peut vérifier le résultat une fois que les notes ont été ajoutées à la commande.

5. Les détails de la commande sont mis à jour.

6. Le commerçant peut vérifier les informations dans la plateforme extranet Axepta.

Limites- contraintes

• Le commerçant a besoin d’un compte Axepta configuré

• Les fonctionnalités suivantes ne sont pas concernées :

                      -  Multi-autorisation

                      -  Multicapture

                      -  Nul

                      - Paiement en plusieurs fois

                      - Paiements par lien direct

La cartouche Axepta est développée sur la base de la locale en_US, mais elle peut être configurée dans n’importe quelle locale requise. En outre, la cartouche n’effectue aucune demande d’informations sensibles PCI.

Compatibilité

La cartouche d’intégration Axepta a été certifiée avec la version de Salesforce Commerce Cloud : actuellement API version 22.10, Site Genesis version 104.1.3 et SFRA version 5.3.0. Il est généralement rétrocompatible avec les anciennes versions car il utilise des méthodes communes et stables pour accéder aux objets du système Client, Commande et Paiement. Actuellement, SFRA version 6.x et supérieure ne sont pas pris en charge.

FLOA PAY : Information générale

FLOA Pay permet à un commerçant d’offrir des plans de versements 3X, 4X, 1XD ou 3XD aux clients pendant le paiement. Au cours de la première étape, FLOA Pay vérifie l’admissibilité du client au versement choisi. Ensuite, en cas de résultat positif, FLOA Pay redirige le client vers la page de paiement hébergé FLOA Pay. Un commerçant peut être configuré du côté FLOA Pay pour une capture automatique ou manuelle. En cas de saisie de capture automatique, FLOA Pay ne s’attend pas à ce que le commerçant le fasse. FLOA Pay effectue la saisie automatiquement en fonction de l’autorisation. En cas de capture manuelle, le commerçant doit appeler l’API de capture. Après une vérification de crédit, FLOA Pay assume l’intégralité du risque de défaut de paiement du client pour chaque transaction. Le commerçant reçoit le montant total du versement de FLOA Pay après la capture.

Configuration 

Axepta Floa 1

Axepta Floa 2 

Axepta Floa 3

Axepta Floa 4

Fonctionnalité de la boutique

Désactiver Floa dans le checkout

Placer une commande avec 3x Floa 

PayPal : Information générale

Configuration du compte

Moyens de paiement

Préférences du client

Fonctionnalité de la boutique

Désactiver PayPal dans le checkout

Placer une commande avec PayPal

INSTANEA : Information Générale

Configuration du compte

Moyens de paiement

Préférences du client

Fonctionnalité de la boutique

Désactiver Instanea dans le checkout

Placer une commande avec Instanea

Installation des Cartouches - SFRA

Installation

Installation des dépendances

Compilation de code (JS / SCSS)

Importation des métadonnées 

Gestionnaire d'affaire du module 

Installation des Cartouches - Site Genesis

Installation

Installation

Importation des métadonnées 

Configuration

Configuration du site de préférence

Configuration personnalisée

Gestion des transactions 

Détails des transactions

Annulations

Remboursements

Capture

Tests

Tests unitaires

Tests d'intégration 

Configuration 

Lancer des tests 

Opérations- Maintenance

Stockage des données

Objets personnalisés

Commandes

Services 

Disponibilité

Indisponibilité de Axepta 

Support

Guide Utilisateur

Rôles -Responsabilités

Gestionnaire d'affaire

Module Axepta 

Configuration 

Configuration du module 

Configuration des comptes de paiement Axepta - Configuration des comptes

Créer un compte de paiement

Modification d'un compte de paiement

Gestion des transactions

Liste des transactions 

Détail des transactions

Annulation 

Remboursement 

Mode de Capture 

Configuration des tâches

Site de préférence de la configuration de Axepta 

Processeurs de paiement 

Moyens de paiement 

Logs

Notifications et URL de redirection

Fonctionnalité de la boutique

Mode de paiement 

Désactiver le mode de paiement dans le checkout

Paiement par redirection 

Paiement par iFrame