Contenu


Plus d'information



Configuration du plugin WooCommerce

Vous devez suivre les étapes de configuration pour paramétrer le plugin Payline pour WooCommerce.


Plugin pour WooCommerce

Le plugin pour WooCommerce est mis à disposition sous la forme d'un fichier compressé.
Il contient les éléments permettant l'appel des web services Monext Online, ainsi que l'intégration de Monext Online au sein des parties front-office (paiement) et back-office (configuration) de votre boutique réalisée sous WooCommerce.


Télécharger le plugin 

Notre plugin de paiement est publié sur gitHub : monext-woocommerce

Release 1.5.6

  • 💳 Une expérience d’achat plus fluide

    • Parcours UX : une nouvelle expérience de paiement fluide et totalement intégrée dans la page de checkout.

    • Bouton “Payer” sur-mesure : adaptez le style, le texte et les couleurs pour une parfaite intégration à votre boutique.

    • Gestion du wallet client : vos clients peuvent désormais enregistrer et gérer leurs cartes directement depuis leur compte.

  • 💼 Expérience administrateur repensée

    • Refonte complète de l’interface d’administration : navigation simplifiée et centralisation des moyens de paiement, pour chaque type d’opération.

  • 🛒 Gestion des opérations

    • Validation manuelle sécurisée : des contrôles renforcés garantissent la cohérence des transactions avant validation.

    • Amélioration du workflow de paiement : création de commande avant 3DS pour éviter les transactions incomplètes.

    • Capture sur événement : automatisation de l’encaissement à la validation de commande.

  • 🎨 Rebranding Monext : découvrez le nouveau logo Monext, reflet d’une identité modernisée.

Release 1.5.4 

  • 🔔 Affichage de l’URL de notification dans WooCommerce
    L’URL de notification est désormais visible dans la console WooCommerce. Cette amélioration permet de la récupérer plus facilement pour la configuration dans CAV5 (REC et NX), facilitant ainsi l’intégration.

  • 💳 Optimisation du parcours de paiement
    L’affichage de cette URL joue un rôle clé dans la finalisation des commandes : si l’utilisateur ne ferme pas le ticket de paiement, la notification assure la validation automatique de la commande.

  • 💬 Personnalisation des messages de paiement
    Il est désormais possible de personnaliser les messages affichés en cas de paiement refusé, annulé ou en erreur, pour une meilleure expérience utilisateur.

  • 🚀 Mise à jour vers la dernière version des APIs webPayment
    Le plugin a été mis à jour avec la version la plus récente des APIs webPayment. Vous bénéficiez ainsi des dernières améliorations et optimisations fonctionnelles.

  • 🚀 Mise à jour du plugin  avec la version de WooCommerce - Version 9.8.5 developer.woocommerce

Release 1.5.1 

  • Remboursement de la commande lors d’une transaction abandonnée (Status=Cancelled).

Release 1.5.0 

  • Cette nouvelle version est testée sur une version Wordpress 6.6.2 et Woocommerce 9.2.3

  • Cette livraison comprend : Le support des blocs Gutenberg.

Release 1.4.9 

  • Réutilisation du Token de moins de 12min.
  • Correction sur annulation intempestive de commandes sur notification.

Release 1.4.8 

  • Activation du wallet sur la page web de paiement permet de rajouter une case à cocher proposant l'enregistrement de la carte afin de proposer des paiements one clic.
  • Correction warning sur propriétés de classe déclarées dynamiquement.

Release 1.4.7 

  • Compatibilité avec Wordpress 6.3.2
  • Compatibilité avec Woocommerce 8.2.1 et support de HPOS
  • Ajout customer id dans l'objet buyer.
  • Montée de version du SDK Payline PHP en 4.76.

Release 1.4.6 

  • Compatibilité Wordpress 6.2.2
  • Compatibilité Woocommerce 7.2.2
  • Mise à niveau SDK Payline PHP en 4.74

Release 1.4.5 

  • WooCommerce 3.0  à  4.9.2
  • Montée de version avec le SDK PHP 4.71.
  • Moyen de paiement COFIDIS : amélioration de l'état Pending pour gérer les commandes sur WooCommerce.
  • Prise en compte de l'état On-hold coté WooCommerce sur la commande.

Release 1.4.4 

  • Montée de version avec le SDK PHP 4.69.
  • Positionnement du numéro d'API à 26.

Release 1.4.3 

  • Montée de version avec le SDK PHP 4.66.
  • Correction sur la date de première échéance pour les paiements N fois.

Release 1.4.2 

  • Ajout d'une configuration pour choisir le statut finale de la commande.
  • Correction sur le troncage à 50 caractères en UTF8.
  • Correction sur erreur d'utilisation de log .


Intégration du plugin dans votre boutique

Prérequis

Les plugins Payline pour WooCommerce sont construits autour du kit Payline PHP, dont le fonctionnement nécessite l'activation des extensions PHP:  php_mbstring, php_openssl, php_soap et php >= 5.3.0


Vous devez également disposer d'un compte Payline pour configurer votre plugin.

La solution Payline repose sur l'appel de web services, assurez-vous que l'appel de web services sécurisés est donc possible avec votre solution d'hébergement (l'ouverture des ports 8080 et 443 en entrée/sortie est nécessaire).



Installation sous WooCommerce


1. Télécharger le fichier Zip de github.com/monext-woocommerce/releases

2. Connectez vous à votre console office WooCommerce.

3. Cliquez sur le menu Plugins puis le bouton Ajouter/Add puis sur le bouton Update



4. Puis Sélectionner le fichier téléchargé de gitHub\Monext.

5. Puis Intaller le plugin. 

6. Le plugin est installé, vous pouvez l'activer, et saisir l'ID Merchant et la clef API/Clé d'accès (voir ci dessous).


 Configuration

Dans le menu Plugins, vous accédez à la configuration du plugin de paiement Payline.


Vous devez commencer à saisir l'ID Merchant et la clef d'API que vous trouverez dans le centre administration Monext Online.

Cliquer sur Settings pour configurer le plugin.

Paramètres de connexion


  • Merchand ID est l'élément qui vous a été communiqué lors de la création de votre compte.
    • Vous disposez d'un identifiant commerçant par environnement (homologation et production), à remplir en cohérence le champ Environnement cible (homologation et production) ci-dessous.

  • Clé d'accès est votre clé pour l'appel des web services Payline.
    Une clé vous été communiquée lors de la création de votre compte.
    Vous pouvez à tout moment en créer d'autres via le centre d'administration Payline.

  • Environnement cible correspond à l'environnement Payline vers lequel vos paiements sont dirigés.
    L'environnement d'homologation est réservé aux tests, les paiements y sont fictifs.
  • Paramètre Smartdisplay
    • Permet de sélectionner les moyens de paiement d'un point de vente d'un commerçant.
      Ce paramètre éviter d'afficher tous les moyens de paiement.
      Pour cela il suffit de valoriser ce paramètre et de valoriser la même valeur dans le configuration du menu Affichage des moyens de paiement dans le centre administration de Monext.


Configuration avancé

  • Smartdisplay
    • Permet de sélectionner les moyens de paiement d'un point de vente d'un commerçant.
      Ce paramètre éviter d'afficher tous les moyens de paiement.
      Pour cela il suffit de valoriser ce paramètre et de valoriser la même valeur dans le configuration du menu Affichage des moyens de paiement dans le centre administration de Monext.

  • Journal des logs  permet d'activer le traçage des évènements relatifs à Payline dans le fichier spécifié. 
    (avertissement) Ne pas sélectionner sur la production.

  • Langue par défaut est la langue dans laquelle la page de paiement est affichée.


Messages d'erreur

  • Vous pouvez configurer les textes des messages sur la page de paiement pour les messages de type refusé, annulé et en erreur. Vous pouvez personnaliser les messages en fonction du type ShortMessage.

Paramètres proxy

  • Hote, Port, Utilisateur et Mot de passe doivent être valorisés avec les mêmes paramètres que ceux éventuellement utilisés pour accéder à Internet depuis votre serveur. Laissez ces champs vides si vous n'utilisez pas de proxy.





Paiement comptant CPT

Vous pouvez configurer votre de paiement ainsi que le mode d'intégration du Widget de paiement dans la partie Formulaire de paiement (Payment Form).

Cliquer sur Settings CPT pour les paiements comptant.

Paramètres de paiement

  • Statut  permet d'activer l'affichage du type de paiement dans le processus de commande.
  • Titre  est le libellé sous lequel le paiement Payline est proposé à l'acheteur dans le processus de commande.
  • Description  est affiché à l'acheteur lorsque le paiement Payline est sélectionnée.
  • Portefeuille permet d'afficher le portefeuille de l'acheteur sur la page de paiement.
  • Action de paiement détermine le type de transaction réalisée lors d'un paiement :
    • Autorisation : ce type d'opération doit être validée dans le centre d'administration Payline sous 7 jours pour que le paiement soit effectif. Ceci vous permet par exemple de ne débiter votre client qu'au moment où son achat lui est expédié.
    • Autorisation + Capture : ce type d'opération correspond à un paiement complet, l'acheteur est immédiatement débité.
  • Capture du paiement sur évènement (uniquement en mode Autoriser)
    Vous pouvez capturer la commande automatiquement lors d'un évènement de la commande. Vous pouvez consulter l'état de la commande.
  • Statut commande payée : sélectionner le statut de la commande une fois que le paiement est réalisé. Dans le centre administration de WooCommerce, vous pouvez mettre la commande au statut "Terminée" ou "En cours" (par défaut) selon vos besoins.
  • Code de la page personnalisée  sert à la saisie d'un code de personnalisation de vos pages de paiement, configurer depuis le centre d'administration Payline. Uniquement pour le mode redirection.




  • Contrats primaires (champ obligatoire) : vous pouvez sélectionner les moyens de paiement que vous souhaitez afficher sur la page de paiement. Vous pouvez également utiliser la fonction Smartdispay.


  • Mode d'intégration du widget : sélectionner votre affichage du widget (formulaire de paiement) 
    • Mode redirection sur une page personnalisée, que vous devez paramétrer dans le centre administration de Monext Online.
    • Mode In-Shop Lightbox, Mode In-Shop colonne, Mode In-Shop tabulations, Mode redirection : voir les détails ici.

  • Vous pouvez activer la couleur, le style et le texte du bouton action pour payer (CTA).

    • Label CTA permet de changer le texte en rajoutant le montant du paiement, cette fonction est indispensable pour les paiements par téléphone mobile.
    • Couleur CTA : couleurs présélectionnées ou définie en hexadécimal. 
    • Couleur CTA au survol plus foncée ou plus claire : L'option Non permet les valeurs par défaut.
    • Couleur et taille du texte.
    • Bord arrondis
    • Couleur du widget de paiement
    • Texte Sous le CTA.



Paiement en plusieurs fois NX

Les paramètres des paiements fractionnés sont décrits ci-dessus.


Paramètres de paiement

  • Statut  permet d'activer l'affichage du type de paiement dans le processus de commande.
  • Titre  est le libellé sous lequel le paiement Payline est proposé à l'acheteur dans le processus de commande.
  • Description  est affiché à l'acheteur lorsque le paiement Payline est sélectionnée.


  • Fréquence des échéances : détermine le rythme des paiements.
  • Nombre d'échéances (Format numérique) : Nombre d'échéances de paiement proposé pour ce type de paiement.


  • Notification URL permet de gérer les notifications lors des paiements récurrents REC et les abonnement NX. Cette URL doit être configurée dans le Point de vente du Centre Administration Monext. 


  • Contrats primaires (champ obligatoire) : vous pouvez sélectionner les moyens de paiement que vous souhaitez afficher sur la page de paiement pour les paiements fractionnés.


Paiement récurrent REC

Les paramètres des paiements par abonnement sont décrits ci-dessus.


Paramètres de paiement

  • Statut  permet d'activer l'affichage du type de paiement dans le processus de commande.
  • Titre  est le libellé sous lequel le paiement Payline est proposé à l'acheteur dans le processus de commande.
  • Description  est affiché à l'acheteur lorsque le paiement Payline est sélectionnée.


  • Fréquence des échéances : détermine le rythme des paiements.
  • Nombre Maximum d'échéances (Format numérique) : Nombre d'échéances de paiement proposé pour ce type de paiement.
  • ID produits éligibles (Obligatoire) : si le champ est vide alors ce type de paiement ne sera pas proposé. Renseigner une liste d'ID de produit qui peuvent faire l'objet de paiement récurrent. 


  • Notification URL permet de gérer les notifications lors des paiements récurrents REC et les abonnement NX. Cette URL doit être configurée dans le Point de vente du Centre Administration Monext. 


  • Contrats primaires (champ obligatoire) : vous pouvez sélectionner les moyens de paiement que vous souhaitez afficher sur la page de paiement pour les abonnements.


Pages associées