Sommaire 

Introduction

Bienvenue dans la documentation du module AXEPTA BNP Paribas pour Magento 2.

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'un module Magento pleinement fonctionnel.

Installation du module

L'installation du module se déroule de la manière suivante :

• Télécharger le zip du module ensuite le dézipper
• Aller dans le dossier racine de votre site
• Créer les dossiers suivants :
• app/code/Bnpparibas
• app/code/AxeptaBnpparibas/Online
• Copier tout le contenu du module dézippé dans le répertoire “app/code/Bnpparibas/Axepta”
• Retourner à la racine de votre site et lancer les commandes suivantes :
• php bin/magento setup:upgrade
• php bin/magento cache:clean
• php bin/magento cache:flush

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 ''Axepta BNP Paribas''.   Pour débuter la configuration, cliquez simplement sur l'option ''Paramètre des modes de paiement''

• Documentation Axepta BNP Paribas : Renvois vers notre documentation officielle du module.

• 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 envoyées automatiquement.

• Vérifier ma 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écharger les logs: Permet le téléchargement des logs au format souhaité. 

Configuration du compte

Mode Démonstration :

Le mode démonstration ("DEMO") permet de tester le module et ses fonctionnalités sans avoir de compte Axepta BNP Paribas.

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

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

Activation en front :

l'activation de cette fonctionnalité est nécessaire 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

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” apparait sur la gauche de l’écran au dessous de "Configuration du compte" :

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.

1. Organisation des moyens de paiement. Il s’agit de l’affichage des paiements qui a été décidé sur le checkout
   • Choix du moyen de paiement sur le site marchand : Les blocs de paiement apparaissent. Il est possible de paramétrer les paiements en redirection et en Iframe
   • Choix du moyen de paiement sur la page de paiement Axepta Paribas : Seule la redirection est possible avec tous les moyens de paiement regroupé en un seul bouton. Affichage d’un bloc complet par de différenciation entre les cartes et les autres méthodes de paiement.
2. 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é
3. Libellé front : Texte à afficher sur le bloc de paiement
4. Activer le One Click : Oui / Non. Permet aux clients ayant déjà enregistré un moyen de paiement de finaliser leurs achats plus rapidement, sans avoir à ressaisir leurs informations bancaires lors des transactions suivantes.
5. Jetons One click : Un bouton permet de supprimer les jetons de paiement enregistrés pour le One Click, offrant ainsi la possibilité de désactiver ce mode de paiement rapide pour des raisons de sécurité ou de gestion des données.
6. Liste des moyens de paiement.
   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 logos 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.

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

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

Paiement par abonnement 

Permet d’activer ou de désactiver le moyen de paiement par abonnement sur la boutique. Lorsque cette option est activée, les clients pourront choisir ce mode de paiement si leur panier contient un produit configuré en abonnement.

Personnalisation des moyens de paiement

Permet le paramétrage des champs envoyés dans le formulaire de paiement lors de la redirection.

Creation des produits en abonnement 

Dans Magento > Catalogue > Produits, ouvrez le produit à vendre en abonnement (ou créez-en un nouveau).

Dans l’onglet Option de paramétrage des abonnements par Axepta BNP Paribas, vous pouvez activer un abonnement sur le produit en sélectionnant Oui.

Tous les : déterminer le nombre sur l’intervalle (ex : 1,2,3 …)

Périodicité : Jour(s) / Semaine(s) / Mois / Année(s)

Exemple :

• 1 + Mois → facturation tous les mois
• 15 + Jours → facturation tous les 15 jours

Expiré après :

• Nombre d’occurrences = nombre de fois où le client sera facturé.
• Exemple : 3 → 3 paiements au total (selon la périodicité choisie)

Montant

• Montant récurrent : montant facturé à chaque période

Enregistrez / mettez à jour le produit.

Tableau des commandes

Deux colonnes ont été ajoutées dans le tableau de commandes : une pour savoir quel type de capture a été employé pour la commande (automatique, manuelle ou différée), et une autre pour savoir si le paiement a été capturé depuis le back-office de Magento. Une capture réalisée sur le back-office Axepta n’entraîne pas l’actualisation de ce tableau de commande mais une alerte est proposée en cas de tentative sur une transaction déjà capturée (voir notification des alertes).

Les captures différées sont indiquées « Capture : timed » suivi de la date et heure à laquelle la capture a été effectuée

Capture manuelle

Capturer Manuellement la transaction

Pour capturer manuellement un paiement, il faut facturer la commande. Aller sur la page d’une commande à facturer, puis cliquer sur « Invoice ».

Sélectionner ensuite « Capture online » pour capturer manuellement la commande à l’émission de la facture.

Capture online : La capture online effectuée depuis le back-office Magento 2 se connectera au back-office axepta. Le statut de la transaction est synchronisé  automatiquement entre les deux back-office.

Capture offline : La capture Offline va simplement générer la facture et marquer la commande en cours de  traitement, ce qui signifie que le montant a été reçu manuellement.

Capture Partielle :

Il est possible de capturer une partie seulement de la commande si cette dernière comporte plusieurs articles en modifiant les quantités dans la colonne. Dans ce cas, les frais de livraison seront toujours capturés à la première facture. Pour les prochaines captures de paiement de cette même commande, les frais de livraisons ne seront pas comptabilisés.

Messages d'alertes :

Si l’on tente de facturer une commande dont le paiement a déjà été capturé, un message d’alerte « La commande a déjà été capturée » s’affichera en haut de la page comme ceci :

Des notifications ont également été ajoutées quand la capture a déjà été effectuée, ainsi que lorsqu’un paiement n’a pas été capturé depuis plus de 7 jours. L’actualisation se fait une fois par jour.

Ces notifications sont visibles en cliquant sur l’icône en haut à droite de l’écran :

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 effectuer un remboursement ou une annulation (dans la mesure du possible), il faut se diriger vers l'onglet Ventes > Commandes pour visualiser les détails d'une commande.

1) Sélectionnez une commande parmi la liste puis cliquez sur “voir” pour visualiser les détails d’une commande

2) Allez dans “Invoices” puis sélectionner la facture qui a été créée automatiquement pour la commande.

3) Sélectionner « Crédit Memo ». Vous aurez alors toutes les informations concernant la commande et tout en bas de la page les champs à remplir en cas de remboursement.

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 (status "processing" en cliquant sur l'orderID), une annulation est donc possible.

Pour savoir si la transaction a été annulée ou remboursée totalement, il faut se rendre dans "Axepta" >"Transaction" pour voir la liste des transactions :

Dans la colonne "Type", il sera indiqué « Cancellation » pour une annulation ou « refund » pour un remboursement.

Tableau des abonnements 

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

• ID de l’abonnement
• ID de la commande
• Le client
• Le produit Abonnement
• ID de la transaction
• La périodicité
• La date de début
• La date de la prochaine exécution.
• Le montant
• Le statut de l’abonnement

Vous avez la possibilité de modifier le statut de l’abonnement pour l’activer ou l’arrêter.  

Désactiver un abonnement

Action : Désactiver 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.

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.