Sommaire

Introduction

Bienvenue dans la documentation du module AXEPTA BNP Paribas pour WooCommerce.

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 WordPress pleinement fonctionnelle.

Installation du module Woocommerce

 Installation via l'interface WordPress

Pour une installation rapide et simple, vous pouvez télécharger et installer le plugin directement depuis l’interface d'administration de WordPress. Suivez ces étapes pour le faire facilement.

1. Téléchargez le fichier ZIP du plugin.
2. Allez dans le tableau de bord WordPress, sous Extensions > Ajouter.
3. Cliquez sur Téléverser une extension, puis sélectionnez le fichier ZIP du plugin.
4. Cliquez sur Installer maintenant, puis activez le plugin après l'installation.

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-content/plugins » de votre installation WordPress.
4. Créez un dossier nommé « axepta-bnp-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 

1. Désinstaller totalement le module Axepta BNP Paribas
2. Avant toute installation de la nouvelle version de votre module, 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.
3. Installer la dernière mise à jour que vous avez téléchargé

Back Office

Configuration globale du module

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

• Documentation Axepta BNP Paribas : L’utilisateur est renvoyé vers la documentation officielle du module Axepta Woocommerce.
• Tester la 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 : Ouverture d’un formulaire pour l’envoi d’un mail vers l’assistance. Dans le mail les versions serveur, CMS et module sont automatiquement envoyées.

• Téléchargez le fichier LOG: Permet le téléchargement des logs 

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 (envoyé par BNP Paribas)
• Clé privée ( disponible dans la rubrique clé de votre portail marchand BNParibas)

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

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

Configuration du paiement 

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é sur la page de paiement

deux options sont disponible: 

• Choix du moyen de paiement sur la page BNP Paribas

• Choix des moyens de paiement sur le site du marchand

Mode d'affichage 

le mode redirection est appliqué obligatoirement si ''choix du moyen de paiement sur le site marchand est sélectionné"

Mode 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 capturés.

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.

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 :

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 :

1. Accédez à « WooCommerce > Transactions » depuis votre tableau de bord WordPress.
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, un bouton "Capture" en bleu apparaîtra en dessous de cette ligne.
4. 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 :

1. Capture réussie : Une notification vous informe que la capture a été réalisée avec succès.
2. 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.
3. 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.

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.

Méthodes de paiement 

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 qu’il a souscrit.

Personnalisation 

Configuration de la fonctionnalité abonnement sur Axepta  

Pour activer le paiement par abonnement, veuillez vous diriger dans l'onglet Méthodes de paiement

• Accédez à WooCommerce > Réglages > Méthodes de paiement 

Création de la fiche produit abonnement dans Woocommerce

Dans WooCommerce → onglet "Produit" → "Tous les Produits" . Ouvrez le produit à vendre en abonnement (ou créez-en un nouveau)

Dans le bloc "Options de paramétrage des abonnements", cochez : "Activer l’abonnement pour ce produit"

Une fois activé, vous pouvez définir les éléments suivants  :

Périodicité de facturation

• Intervalle : le nombre (ex : 1, 2, 3…)
• Fréquence : Jours / Semaines / Mois / Années

Exemples :

• 1 + Mois → facturation tous les mois
• 2 + Semaines → facturation toutes les 2 semaines

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.

Gérer ses abonnements en cours

Dans l’onglet WooCommerce → Abonnements, vous retrouvez la liste avec :

• la commande initiale
• le client
• le produit
• la périodicité
• la dernière exécution
• la prochaine exécution
• le statut (ex : Actif)

 Sur chaque ligne d’abonnement, un menu "Action" permet d’effectuer des opérations de gestion.

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.

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 

Libéllé de paiement: texte personnalisable apparaissant sur la page de paiement 

Montant minimum: désigne le montant minimum du total du panier du client ou la modalité de paiement en plusieurs fois sera proposé, 

Montant maximum: désigne le montant maximum du total du panier du client ou la modalité de paiement en plusieurs fois sera proposé,

Répartition des échéances: 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€

Tableau des commandes

Une nouvelle colonne intitulée "Statut de la capture" a été ajoutée à la liste des commandes dans WooCommerce. Cette colonne indique si la transaction de paiement a été capturée ou non. Si la capture n'a pas encore eu lieu, le temps écoulé depuis la demande de capture sera affiché.

Un nouveau statut "Capture paiement en attente" a été ajouté aux statuts des commandes WooCommerce. Ce statut est uniquement attribué aux commandes pour lesquelles la capture du paiement n'a pas encore été effectuée. Il permet de différencier clairement les commandes en attente de capture de celles dont le paiement a déjà été finalisé.

Remboursement / Annulation

Remboursement

1. Allez dans WooCommerce > Commandes et cliquez sur la commande que vous souhaitez rembourser.
2. Sur la page de la commande, vous trouverez les informations relatives à cette dernière.
3. Vous verrez un bouton "Remboursement". Cliquez dessus pour ouvrir la section de remboursement.
4. Une fois la section ouverte, vous pourrez saisir le « montant du remboursement » ainsi que le « motif du remboursement » qui est facultatif.
5. Après avoir rempli les champs, cliquez sur « Remboursement X.XX € avec Axepta BNP Paribas » pour procéder (X.XX est le montant saisi du remboursement) au remboursement. Le remboursement sera effectué si la commande a déjà été capturée.

Remboursement total

Pour un remboursement total, le montant (subtotal) est affiché et il suffit de laisser les valeurs prédéfinies vides et de valider (Refund Offline).

Remboursement partiel

Pour un remboursement partiel, il faut ajuster les valeurs des champs. Le champ "Ajustement Fee" permet de modifier la somme à retirer du remboursement.

Par exemple : Subtotal = 45, Ajustement Fee = 15, en cliquant sur “Update Totals” on obtient 30 comme remboursement pour l’acheteur.

Annulation

Si la transaction n'a pas encore été remise en banque (statut "processing" en cliquant sur l'orderID), une annulation est donc possible via « Woocommerce > Transactions ».

Pour annuler une commande dont le paiement n'a pas encore été capturé, suivez ces étapes :

1. Allez dans WooCommerce > Transactions.
2. Recherchez la transaction associée au numéro de la commande que vous souhaitez annuler, et assurez-vous que la capture du paiement n'a pas encore été effectuée.
3. Une fois la transaction localisée, cliquez sur le bouton "Annulation" pour annuler la commande.

Logs

Les logs sont activés en permanence. Pour les consulter ou les télécharger, allez dans « WooCommerce > État > Journaux » puis sélectionnez le log « axepta-bnpp ». Sur la page suivante, vous pourrez visualiser les logs et les télécharger en cliquant sur le bouton « Télécharger ».

Front 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

Rendu de la page de Confirmation de Paiement

Espace client

Les commandes et les abonnements affichent un bloc Axepta sur l’espace client.