Sommaire

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. 

Prérequis nécessaires

Vous devez disposer d'une installation Prestashop pleinement fonctionnelle.

Installation du module

Installation via l'interface Prestashop

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.

1. Téléchargez le fichier ZIP du plugin et décompressez-le sur votre ordinateur.
2. Connectez-vous à votre serveur via FTP ou SSH.
3. Allez dans le répertoire« wp"wp-content/plugins »plugins" de votre installation WordPress.
4. Créez un dossier nommé « axepta"axepta-bnp-paribas »paribas"
5. Copiez tout le contenu du plugin dézippé dans ce dossier.
6. 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.

Back Office

Configuration globale du module 

Les fonctionnalités du module sont accessibles via le menu de gauche dans l'interface d'administration « Personnaliser» "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.

Image Added

• 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é.

• Contacter 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.

Image Removed

• Télécharger Téléchargez le fichier LOG : Permet de télécharger le fichier des logs liés à l’utilisation du module.

Configuration du compte

Image Added

Mode Démonstration :

Le mode démonstration ("DEMODemo") permet de tester le module sans paramétrage d’un MID

En mode Production, il est nécessaire de renseigner le MID et la clé privée.

Sélectionnez le mode que vous souhaitez paramétrer pour voir apparaître les champs adéquats

Pour pouvoir utiliser le module il est nécessaire de renseigner les paramètres suivants dans le formulaire

1. Mode production :
   • MID (envoyé par BNP Paribas)
   • Clé privée (envoyée par BNP Paribas)
     Elle n’est jamais affiché pour des raisons de sécurité
2. Mode test :
   Le MID de production est utilisé par défaut avec l’ajout d’une chaine de caractère
   • Clé privée (envoyée par BNP Paribas)
     Elle n’est jamais affiché pour des raisons de sécurité
3. Mode Démonstration
   Ce mode permet l’affichage de bandeau sur le site pour informer
   Un MID spécifique est pré paramétré
4. Activation en front
   Nécessaire pour afficher le module sur la page de checkout quelque soit le mode activé

Image Removed

et ses fonctionnalités sans avoir de compte Axepta BNP Paribas.

Image Added

Mode test

• MID de test (disponible dans la rubrique "Voir les identifiants de l'API" de votre portail Marchand Axepta BNP Paribas) 
• Clé API REST de test (disponible dans la rubrique "Voir les identifiants de l'API" de votre portail Marchand Axepta 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.

Accès aux identifiants de l’API & HMAC - Documentation Axepta BNP Paribas - Axepta

Image Added

Mode production :

• MID (disponible dans la rubrique "Voir les identifiants de l'API" de votre portail Marchand Axepta BNP Paribas) 
• Clé API REST (disponible dans la rubrique "Voir les identifiants de l'API" de votre portail Marchand Axepta BNP Paribas) 

Permet de configurer votre MID de production dédié, il est reconnaissable par le format (BNP_MID_XXX) disponible depuis votre portail marchand BNP Paribas.

Accès aux identifiants de l’API & HMAC - Documentation Axepta BNP Paribas - Axepta

Image Added

Activation en front :
Il est nécessaire d'activer le module pour afficher les méthodes de paiement sur la page de checkout

Les éléments ne sont sauvegardé

que lorsque l’utilisateur clique sur le bouton

de sauvegarde.

Image Added Un bandeau vert apparaît

si c’est correctement enregistré

Image Modified Dans la cas contraire, le message d’erreur suivant apparaît en rouge

Image Removed

Image Added

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 

Image Added

 Organisation des moyens de paiement 

Il s'agit de la méthode d'affichage des Un bloc  “Configuration du paiement” permet de paramétrer l’affichage des moyens de paiement sur la page de checkout ainsi

Image Removed

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.

Méthode de capture

Image Added

Activation de la capture Manuelle

Capture Manuelle:

Cette option vous permet de choisir la méthode de capture du paiement :

Activation de la capture Automatique :

Lors de la sélection capture automatique, les flux de paiement sont automatiquement

Image Added

Pour capturer manuellement une transaction, suivez ces étapes :

1. Accédez à "Personnaliser" > "Axepta BNP Paribas" >"Transaction".
2. Vous verrez alors la liste des transactions effectuées.
3. Lorsque vous survolez une ligne correspondant à une transaction qui n’a pas encore été capturée, une icone "Capture" apparaîtra dans la colonne Action.

Image Added

      4. Cliquez sur ce bouton pour effectuer la capture du paiement.

Image Added

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.

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.

Activation de la capture Manuelle :

Dans le menu de configuration du marchand, descendre jusqu’au champ « Capture » et sélectionner « Manual Capture ».

Image Removed

Méthodes de paiement

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.

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.

Image Added

Méthodes de paiement

Vous pouvez activer ou de désactiver les méthodes de paiement souscrites dans l'onglet ''méthodes de paiement''.

Image Added

Image Removed

Ce bloc permet l’activation des différents moyens de paiement par carte ou Wallet :

Personnalisation

Personnalisation

Configuration de la fonctionnalité abonnement 

installation du cron sur 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.

1) 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

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

3) 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/

Création de la fiche produit abonnement dans Prestashop 

Dans Prestashop > "Catalogue" > "Produits"

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.

Périodicité de facturation

Intervalle de périodicité de l’abonnement l’abonnement : déterminer le nombre sur l’intervalle (ex : 1,2,3 …)

Fréquences 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

Image Removed

Notez bien que les  paiement fait en démo nécessite d’être en mode Démo pour être visibles ;

Capture manuelle

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:

Image Removed

Vous serez redirigés vers l'onglet "produit" de la même page.

1. 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.
2. Enfin, cliquez sur “Remboursement partiel” :
3. Une fois le montant enregistré, toujours sur le détail de la commande, vous devez aller à nouveau sur le détail du produit :
4. - Sélectionnez la transaction qui doit être remboursée
5. - Sélectionnez un bon d’achat
6. - Cliquez sur “Rembourser”
7. Vous pouvez renseigner un montant partiel si nécessaire.
8. 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

Gérer ses abonnements en cours

Image Added

Dans l’onglet "Axepta BNP Paribas" > "Abonnements" retrouvez la liste des abonnements :

Tableau des abonnements

Dans l’onglet Axepta BNP Paribas > Abonnements : retrouver la liste des abonnements :

Image Removed

• 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ébutla dernière échéance
• La date de la prochaine exécution.échéance

 Sur chaque ligne d’abonnement, un menu "Action" permet d’effectuer des opérations de gestion.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é en arrêté (il n’y aura plus de renouvellement automatique).
• Le client ne client ne sera plus facturé à facturé à partir de ce moment.

Font Office

Rendu sur la page de checkout

Image Removed

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

Image Removed

Rembourser une échéance uniquement 

Action : Rembourser une transaction sans casser la chaîne des abonnements

Effet :

• Vous remboursez la dernière transaction (un paiement) liée à l’abonnement,
• sans arrêter l’abonnement : les prochains renouvellements restent planifiés et continueront.

Configuration du paiement en plusieurs fois 

Image Added

Montant minimal pour les versements échelonnés:  Désigne le montant minimum du total du panier ou la modalité de paiement en plusieurs fois sera proposé.

Montant maximal pour les versements échelonnés: Désigne le montant maximum du total du panier ou la modalité de paiement en plusieurs fois sera proposé.

Répartition par échéance: Désigne le pourcentage de répartition par rapport au montant total du panier sur chacune des échéances,

Exemple d'un paiement en 3X d'un montant total de 100€:

• 1er 50% => donc 50€
• 2e 25% => donc 25€
• 3e 25%=> donc 25€

Remboursement / Annulation

Remboursement 

Allez sur "Vendre"> "Commandes" > Cliquez sur la commande en question. 

Image Added

Cliquez sur "Remboursement partiel" dans l'onglet "commande". 

Image Added

Renseignez la quantité d'unité produit à rembourser,  cela mettra à jours le montant du remboursement par le montant du/des produit(s) en question.

Image Added

Cliquez sur Image Addedune fois fais, répétez l'action plus bas dans l'onglet Axepta Bnp Paribas.

Image Added

Dans ''Transaction'' > sélectionnezl'avoir de la commande ainsi généré.

Dans ''Avoir de la commande'' sélectionnez le montant de l'avoir ainsi généré.

Cliquez sur "Rembourser".

Le produit apparaît désormais sur le détail de la commande comme "remboursé".

Image Added

Annulation

Si la transaction n'a pas encore été remise en banque (capturée), une annulation est possible.

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.

1. 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.

1. 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.

1. 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/