Contenu




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

  • 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


Connectez-vous à votre back office WordPress. Cliquez sur le menu Extensions  puis le bouton Ajouter.


Puis ajouter un extension en cliquant sur le lien Téléverser une extension.


Ensuite sélectionner le fichier plugin Payline que vous avez téléchargé ci dessus.



Pour activer le plugin : cliquer Activer l'extension.




 Configuration

Pour commencer la configuration du plugin : 


  • Cliquer sur Settings CPT pour les paiements comptant
  • Cliquer sur Settings NX    pour les paiements par abonnement
  • Cliquer sur Settings REC  pour les paiements récurrents


Vous pouvez également retrouvrer les types de paiements dans le menu WooCommerce > Réglages > Paiements puis Gérer pour configurer ces types de paiements.







Paiement comptant CPT



Paramètres de généraux

  • 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.
  • 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.
  • Notification URL permet de gérer les notifications lors des paiements récurrents REC et les abonnement NX (voir ci dessous pour les configurations).  Cette URL doit être configurée dans le Point de vente du Centre Administration Monext. 




Paramètres de connexion

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


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.



Paramètres du paiement

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

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

  • 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.
  • Mode d'intégration du widget : sélectionner votre affichage du widget (formulaire de paiement) 
    • Mode In-Shop Lightbox, Mode In-Shop colonne, Mode In-Shop tabulations, Mode redirection : voir les détails ici.
  • 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.

  • Numéro de contrat est votre numéro qui détermine le point de vente utilisé.

  • Contrats primaires (champ obligatoire) ce champ est obligatoire avec les numéros de contrat (séparés par des points-virgules) correspondant aux moyens de paiement que vous souhaitez proposer à vos clients pour un premier essai de paiement.

  • Contrats secondaires (facultatif) ce champ doit être rempli avec les numéros de contrat (séparés par des points-virgules) correspondant aux moyens de paiement que vous souhaitez proposer à vos clients pour une deuxième tentative de paiement, si le premier essai a échoué.


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.




Paiement en plusieurs fois NX


Les paramètres communs au monde comptant CPT sont décrits dans le chapitre ci-dessus.

Paramètres de généraux

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

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

Payline N Fois

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





Paiement récurrent REC


Les paramètres communs au monde comptant CPT sont décrits dans le chapitre ci-dessus.

Paramètres de généraux

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

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

Payline par abonnement 

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



Pages associées