Contenu
Introduction
Le plugin téléchargeable sur cette page permet une mise en œuvre rapide de la solution Payline dans votre boutique Prestashop.
Pré-requis
- Désinstallez puis supprimez complètement toute version antérieure du plugin Payline.
- Il faut faire un backup de la table ps_payline_token avant de désinstaller le module, ainsi les données pourront être récupérées si besoin.
- Vérifiez en particulier que la table ps_payline_card est absente de votre base de données avant installation du nouveau plugin (si nécessaire, supprimez-la).
- Au niveau de votre hébergement web, assurez vous que le protocole mis en oeuvre pour les échanges sécurisés est TLS 1.2.
Dans le cas particulier de OVH, votre version PHP doit être la stable (la version legacy ne permet pas de se connecter aux environnements Payline).
Uniquement pour un téléchargement depuis Github :
|
Télécharger le module
Correction d'un bug sur les boutiques a un seul point de vente. |
|
En attente la validation du module sur github par IT / Jerome : on supprime le lien de la doc Télécharger le plugin Payline version 2.2.4 pour Prestashop version 1.7 : télécharger le plugin payline-prestashop_v2.2.4.zip ou sur github Payline Prestashop |
Veillez à utiliser la dernière version du SDK Payline pour inclure toutes les dernières mises à jour concernant les évolutions et les correctifs. Les versions précédentes ne sont pas maintenues. |
Téléchargement du plugin 1.7.8.7 à minima |
1. Cliquez sur "Clone or download" : |
2. Choissisez votre format : "Open in Desktop" ou "Download zip" : |
Installation du plugin
Vérifier le chapitre précédent concernant les prérequis.
Dans votre back-office Prestashop, rendez-vous dans la catégorie Modules :
- Cliquez sur l'icône Ajouter un nouveau plugin
- Cliquez sur le bouton Choisissez un fichier. Dans l'explorateur affiché, sélectionnez le plugin téléchargé puis validez
- Cliquez sur le bouton Charger le plugin
- Payline apparait dans la liste des plugins. Finalisez l'installation en cliquant sur le bouton Installer
Note : Le plugin n'est pas publié sur la place de marché officielle PrestaShop Addons, alors une alerte indique que le module n'est pas vérifié lors de l'installation, cliquez sur Continuer l'installation.
Vérifier la version de Prestashop :
Version 1.7.8.7 à minima :
Cliquez sur le menu : Modules > Catalogue de modules > Installer un module
Rajouter le fichier et installer
|
Mise à jour du plugin
Cliquer sur configurer pour accéder au menu de configuration du plugin Payline pour Prestashop.
|
Configuration
Version 1.7.8.7 à minima : Menu Modules > Module manager > rechercher "Payline" > "Configurer" dans la ligne du module Payline
1. Dans la partie Configuration générale
- Renseignez votre identifiant commerçant et votre clé d'accès.
- Mode production n'est passé à ON que si les identifiants renseignés sont ceux de production.
2. La partie Configuration proxy est à renseigner que si l'accès à internet, depuis le serveur hébergeant votre boutique, se fait via un proxy HTTP.
3. Cliquez sur le bouton Enregistrer. Vos informations sont importées depuis Payline et les deux listes déroulantes apparaissent :
- Point de vente : la liste contient les points de vente actifs de votre compte Payline. Sélectionnez celui qui sera utilisé dans votre boutique Prestashop.
- Contrat par défaut : la liste contient les contrats actifs du point de vente sélectionné. Sélectionnez celui qui sera utilisé par défaut.
4. Cliquez sur le bouton Enregistrer après la sélection du module.
 |
Configuration des contrats
Cet onglet permet de sélectionner parmi les moyens de paiement actifs de votre point de vente ceux qui seront utilisés dans la boutique.
Suivez les instructions à l'écran pour indiquer :
- Les Moyens de paiement proposés dans la boutique : ceux qui seront proposés à l'acheteur lors du processus de commande dans votre boutique.
- Les Moyens de paiement alternatifs en cas d'échec de paiement : ceux qui seront proposés à l'acheteur sur les pages Payline, si leur première tentative de paiement échoue.
Vous pouvez également trier dans l'ordre d'affichage en sélectionnant, maintenant et en glissant le moyen de paiement dessus ou dessous les autres. Le premier de la liste sera présenté en premier dans le formulaire de paiement.
URL de notification
Lors de la configuration de Payline dans votre Back-office Prestashop, vous pouvez voir apparaître un bandeau d'avertissement.
Dans ce cas veuillez consulter la page FAQ pour configurer la Gestion des notifications : Prestashop-Message-d-alerte-URL-de-notification
 |
Méthodes de paiement
Cet onglet permet d'activer en cliquant dessus et de paramétrer les différentes méthodes de paiement proposées par le plugin Payline :
- Paiement simple : paiement comptant via le mode l'interface Payline (page web ou widget);
- Paiement Web en plusieurs fois : paiement NX sur une période avec début et fin;
- Paiement Web par récurrent : paiement REC avec un début et sans fin.
Attention : pour la prise en compte des échéances de paiement en plusieurs fois ou d'abonnement dans votre boutique, il est nécessaire de renseigner l'URL suivante dans le champ URL notification du détail du point de vente dans le centre d'administration. Voir ci dessus URL de notification. |
|
Problèmes courants
Rien ne se passe lors du clic sur le logo d'un moyen de paiement dans la boutique ?
- Vous utilisez un thème spécifique. Le fonctionnement de notre plugin est garanti avec le thème par défaut.
- Il y a un conflit avec un autre plugin. Plusieurs cas nous ont été rapportés avec le module Bloc recherche rapide v1.5.2 - by PrestaShop (le conflit disparaît avec la version 1.7.0 de ce plugin)
Le paiement est réussi mais aucune commande n'est créée ?
- Un plugin tiers peut compromettre le processus de création de commande après le paiement. TCPDF 1.6 par exemple, mais il y en a peut-être d'autres. Vos retours nous intéressent
- Le client n'est pas revenu à la boutique, et le processus de notification a échoué. Vérifiez que votre URL de notification (i.e. l'URL du script notification.php du plugin) est joignable.
Au retour à la boutique, l'acheteur obtient le message Error. Token verification failed.
- Il s'agit d'un conflit avec d'autres plugins utilisant également une variable de retour nommée token
- Les cas dont nous avons connaissance concernent le plugin Mailjet. Pas d'autre solution que de le désactiver !
L'encart Payline n'est pas affiché dans le checkout
- La version 1.6.2 de notre plugin n'est pas compatible avec l'option l’option Advanced checkout page du plugin natif Advanced EU Compliance (en français option page de commande avancée du plugin Conformité européenne améliorée). Une mise à niveau est à l'étude.
L'acheteur ne peut pas modifier son portefeuille via son compte client
- Pour que la modification soit possible, au moins un bouton de modification des données portefeuille doit être sur ON dans la méthode Paiement par portefeuille
- Une incompatibilité avec le plugin Ajouter un formulaire de contact v1.2.0 par Mediacom87 empêche l'affichage de la pop-up contenant le formulaire de mise à jour
L'encart Payline est affiché dans le checkout mais ne propose aucun moyen de paiement.
- Avez-vous correctement ajouté vos moyens de paiement via l'onglet Type de cartes de la configuration du plugin ? Avez-vous activé une méthode dans l'onglet Méthodes de paiement ?
La configuration des moyens de paiement proposés dans la boutique ne s'enregistre pas
- Cette configuration est enregistrée dans la table dédiée ps_payline_card qui ne s'est peut-être pas créée lors de l'installation du plugin
- Il suffit parfois de désinstaller, supprimer puis réinstaller le plugin pour que la table soit bien créée et le problème résolu.
- Si le problème persiste, créer la table via l'outil de gestion de base de donnée (phpMyAdmin est le plus courant) mis à disposition par votre hébergeur. La requête de création de ps_payline_card est dans le script modules/payline/install/sql/install.sql. Contactez votre hébergeur si cette action échoue.
La page de configuration Payline affiche un écran blanc
Il faut vérifier l'affichage de l'écran : si nécessaire réduire l'affichage, ou faire un zoom sur cette page.
Gestion des frais de port hors de FRance métropole (exemeple : Corse, Guadeloupe)
- Le centre administration de Prestashop ne le permet pas. Vous pouvez contourner le problème en modifiant directement dans la table « country » de prestashop (mysql) le code ISO des « pays » : France et « France Corse » créés pour distinguer les frais de port.