Sommaire
| Table of Contents |
|---|
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 guide pas à pas 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. Ce
| Info |
|---|
Le module est accessible gratuitement à l'adresse suivante : GitHub - AxeptaBNPParibas/AxeptaOnline-WooCommerce-plugin: Axepta Online plugin for WooCommerce / WordPress · GitHub |
https://github.com/AxeptaBNPParibasNotre objectif est de vous accompagner pour que la mise en place de notre solution AXEPTA BNP Paribas soit rapide, intuitive, et pleinement fonctionnelle dans votre environnement WooCommerce.
Prérequis nécessaires
Vous devez disposer d'une installation WordPress pleinement fonctionnelle. un site WordPress et d'un module Woocommerce pleinement fonctionnel.
| Tip |
|---|
Assurez- vous |
de votre compatibilité de version Woocommerce & PHP avec le module Axepta Online Vous trouverez les versions compatible ici : GitHub - AxeptaBNPParibas/AxeptaOnline-WooCommerce-plugin: Axepta Online plugin for WooCommerce / WordPress · GitHub |
Installation du module
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.
- Téléchargez le fichier ZIP du plugin.
- Allez dans le tableau de bord WordPress, sous Extensions
> Ajouter 
. - Cliquez sur Téléverser une extension
, puis sélectionnez le fichier ZIP du plugin. - 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.
- 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"wp-content/plugins »plugins"de votre installation WordPress.
- Créez un dossier nommé « axepta"axepta-bnp-paribas »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
du moduleDésinstaller totalement le module Axepta BNP Paribasde version
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 etCMS 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
que vous avez téléchargé.
| Info |
|---|
N.B. : La librairie est automatiquement mise à jour avec la mise à jour de plugin |
Back Office
La version la plus récente du module est disponible dans notre GitHub: GitHub - AxeptaBNPParibas/AxeptaOnline-WooCommerce-plugin: Axepta Online plugin for WooCommerce / WordPress · 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 « WooCommerce > Réglages » "WooCommerce"> "Réglages" . Pour débuter la configuration, cliquez simplement sur l'option « Axepta BNP Paribas »option "Axepta BNP Paribas".
La page de paramétrage fait apparaître plusieurs boutons sur le haut.
- Documentation Axepta BNP Paribas : lors du clic, l’utilisateur est renvoyé vers la documentation officielle hébergée par BNP Paribas Renvois vers notre documentation officielle du module.
- Testez ma configuration : Permet de vérifier que l'environnement du site est compatible avec le module installé.
- Contactez l’assistance : Permet l'ouverture d’un formulaire d'envoi d'e-mail vers notre assistance. Dans cet e-mail, 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 envoyées automatiquement envoyées
- Tester la configuration : Permet d’afficher et de vérifier dans une fenêtre que la configuration du serveur est compatible avec le module installé.
- .
- Téléchargez le fichier LOG: Permet le téléchargement des logs au format souhaité.
Configuration du compte
La configuration du mode production et du mode test sont à faire pour activer le paiement en ligne.
Mode Démonstration
Le mode démonstration ("DEMO") permet de tester le module sans paramétrage d’un MID (ID du marchant, fournit par BNP Paribas lors de l’inscription)
En mode Production, il est nécessaire de renseigner le MID et la clé privée.
En mode test, il est nécessaire de renseigner uniquement la clé privée. On utilise le MID de production auquel il a été ajouté un paramètre (_t)
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
Mode production :
- MID (envoyé par BNP Paribas)
- Clé privée (envoyée par BNP Paribas)
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)
Mode Démonstration :
Ce mode permet l’affichage de bandeau sur le site pour informer que ce mode est actif.
Un MID spécifique est pré paramétré.
Activation en front :
Nécessaire pour afficher le module sur la page de checkout quel que soit le mode activé
Afficher le logo ApplePay :
ApplePay est actuellement embarqué par la page de paiement. Cette option ne fait qu’apparaître le logo avec les moyens de paiement.
et ses fonctionnalités sans avoir de compte Axepta BNP Paribas.
Mode Test
- Le MID de test est disponible dans la rubrique "Voir les identifiants de l'API" de votre portail Marchand Axepta BNP Paribas.
- La clé API REST de test est 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
Mode Production
- Le MID de production est disponible dans la rubrique "Voir les identifiants de l'API" de votre portail Marchand Axepta BNP Paribas.
- La clé API REST est 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
Activation en front :
l'activation de cette fonctionnalité est nécessaire 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 |
Configuration des moyens de paiement
Vous pouvez maintenant choisir les différents moyens de paiement à activer sur votre boutique.
Un onglet « Configuration des moyens de paiement » apparaît juste en dessous de « Configuration du compte ». Cliquez dessus pour ouvrir la section et configurer vos moyens 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.
La clé d’activation ne permet plus de définir les moyens de paiement.
Organisation des paiements :
Il s’agit de l’affichage des paiements qui a été décidé sur le checkout
- Regroupé : Les bloc de paiement apparaissent. Il est possible de paramétrer les paiements en redirection et en iframe
- HPP (Hosted Payment Page) : Seule la redirection est possible avec tous les moyens de paiement regroupés en un seul bouton. Affichage d’un bloc complet, pas de différenciation entre les cartes et les autres méthodes de paiement.
Méthode d’affichage :
- Redirection : lors de la phase de paiement, l’utilisateur est renvoyé vers une page en fonction du moyen de paiement sélectionné
- Iframe : lors de la phase de paiement, le formulaire est affiché en bas de la page de checkout en fonction du moyen de paiement sélectionné
Label :
Texte à afficher sur le bloc
Liste des moyens de paiement :
Sélectionner les moyens de paiement à afficher en checkout.
| Info |
|---|
Note : Si CB- Visa-MasterCard est activé, le logo CB apparaîtra seulement si le pays de livraison de la commande est la France |
Personnalisation des moyens de paiement :
Permet le paramétrage des champs envoyés dans le formulaire de paiement lors de la redirection.
|
Paramétrage SMTP
Activation de la fonctionnalité SMTP (Simple Mail Transfer Protocol") utilisé pour envoyer des e-mails depuis un server.
Une fois activé un nouvel onglet ''Configuration des fonctionnalités'' est alors disponible.
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 paiement sur la page de checkout.
deux options sont disponible:
- Choix du moyen de paiement sur la page BNP Paribas
Correspond au formulaire de paiement hébergé par BNP Paribas vous y retrouverez les méthodes de paiement disponible sur votre compte.
- Choix des moyens de paiement sur le site du marchand
Mode Capture
Configuration des types de capture
Cette 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.
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).
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.
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 :
- 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.
| Tip |
|---|
Dans l'onglet ''Commandes'' une colonne "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é.
|
| 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. |
Configuration de la fonctionnalité abonnement sur Axepta
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éthodes de paiement
Il appartient au marchand d'activer ou de désactiver les méthodes de paiement souscrites.
| Info |
|---|
Si CB-Visa-MasterCard est activé, le logo CB apparaîtra seulement si le pays de livraison de la commande est français. |
Personnalisation
Permet le paramétrage des champs envoyés dans le formulaire de paiement lors de la redirection.
Configuration de la fonctionnalité abonnement
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".
| Warning |
|---|
Afin de configurer |
Pour activer le paiement par abonnement, veuillez allez dans Méthodes de paiement
Dans la section Abonnements, activez Paiement par abonnement
| Warning |
|---|
Attention : l’abonnement ne fonctionnera que si la boutique est correctement configurée pour exécuter les renouvellements automatiques (CRON). Si vous ne l’avez pas, contactez votre intégrateur / support. |
les paramètres généraux des abonnements, tels que les cycles de facturation, les périodes d'essai, et les options de renouvellement vous devez avoir créé au préalable une fiche produit abonnement. |
Création
de lad'une fiche produit abonnement
dans woocommerceDans WooCommerce → "WooCommerce" > "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)
Astuce : si vous voulez vérifier rapidement qu’un abonnement “tourne”, contrôlez la Prochaine exécution (elle doit être dans le futur).
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
transactioné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.
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é.
De plus, 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é.
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€
| Warning |
|---|
La répartition est paramétrable en pourcentage et non en montant |
Capture manuelle
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.
Remboursement / Annulation
Remboursement
- Allez dans "WooCommerce" > "Commandes" et cliquez sur la commande que vous souhaitez rembourser.
- Sur la page de la commande, vous trouverez les informations relatives à cette dernière.
- Vous verrez un bouton "Remboursement". Cliquez dessus pour ouvrir la section de remboursement.
- Une fois la section ouverte, vous pourrez saisir le « « "montant du remboursement » remboursement" ainsi que le « motif du remboursement » qui "motif du remboursement" qui est facultatif.
- Après avoir rempli les champs, cliquez sur « Remboursement "Remboursement X.XX € avec Axepta BNP Paribas »Paribas" pour procéder au remboursement du montant.
- 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 effectuer un remboursement total:
- Cliquez sur
, - Sélectionnez la quantité totale de produits du panier initial ou rentrez manuellement le montant total à rembourser dans "Montant du remboursement".
- Cliquez sur "Remboursement via Axepta BNP Paribas", pour mettre à jours le back office Axepta.
Remboursement partiel
Pour rembourser partiellement une transaction:
- Cliquez sur ,
- Sélectionnez la quantité du produit que vous souhaitez remboursé dans le listing du panier, ou rentrez manuellement le montant à rembourser dans "Montant du remboursement".
- Cliquez sur "Remboursement via Axepta BNP Paribas", pour mettre à jours le back office Axepta.
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 » "Woocommerce" > "Transactions".
Annulation
Pour annuler une commande dont le paiement n'a pas encore été capturé, suivez ces étapes :
- Allez dans "WooCommerce" > "Transactions".
- 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.
- 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 "WooCommerce" > "État" > Journaux »"Journaux" puis sélectionnez le log « axepta"axepta-bnpp »bnpp". Sur la page suivante, vous pourrez visualiser les logs et les télécharger en cliquant sur le bouton « Télécharger » "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.