Sommaire
| Table of Contents |
|---|
Introduction
Bienvenue dans la documentation du module AXEPTA BNP Paribas pour Prestashop
Ce module gratuit vous permet d’intégrer facilement notre solution de paiement en ligne au sein de votre boutique e-commerce.
Cette documentation vous guidera dans l’installation, la configuration et l’utilisation du module afin de vous garantir une intégration simple, fiable et adaptée à vos besoins.
| Info |
|---|
Le module est accessible gratuitement à l'adresse suivante : GitHub - AxeptaBNPParibas/AxeptaOnline-Prestashop-plugin: Axepta Online plugin for Prestashop · GitHub |
Prérequis nécessaires
Vous devez disposer d'une installation Prestashop pleinement fonctionnelle.
| Tip |
|---|
Assurez- vous de votre compatibilité de version Prestashop & PHP avec le module Axepta Online Vous trouverez les versions compatible ici : GitHub - AxeptaBNPParibas/AxeptaOnline-Prestashop-plugin: Axepta Online plugin for Prestashop · GitHub |
Installation du module Prestashop
Installation via l'interface Prestashop
Pour une installation rapide et simple, vous pouvez télécharger et installer le plugin directement depuis l’interface d'administration de Prestashop. Suivez ces étapes pour le faire facilement.
- Télécharger le zip du module ensuite le dézipper
- Allez sur l'onglet "Modules" du backoffice de votre boutique (à gauche de l'écran) > "Catalogue du module"
- Ciquez sur « Installer un module »
- Télécharger le fichier zip du module (en le glissant dans la zone correspondante).
- Cliquez sur le bouton « Configurer » pour commencer le paramétrage.
Cette page de configuration vous permet de configurer les paramètres génériques de la boutique, notamment si celle-ci est “multiboutique”.
| Info |
|---|
En multiboutique, pensez à vous positionner sur la boutique dont vous avez besoin de faire un paramétrage spécifique. |
Installation via FTP/SSH
Si vous préférez une méthode manuelle ou si vous avez des restrictions sur l'interface WordPress, vous pouvez installer le plugin via FTP ou SSH en suivant ces étapes.
- Téléchargez le fichier ZIP du plugin et décompressez-le sur votre ordinateur.
- Connectez-vous à votre serveur via FTP ou SSH.
- Allez dans le répertoire « wp-content/plugins »de votre installation WordPress.
- Créez un dossier nommé « axepta-bnp-paribas »
- Copiez tout le contenu du plugin dézippé dans ce dossier.
- Allez dans l'interface WordPress, sous Extensions > Extensions installées, puis activez le plugin.
Mise à jour de version
Avant toute installation, nous vous invitons à bien désinstaller l’extension actuelle, à vider le cache de votre CMS et vérifier la suppression de l’extension en veillant à supprimer le répertoire d’installation du module sur votre serveur FTP.
Une fois fait, vous pouvez Installer la dernière mise à jour.
| Info |
|---|
La version la plus récente du module est disponible dans notre GitHub: GitHub - AxeptaBNPParibas/AxeptaOnline-Prestashop-plugin: Axepta Online plugin for Prestashop · GitHub Celui-ci est mis à jours régulièrement. Pensez par la suite à compléter les paramètres de configuration Axepta Online dans chaque onglet du module. Il vous faudra configurer à nouveau votre MID de production, votre clé d’activation de production disponible sur votre portail marchand BNP Paribas. |
Back Office
Configuration globale du module
Les fonctionnalités du module sont accessibles via le menu de gauche dans l'interface d'administration « Personnaliser». Pour débuter la configuration, cliquez simplement sur l'option « Axepta BNP Paribas ».
La page de paramétrage fait apparaître plusieurs boutons sur le haut.
- Contactez l’assistance : Permet l'ouverture d’un formulaire d'envoi d'e-mail vers notre assistance. Dans cet e-mail, les versions serveur, CMS et module sont automatiquement envoyées.
- Documentation Axepta BNP Paribas : Renvois vers la documentation officielle du module Axepta Prestashop.
- Vérifiez votre configuration : Permet d’afficher et de vérifier dans une fenêtre que l'environnement du site est compatible avec le module installé.
- Téléchargez le fichier LOG : Permet de télécharger le fichier des logs liés à l’utilisation du module.
Configuration du compte
La configuration du mode production et nécessaire afin de commencer à encaisser des paiements sur votre boutique
En mode Production, il est nécessaire de renseigner le MID et la clé privée disponible sur votre portail marchand BNP Paribas.
Mode Production :
- MID (disponible dans la rubrique clé de votre portail marchand BNP Paribas)
- Clé privée (disponible dans la rubrique clé de votre portail marchand BNP Paribas)
| Warning |
|---|
Attention au moment de récupérer la clé de production sur votre portail marchand BNP Paribas, seulement la clé de votre marchand ID de production (''MID"_XXX) est a paramétrer. |
Mode Démonstration :
Un MID spécifique est déjà pré paramétré, aucune configuration n'est nécessaire.
Le mode démonstration ("DEMO") permet de tester le module et ses fonctionnalités, avant d'avoir contractualisé.
Mode Test
- MID de test (disponible dans la rubrique clé de votre portail marchand BNP Paribas)
- Clé privée de test (disponible dans la rubrique clé de votre portail marchand BNP Paribas)
Permet de configurer votre MID de test dédié, il est reconnaissable par le format (BNP_MID_t) disponible depuis votre portail marchand BNP Paribas.
Activation en front :
Il est nécessaire d'activer le module pour afficher les méthodes de paiement sur la page de checkout
| Warning |
|---|
Les éléments ne sont sauvegardés que lorsque l’utilisateur clique sur le bouton Un bandeau vert apparaît
Dans la cas contraire, le message d’erreur suivant apparaît en rouge
|
Configuration du paiement
Vous pouvez maintenant choisir les différents moyens de paiement à activer sur votre boutique.
L'onglet configuration du paiement vous permet de configurer plusieurs fonctionnalités
Organisation des moyens de paiement
Il s’agit de la méthode d’affichage des paiements décidé Un bloc “Configuration du paiement” permet de paramétrer l’affichage des moyens de paiement sur la page de checkout ainsi
Tous les moyens de paiement intégrés à la librairie sont présentés ici. Il appartient au marchand de sélectionner les moyens de paiement qui l’a souscrit.
La clé d’activation ne permet plus de définir les moyens de paiement.
- Regroupé : Les bloc de paiement apparaissent. Il est possible de paramétrer les paiement en redirection et en iframe
- HPP : Seule la redirection est possible avec tous les moyen de paiement regroupé en un seul bouton. Affichage d’un bloc complet par de différenciation entre les cartes et les autre méthodes de paiement.
paiement
deux options sont disponible:
- Choix du moyen de paiement sur la page BNP Paribas
Correspond au formulaire de paiement hébergé par BNP Paribas pour en savoir plus: Payment Page Hosted by Axepta BNP Paribas - Documentation Axepta BNP Paribas - Axepta
Avantages clés:
Expérience utilisateur optimisée : Offrez à vos clients une interface de paiement intuitive, sécurisée et réactive
Effort de développement minimal : Proposez plusieurs méthodes de paiement sous une seule implémentation
Conformité des normes : Respectez les réglementations en vigueur grâce à la gestion des données sensibles des clients par Axepta BNP Paribas, réduisant ainsi considérablement vos responsabilités et coûts liés à la conformité PCI-DSS
- Choix des moyens de paiement sur le site du marchand
Mode d'affichage
Le mode redirection : redirige le client vers le formulaire de paiement sécurisée par Axepta.
Le mode iframe: intègre directement la page de checkout sur votre site.
Mode capture
Méthode d’affichageCette option vous permet de choisir la méthode de capture du paiement :
Activation de la capture Automatique :
Automatique (J) => La capture se fera automatiquement à minuit.
Lors de la sélection capture automatique, les flux de paiement sont automatiquement capturés.
Activation de la capture Différée :
Différée (J+x) => Vous pouvez choisir le délai avant la capture (délai en heures : nombre entier compris en 1 et 696. Exemple pour 2 jours: saisissez 48)
Cette option vous permet de choisir la méthode de capture du paiement :
La capture différée est paramétrée avec un nombre d’heure avant la capture à réaliser.
Aucune action n’est nécessaire par le marchand pour réaliser la capture. Elle est confirmée par un flux retour (IPN).
Activation de la capture Manuelle :
Capture Manuelle => La capture manuelle est effectuée manuellement par le marchand grâce à une configuration au niveau du back-office.
Dans le menu de configuration du marchand, descendre jusqu’au champ « Capture » et sélectionner « Manual Capture ».
Pour capturer manuellement une transaction, suivez ces étapes :
- Accédez à « WooCommerce > Transactions » depuis votre tableau de bord WordPress.
- Vous verrez alors la liste des transactions effectuées.
- Lorsque vous survolez une ligne correspondant à une transaction qui n’a pas encore été capturée, un bouton "Capture" en bleu apparaîtra en dessous de cette ligne.
- Cliquez sur ce bouton pour effectuer la capture du paiement.
Une fois la capture effectuée, le statut de la transaction sera mis à jour pour refléter l’action.
Notifications de capture manuelle
Des notifications sont affichées lors de la tentative de capture manuelle d’un paiement, afin de vous tenir informé du statut de l’opération :
- Capture réussie : Une notification vous informe que la capture a été réalisée avec succès.
- Capture déjà effectuée : Si la transaction a déjà été capturée, une alerte vous indique que la capture ne peut pas être rééditée.
- Capture échouée : En cas d’échec de la capture, une notification détaillée explique la raison du problème et vous guide sur les étapes à suivre.
Ces notifications vous permettent de suivre précisément l’état de chaque transaction et d’agir en conséquence.
| Warning |
|---|
Attention : Sans action du commerçant, la transaction ne sera pas remise en banque. La capture d’une transaction au-delà du 7ème jour entraîne la perte de garantie associée au 3DSecure. Au-delà du 29ème jour l’autorisation accordée par l’émetteur ne sera plus valide. Il est donc préférable de capturer les opérations avant ces échéances. |
Exemption 3DS
Correspond au paramétrage du 3DS (méthode d'authentification du paiement) et de son exemption en fonction du montant total du panier du client.
| Warning |
|---|
En activant la demande d'exemption 3D Secure, vous acceptez la responsabilité en cas de fraude ou de litige sur les transactions concernées. Cette fonctionnalité doit être utilisée avec précaution. Vous retrouverez les différentes responsabilités en cas d'impayé sur notre page dédié: Liability Shift and 3D-Secure Matrices - Documentation Axepta BNP Paribas - Axepta |
Activation du One click
l'activation de cette fonctionnalité permet aux clients connectés d'enregistrer leur carte pour les prochains paiements.
Pour cela le client devra au préalable cocher l'enregistrement de sa carte sur la page de paiement.
Méthode de capture
Cette option vous permet de choisir la méthode de capture du paiement :
- Automatique (J) => La capture se fera automatiquement à minuit.
- Différée (J+x) => Vous pouvez choisir le délai avant la capture (délai en heures : nombre entier compris en 1 et 696. Exemple pour 2 jours: saisissez 48)
- Capture Manuelle => La capture manuelle est effectuée manuellement par le marchand grâce à une configuration au niveau du back-office.
Activation de la capture Automatique :
Lors de la sélection capture automatique, les flux de paiement sont automatiquement
Activation de la capture Différée :
La capture différée est paramétrée avec un nombre d’heure avant la capture à réaliser. Le maximum possible est 696 heures.
| Info |
|---|
NB : Aucune action n’est nécessaire par le marchand pour réalisée la capture. Elle est confirmée par un flux retour (IPN) |
Activation de la capture Manuelle :
Dans le menu de configuration du marchand, descendre jusqu’au champ « Capture » et sélectionner « Manual Capture ».
| Warning |
|---|
Attention : Sans action du commerçant, la transaction ne sera pas remise en banque. La capture d’une transaction au-delà du 7ème jour entraîne la perte de garantie associée au 3DSecure. Au-delà du 29ème jour l’autorisation accordée par l’émetteur ne sera plus valide. Il est donc préférable de capturer les opérations avant ces échéances. |
Méthodes de paiement
Ce bloc permet l’activation des différents moyens de paiement par carte ou Wallet :
Sélectionner les moyens de paiement à afficher en checkout.
Si CB- Visa-MasterCard est activé, le logo CB apparaîtra seulement si le pays de livraison de la commande est la France
Les paramètres Apple Pay et Google Pay permettent d’afficher les logo sur la page de checkout mais nécessitent d’avoir souscrit l’option sur le contrat pour voir l’affichage en page de paiement.
Paypal est un Wallet qui doit être paramétré en amont sur votre compte Axepta. Il est nécessaire de communiquer le PayerID de Paypal à Axepta en amont.
Les moyens de paiement Abonnement et Abonnement AMEX sont disponibles lorsque le panier contient un produit associé à un abonnement, et s’affichent alors sur la page de paiement
Personnalisation
Permet le paramétrage des champs envoyés dans le formulaire de paiement lors de la redirection.
Les codes ISO à ignorer représentent les code ISO pays si vous avez modifié le paramétrage de vos pays pour les transporteurs. Ex : FR n’est pas à envoyer car en Europe. US est à envoyer.
Création des produits en abonnement
Dans Prestashop > Catalogue > Produits, ouvrez le produit à vendre en abonnement (ou créez-en un nouveau).
Dans l’onglet Modules > Axepta BNP Paribas, cliquez sur le bouton « Configurer »
Activer un abonnement sur le produit en renseignant les différents champs utiles à la configuration d’un abonnement :
Activer l’abonnement pour ce produit : cocher la case qui permettra de déterminer votre produit comme un produit par abonnement.
Intervalle de périodicité de l’abonnement : déterminer le nombre sur l’intervalle (ex : 1,2,3 …)
Fréquences : Jour(s) / Mois
Exemple :
- 1 + Mois → facturation tous les mois
- 15 + Jours → facturation tous les 15 jours
Durée (nombre d’occurrences)
- Nombre d’occurrences = nombre de fois où le client sera facturé.
- Exemple : 3 → 3 paiements au total (selon la périodicité choisie)
Montant
- Prix de l’abonnement (avant taxe) : montant facturé à chaque période
Enregistrez / mettez à jour le produit.
Tableau des commandes
Des états de commandes ont été ajoutés pour vous permettre de visualiser les paiements en test, en démo ou en production
Notez bien que les paiement fait en démo nécessite d’être en mode Démo pour être visibles ;
Capture manuelle
Capturer Manuellement la transaction
Pour capturer manuellement un paiement, il faut aller dans la liste des transactions et de cliquer sur l’icone de capture dans la colonne action
Logs
Les logs sont constamment activés. Il est possible de les télécharger par le bouton en haut de l’écran de paramétrage
Remboursement / Annulation
Pour rembourser une transaction, vous devez ,dans un premier temps, choisir la boutique dans laquelle la commande a eu lieu (en haut à droite de l'écran); Un remboursement ne peut être effectué que sur une boutique unique.
Rendez vous ensuite sur la commande du client dans le détail de la transaction (comme indiqué précédemment) et cliquez sur “Remboursement partiel” dans l'onglet "commande" pour créer un bon d’achat:
Vous serez redirigés vers l'onglet "produit" de la même page.
- Choisissez le montant à rembourser (total ou partiel). Le montant ne peut pas être supérieur au montant total et la quantité ne doit pas dépasser la quantité indiquée également.
- Enfin, cliquez sur “Remboursement partiel” :
- Une fois le montant enregistré, toujours sur le détail de la commande, vous devez aller à nouveau sur le détail du produit :
- - Sélectionnez la transaction qui doit être remboursée
- - Sélectionnez un bon d’achat
- - Cliquez sur “Rembourser”
- Vous pouvez renseigner un montant partiel si nécessaire.
- Le produit apparaît désormais sur le détail de la commande comme “remboursé” :
Remboursement total
Il est possible de faire plusieurs remboursements partiels. Cependant, la somme des remboursements partiels ne peut dépasser le montant total de la commande.
Annulation
Si la transaction n'a pas encore été remise en banque (capturée), une annulation est possible.
Liste des transactions
Toutes les transactions réalisées avec le modules Prestashop Axepta BNP Paribas 2.0 sont regroupées dans un tableau présent
| Info |
|---|
NB : La désinstallation et la réinstallation du module provoque la purge de es transactions. |
Tableau des abonnements
Dans l’onglet Axepta BNP Paribas > Abonnements : retrouver la liste des abonnements :
- ID de l’abonnement
- Le produit Abonnement
- La commande
- Le client
- Le montant
- Le statut de l’abonnement
- La périodicité
- La date de début
- La date de la prochaine exécution.
Vous avez la possibilité de modifier le statut de l’abonnement pour l’activer ou l’arrêter.
Arrêter un abonnement
Action : Arrêter un abonnement
Effet :
- L’abonnement passe en arrêté (il n’y aura plus de renouvellement automatique).
- Le client ne sera plus facturé à partir de ce moment.
Font Office
Rendu sur la page de checkout
Les moyens de paiement sont affichés sur un cadre prévu par bloc.
Les moyens de paiement supplémentaires sont accessibles en sélectionnant "Plus d'options de paiement", qui n’apparaît que le cas échéant
Rendu de la page de paiement en redirection
| Info |
|---|
Note : En mode démonstration, un bandeau Orange apparaît avec la mention "DEMO" |
Espace client
Les commandes et les abonnements affichent un bloc Axepta sur l’espace client.
Installation d'un cron pour prestashop
Afin d’automatiser l’exécution de certaines tâches (comme le déclenchement des paiements d’abonnements), il est nécessaire de configurer une tâche planifiée (cron) sur votre serveur.
- Accéder à la configuration du cron
Sur un serveur Linux, ouvrez le terminal et exécutez la commande suivante :
crontab -e
Cette commande permet d’éditer la liste des tâches planifiées de l’utilisateur courant.
- Ajouter la tâche cron
Ajoutez la ligne suivante dans le fichier :
* * * * * php [PRESTASHOP_MODULE_PATH]/axepta2/run.php action=triggerSubscriptionPayment
- Remplacez [PRESTASHOP_MODULE_PATH] par le chemin complet vers votre installation PrestaShop.
- Cette commande exécute le script permettant de déclencher les paiements des abonnements.
- Définir la périodicité
Les cinq astérisques (* * * * *) définissent la fréquence d’exécution :
* * * * * → chaque minute
Vous pouvez adapter cette fréquence selon vos besoins (par exemple toutes les heures, tous les jours, etc.).
Pour vous aider à générer une expression cron adaptée, vous pouvez utiliser l’outil en ligne suivant :👉 https://crontab.guru/