Module WooCommerce

From Documentation Mercanet
Jump to: navigation, search

Contents

Objectif

BNP Paribas commercialise un module de paiement officiel pour le CMS WordPress.

Compatibilité

Le module de paiement Mercanet est compatible avec les versions de WooCommerce suivantes : 2.5.x , 2.7.x , 3.2.x , 2.4.x , 2.6.x , 3.0.x, 3.3.x, 3.4.x, 3.5.x

Store

Le module de paiement Mercanet officiel est accessible sur le shop de Quadra Informatique : http://shop.quadra-informatique.fr/fr/home/57-module-bnp-paribas-mercanet-pour-woocommerce-wordpress-officiel.html

Obtenir sa clé d'activation

La clé d’activation est fournie par l’assistance Mercanet par email et elle liste toutes les options auxquelles vous avez souscrit via votre offre.

Important : si vous faites évoluer votre offre, pensez à demander à l'assistance Mercanet la mise à jour de votre clé d'activation.

Pour recevoir votre clé d'activation, envoyez votre demande par email à l'assistance Mercanet à l'adresse mail suivante : assistance.mercanet@bnpparibas.com.

Important : pensez à ajouter la facture d'achat de votre module.

Fonctionnalités

Ce module de paiement inclue les fonctionnalitées suivantes :

  • Paiement simple
  • Paiement en N fois
  • Paiement en multi-devises
  • Paiement one click
  • Choix des moyens de paiement sur le site du marchand ou sur Mercanet
  • Affichage de la page de paiement Mercanet en mode iFrame sur le site du marchand
  • Redirection automatique après paiement sur le site du marchand
  • Notification par email du paiement au porteur
  • Annulation et remboursement des transactions depuis le back office Woocommerce (requiert en supplément l'option Gestion Plus)
  • Moyens de paiement acceptés : Logo1.PNG
                                                         CETELEM 3X.pngCETELEM 4X.pngPRESTO.png


Démonstrations

Démonstration d'installation du module de paiement Mercanet

[Cliquez ici pour voir la démonstration de l'installation du module Mercanet]

Démonstration d'un paiement simple avec le module de paiement Mercanet

[Cliquez ici pour voir la démonstration d'un paiement avec WooCommerce]


Comment faire fonctionner son module

Lorsque vous paramétrez votre module Mercanet sur votre boutique il est préférable pour vous de choisir les fonctionnalitées proposé par défaut.

Version de PHP

La version requise pour faire fonctionner le module de paiement Mercanet est PHP 5.5.
Si votre serveur dispose d’une version antérieure à PHP 5.5, il vous faut effectuer une montée de version de PHP pour permettre au module Mercanet de fonctionner.
Pour vérifier la version de PHP, allez dans « WooCommerce » puis sur la ligne « Etat du système ».
Phpwoo.png
Dans la page qui s’affiche, vérifier dans l’onglet « Environnement serveur » puis la ligne « Version PHP » :
Phpwoo1.png

Version compatible avec le CMS

Si vous disposez de l’offre Mercanet v1, nos modules de paiement pour Mercanet n’est pas compatible avec cette version de Mercanet.
Il vous faut disposer de l’offre Mercanet v2 pour pouvoir utiliser nos modules de paiement officiels pour Mercanet v2.
Pour cela:

  • Il faut installer le module WooCommerce avant d’installer le module de paiement Mercanet
  • Le module WooCommerce doit être supérieur à la version 2.4.x

Réinstallation du module Mercanet

Dans les cas suivants :

  • Installation d’une mauvaise version du module Mercanet
  • Installation d’une nouvelle version du module Mercanet,
  • Installation d’une version plus ancienne du module Mercanet.

Veuillez procéder de la façon suivante pour garantir le bon fonctionnement du module Mercanet :

  • Recopier votre clé d’activation (présente dans l’onglet configuration) car elle vous sera demandée ultérieurement,
  • Supprimer le module de paiement Mercanet en veillant à supprimer le répertoire d’installation du module,
  • Avec ftp aller sur le répertoire de votre serveur et effacer le répertoire mercanet présent dans le répertoire « wp-content/plugins »
  • Installez la nouvelle version du module Mercanet
  • Configurez le module Mercanet avec la clé d’activation, la clé secrète, la version de la clé et le bon environnement (PRODUCTION ou TEST)

Mode de livraison et zone de livraison habilitée

Il est nécessaire de disposer d’au moins un produit avec une zone de livraison qui est habilitée avec le moyen de paiement Mercanet.
Pour vérifier si votre produit dispose bien d’une méthode de livraison autorisée :

  • Aller dans la rubrique « Catalogue »
  • Sélectionner la ligne « Produits »
  • Cliquer sur le produit sélectionné
  • Aller dans l’onglet « Shipping » de la fiche produit
  • Vérifier :
  • Soit qu’aucune méthode de livraison n’est sélectionnée pour toutes les autoriser.
    Soit que votre méthode de livraison est dans la liste des « Selected carriers »

Pour vérifier si votre méthode de livraison est bien autorisée sur vos zones de livraison :

  • Aller dans la rubrique « Transport »
  • Vérifier/habiliter les zones ci-dessous en fonction de vos destinations autorisées


Livraison.PNG

Devise activée

Il est nécessaire d’activer la devise avec le moyen de paiement Mercanet. Pour vérifier si votre devise est bien autorisée sur votre moyen de paiement Mercanet :

  • Aller dans la rubrique « Woocommerce »
  • Sélectionner la ligne « réglages »
  • Sélectionner la ligne « Mercanet Général »
  • Vérifier dans l’onglet « *Devises autorisées (en plus de l'Euro)  » que la liste des devises souhaités (ex : Euro)


Devisewoo1.PNG

Devisewoo.PNG

Mon module ne s'affiche pas dans ma boutique

Vérifier les montants minimum / maximum

Lors de l’installation du module il faut s'assurer que les montants minimum / maximum sont bien renseignés (voir image ci-dessous)
Woocommerce11.PNG

Libellé de paiement

S'assurer que tous les libellés des différentes langues sont bien renseigné (voir image ci-dessous) Woocommerce11.PNG

Installation et configuration du module de paiement

Installation du module

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

  • Allez sur l'onglet "Extensions" du Back-Office de votre boutique,
    Install extension.png

  • Cliquez sur "Ajouter",
    CaptureTelecharger.PNG

  • Cliquez sur "Browse...",
    CaptureTelecharger2.PNG

  • Sélectionnez le fichier zip du module Mercanet à installer puis cliquer sur "Ouvrir",
    SelectionFichierCMS.PNG

  • Cliquez sur "Installer",
    WooCommerceInstaller.PNG

  • Cliquez sur "Activer l'extension",
    WooCommerceActiverExtension.PNG

  • Cliquez sur "Vous devez renseigner votre clé d'activation pour utiliser ce module.",
    WooCommerceRenseignerCleActivation.PNG

  • Renseignez votre clé d'activation propre à votre boutique puis cliquer sur "Enregistrer les paramètres",
    WooCommerceRenseignerCleActivation.PNG

  • Renseignez votre "Merchant ID", la clé secrète, et la version de la clé secrète puis cliquer sur "Enregistrer les paramètres".
    WooCommerceParametresConfiguration.PNG

Utiliser le module en mode Test

Pour utiliser le module de paiement Mercanet en mode test (avec [l'utilisation de cartes de test]), procédez de la manière suivante :

  • Allez dans WooCommerce puis "Réglages" et enfin dans l'onglet "Mercanet configuration"
    WooCommerceParametresConfiguration.PNG

  • Récupérez les informations sur la boutique de test à utiliser (il existe une [boutique de test commune] que vous pouvez utiliser)
  • Cochez la case "Activer ou désactiver le mode de test" pour passer le module en mode test,
  • Renseigner le "Merchant ID", la clé secrète, et la version de la clé secrète de test,
  • Cliquer sur "Enregistrer les paramètres".

Utiliser le module en mode Production

Pour utiliser le module de paiement Mercanet en mode production (avec de vraies cartes qui seront débitées), procédez de la manière suivante :

  • Allez dans WooCommerce puis "Réglages" et enfin dans l'onglet "Mercanet configuration"
    WooCommerceParametresConfiguration.PNG

  • Récupérez les informations sur votre boutique de production depuis [Mercanet Téléchargement]
  • Décochez la case "Activer ou désactiver le mode de test" pour passer le module en mode production,
  • Renseigner le "Merchant ID", la clé secrète, et la version de la clé secrète de production,
  • Cliquer sur "Enregistrer les paramètres".

Désinstaller le module Mercanet

Pour désinstaller le module Mercanet (afin d'installer une nouvelle version par exemple), procédez de la manière suivante :

  • Allez dans "Extensions",
    WooCommerceListExtension.PNG

  • Cliquer sur "Désactiver" au niveau du module "BNP Paribas - Mercanet",
    WooCommerceSupprimer.PNG

  • Cliquer sur "Supprimer" au niveau du module "BNP Paribas - Mercanet",
    WooCommerceSupressionConfirmation.PNG

  • Cliquer sur "Oui" pour confirmer la suppression du module Mercanet.

Gestion des abonnements avec WordPress

Le module de paiement Mercanet est capable d’enrôler des cartes depuis le CMS et il gère le couple Merchant Wallet ID et l’identifiant client.

Le Module de paiement Mercanet ne gère pas :

  • La fabrication du fichier batch pour dupliquer une transaction ou créer une demande de paiement à partir d’un wallet.
  • L’appel de web service pour dupliquer une transaction ou créer une demande de paiement à partir d’un wallet.

La table permettant de faire la correspondance entre le Merchant Wallet iD et le client est la suivante :

  • Dans Woocommerce la table s’appelle wp_mercanet_wallet est contient les champs :
    • wallet_id : merchant wallet ID
    • user_id : c’est l’entrée de l’identifiant du client dans la table wp_users


CAS1.PNG
CAS2.PNG

Point d’attention sur l’enrôlement de la carte

Ce n’est pas parce qu’on propose au porteur d’enrôler sa carte que le porteur est obligé de l’enregistrer. Il peut refuser en cliquant sur « non » je ne souhaite pas enregistrer ma carte. La seule moyenne disponible pour le marchand pour procéder à un abonnement est de dupliquer la première transaction au travers :

  • De l’opération duplicate avec Mercanet batch
  • Du web service duplicate avec Mercanet Gestion +

Comment modifier le bouton de paiement dans la page Check Out?

Pour modifier le libellé en utilisant le logiciel POE dit pour modifier les fichiers de langues qui se trouvent dans le répertoire wordpress/wp-content/plugins/mercanet-woocommerce/languages et en changeant le libellé "Pay with Mercanet" en anglais et "Paiement avec Mercanet" en français par vos propres libellés. 


Quand on sauvegarde le fichier de langue avec POEDIT, il génère un fichier de lange compilé avec le même nom et l'extension .mo qu'il convient de déployer avec le fichier .po sur le serveur dans le module Mercanet.
Il faut donc recopier les 2 fichiers fr_FR.po et fr_FR.mo (généré) sur le serveur du marchand

Paiement par abonnement

Le module de paiement Mercanet inclue la fonctionnalité de paiement par abonnement pour les marchands souhaitant réaliser des paiements récurrents sur des prestations de type abonnement.

Description du paiement par abonnement

Principe de fonctionnement

Les premiers paiements ou les changements de carte de paiement seront dupliqués pour réaliser les paiements récurrents par Web Service initialisés depuis le site du marchand.

L’acheteur pourra depuis votre site marchand :

  • Stopper à tout moment ses paiements récurrents,
  • Payer avec une autre carte de paiement et tous ses paiements récurrents utiliseront cette même carte (dans le cas d’une carte mise en opposition ou échue)
    Le panier du site marchand pourra contenir des produits mixtes :
  • Des produits en paiement unitaire
  • Des produits en paiement récurrents.

Avantages de cette solution

  • Pas de flux batch d’abonnement à fabriquer et envoyer par ftp,
  • Pas besoin de l'offre Mercanet batch.

Inconvénient de cette solution

  • Pas de garantie de paiement,
  • Peut générer des litiges ou débit abusif comme pour tout paiement récurrent.

Mise à jour des CGU

Le marchand doit impérativement bien penser à mettre à jour ses CGU pour indiquer que ses produits sont vendus par paiement récurrent.

Prérequis en terme d’offre Mercanet

Le marchand doit disposer de :

  • l’offre Mercanet Essentiel pour afficher les pages de paiement déportées Mercanet (avec le connecteur POST),
  • l’offre Gestion Plus pour disposer des Web Service (avec le connecteur JSON),
  • l’option duplication activée pour l’offre Gestion Plus.

Onglet Paiement par Abonnement

Cette option vous permet de désactiver ce mode de paiement.

Woocommerce 1.PNG

Libellé

Saisir ici le libellé que verront les clients de votre boutique dans le choix de leur échéancier de paiement.

Activation

Cette option vous permet d’activer ou de désactiver ce mode de paiement et ainsi le rendre disponible/indisponible aux clients de votre boutique.

Onglet Paiement Abonnement dans la fiche Produit

Dans le menu Produits => Tous les produits : 1) sélectionner un produit pour lequel mettre en place un paiement par abonnement 2) Scroll vers le bas, Paiement par abonnement de la fiche produit pour le paramétrage (périodicité, montant...)

Woocommerce 2.PNG

Type

Dans le champ « Type », sélectionner soit :
• "Paiement simple" : pour réaliser un paiement simple unitaire pour ce produit.
• "Paiement par abonnement" : pour réaliser un paiement récurrent pour ce produit.

Périodicité

Dans le champ Périodicité, sélectionner soit :

  • "Jour" : pour fixer l'unité de la période en jour
  • "Mois" : pour fixer l'unité de la période en mois

Nombre d'occurrences

Dans le champ "Nombre d'occurences", renseigner le nombre d'unité de la périodicité entre 2 paiements récurrents :

Exemples de valeurs :

  • Paiement hebdomadaire : 7 (avec la périodicité en Jour)
  • Paiement mensuel : 1 (avec la périodicité en Mois)
  • Paiement annuel : 12 (avec la périodicité en Mois)

Montant récurrent (HT)

Dans le champ "Montant par abonnement", renseigner le montant hors taxe à régler par le porteur pour les paiements récurrents.

Impact pour les marchands

Création du premier paiement récurrent

Le premier paiement est créé via un appel de la page de paiement dans laquelle le porteur saisie classiquement ses données cartes.
Ce premier paiement est identifié dans le back office WooCommerce comme un paiement par abonnement (voir ci-dessous)

Woocommerce 3.PNG

Création des nièmes paiements récurrents


Chaque paiement récurrent donne lieu à la création d'une nouvelle commande sur WooCommerce associé à une nouvelle transaction de paiement réalisée par duplication :

  • soit de la première transaction de paiement récurrent,
  • soit du dernier paiement récurrent du porteur (suite à un changement de la carte réalisé par le porteur).

Le nième paiement récurrent est identifié dans le back office WooCommerce (voir image ci-dessous)

Woocommerce 4.PNG

Impact pour les clients

Bouton de paiement par abonnement

Les clients de votre boutique voient apparaitre le bouton de paiement par abonnement via la solution Mercanet des lors que l’option est activée dans votre backoffice et que l’ensemble des conditions ont été remplies.

Woocommerce 5.PNG

Bouton pour stopper les paiements par abonnement

Vos clients auront la possibilité d’arrêter leurs abonnements (donc tous les futurs paiements récurrents) depuis leur compte client sur votre boutique en cliquant sur le bouton :

  • cliquant sur le bouton "Stopper tous mes paiements par abonnement".

  • Woocommerce 6.PNG

  • Les commerçants auront la possibilité d’arrêter les abonnements de leurs clients (donc tous les futurs paiements récurrents) depuis leur back office Woocommerce :

  • cliquant sur le bouton "Mercanet liste des paiements par abonnement"

  • Woocommerce 7.PNG

Bouton pour changer de carte pour les paiements récurrents

Vos clients auront la possibilité de modifier la carte avec laquelle seront réglés les futurs paiements récurrents et cela directement depuis leur compte client sur votre boutique en cliquant sur le bouton :

"Mes paiements par abonnement"

Woocommerce 8.PNG