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

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.

Veillez a ce que votre site utilise un certificat SSL afin de garantir la sécurité des paiements et que vous disposez d'un acces FTP ou SSH à votre serveur.

un site WordPress et d'un module Woocommerce pleinement fonctionnel.

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.

1. Téléchargez le fichier ZIP du plugin.
2. Allez dans le tableau de bord WordPress, sous Extensions Image Added> Ajouter Image Added.
3. Cliquez sur Téléverser une extension Image Added, puis sélectionnez le fichier ZIP du plugin.
4. Cliquez sur Installer maintenant Image Added, 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"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 Image Added>Image Added, puis activez le plugin.

Mise à jour

Avant toute installation

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

Image Added

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

Image Added

• Téléchargez le fichier LOG: Permet le téléchargement des logs logs au format souhaité. 

Image Added

Configuration du compte

Image Added

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 disponible sur votre Portail marchand BNP Paribas.

Mode production :

• MID (envoyé par BNP Paribas)
• Clé privée ( disponible dans la ribrique clé de votre portail marchand BNParibas)

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 déja pré paramétré, aucune configuration est nécessaire.

Image Removed

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

Image Added

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

Image Added

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

Image Added

Activation en front :

l'activation de cette fonctionnalité est nécessaire pour afficher les méthodes de paiement sur la page de checkout.Activation en front :
Nécessaire pour afficher le module sur la page de checkout quel que soit le mode activé

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.

Image Added

Configuration du paiement 

L'onglet configuration du paiement vous permet de configurer plusieurs fonctionnalités fonctionnalités.

Organisation des moyens de paiement 

Il s’agit s'agit de la méthode d’affichage des paiements décidé d'affichage des paiement sur la page de paiementcheckout.

deux options sont disponible: 

• Choix du moyen de paiement sur la page BNP Paribas

Les blocs graphiques des différentes Correspond au formulaire de paiement hébergé par BNP Paribas vous y retrouverez les méthodes de paiement apparaissent.disponible sur votre compte.

Image Added

• Choix des moyens de paiement sur le site du marchand

Correspond a la configuration de la fonctionnalité HPP (Hosted Payment Page) :  tous les moyens de paiement regroupés en un seul bloc. 

Affichage est construit en un bloc complet, pas de différenciation entre les cartes et les autres méthodes de paiement.

Mode d'affichage 

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

Mode capture 

Image Added

Image Added

Image Added

Mode Capture 

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

Image Added

Activation de la capture Automatique

Automatique (J)

=>

: La capture se fera automatiquement à minuit.

Image Added

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

Image Added

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. 

Image Removed

Activation de la capture Automatique :

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

Image Removed

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.

Image Removed

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

Image Removed

Image Added

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.

Image Added

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

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.

Image Modified

Méthodes de paiement 

Tous les moyens de paiement intégrés à la librairie sont présentés ici. Il appartient au marchand d'activer ou de sélectionner désactiver les moyens méthodes de paiement qu’il a souscritsouscrites.

Personnalisation 

Configuration de la fonctionnalité

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

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

Image Modified

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)

Configuration du paiement en plusieurs fois 

Tableau des commandes

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€

Capture manuelle

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.

Image Removed

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.

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 » remboursement" ainsi que le « motif du remboursement » qui "motif du remboursement" qui est facultatif.
5. Après avoir rempli les champs, cliquez sur « Remboursement "Remboursement X.XX € avec Axepta BNP Paribas »Paribas" pour procéder au remboursement du montant.
6. 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.