Évolution des Releases
Version | Date | Changements |
---|---|---|
22.1.0 | 08-11-2021 | release initiale |
23.1.0 | 22-03-2023 | Challenge preferences pour 3DSV2 |
23.2.0 | 05-02-2024 | Ajout des moyens de paiement PayPal et Instanea |
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
Cas d'usage 2
Cas d'usage 3
Cas d'usage 4
Limites- contraintes
Compatibilité
FLOA PAY : Information générale
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