Contenu
| Sommaire | ||||
|---|---|---|---|---|
|
Introduction
Le plugin téléchargeable sur cette page permet une mise en œuvre rapide de la solution Payline Monext Online dans votre boutique PrestashopSylius.
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).
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).| Extrait | ||
|---|---|---|
| ||
Uniquement pour un téléchargement depuis Github :
|
Télécharger le module
| Extrait |
|---|
Correction d'un bug sur les boutiques a un seul point de vente. |
| title | Historique des mises à jour... |
|---|
| Extrait |
|---|
Montée de version avec le SDK PHP 4.69. |
- Plugin Payline version 2.2.10 pour Prestashop version 1.7.8.7 à minima : télécharger le plugin payline-prestashop-version_2.2.10.zip
Compatibilité du module avec un Prestashop 1.7.7.8.
Fix de l'import des contrats avec un seul point de vente.
Fix de la sauvegarde de la catégorie par défaut.
Ajout d'une configuration pour la catégorie par défaut sur order.details.
Correction sur le remboursement partiel et total.
Correction sur l'affichage de l’écran de configuration en mode multi boutiques.
Passage en version API Payline en 21.
Correction sur la limite des champs d'adresse à 100 caractères.
| Extrait |
|---|
Ajout d'une configuration pour la catégorie par défaut sur order.details |
| Extrait |
|---|
Correction sur le remboursement partiel et total. |
| Extrait |
|---|
Mise a jour de la version du sdk php 4.59. |
| hidden | true |
|---|
En attente la validation du module sur github par IT / Jerome : on supprime le lien de la doc
Téléchargerle 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| Remarque |
|---|
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. |
| Extrait | ||
|---|---|---|
| ||
Téléchargement du plugin 1.7.8.7 à minima |
Les fonctions disponibles sont :
- Mode widget avec un affichage de la page de paiement hébergé par Monext avec redirection de l'acheteur.
- Paiement comptant.
- Paiement à la commande et à l'expédition.
- Remboursement partiel, multiple et total.
- Les moyens de paiement :
- CB, Visa, Mastercard, American Express, ApplePay, GooglePay, PayPal.
- avec l'acquéreur Monext : Bancontact, iDEAL, Klarna, Multibanco, MB Way.
- Devise Euro.
Le paiement sur votre boutique
- Validation de la commande
1. L'acheteur valide sa commande.
2. Il valide son mode de paiement.
3. Puis il sélectionne son moyen de paiement et saisie ses informations de paiement.
| Extrait | ||
|---|---|---|
| ||
Gestion des commandesInformations de paiementDans le détail des commande de votre backoffice Magento 2, un permalien vous permet d'accéder directement au détail de la ou les transaction(s) associée(s) dans le centre d'administration Payline. ValidationSi vous avez opté pour le mode de débit "à l'expédition", vous avez la possibilité de valider séparément le montant de chaque élément de la commande. La validation se fait via la création d'une facture partielle, pour le produit concerné. AnnulationRemboursementChaque élément de commande ayant fait l'objet d'une validation peut être remboursé unitairement depuis le détail de la commande. |
Télécharger le module
Vous devez suivre la procédure indiqué sur Github : https://github.com/PaylineByMonext/payline-sylius
Configuration du module
Configuration du moyen de paiement
Menu Configuration > Moyens de paiement
Cet section permet de configurer et
| hidden | true |
|---|
1. Cliquez sur "Clone or download" :
| hidden | true |
|---|
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 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
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
| Développer | ||
|---|---|---|
| ||
Mise à jour du plugin
Cliquer sur configurer pour accéder au menu de configuration du plugin Payline pour Prestashop.
| Développer | ||
|---|---|---|
| ||
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.
| Développer | ||
|---|---|---|
| ||
Configuration des contrats
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 votreboutique.
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. configurant le numéro de l'emplacement.
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
| Développer | ||
|---|---|---|
| ||
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;
| Avertissement |
|---|
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. |
| title | Module Payline |
|---|
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)
Créer un moyen de paiement :
Code de votre moyen de paiement
Le canal web utilisé
Type de module
Clé API
Point de vente
Type de capture :
Automatique (à la commande)
Manuel le (à l'expédition)
Environnement : Homologation (test) / Production
Numéros de contrat
Transitions pour la capture manuelle
Pages associées
Contenu par étiquette showLabels false max 10 spaces com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@9a3 showSpace false sort title type page cql label = "plugin" and label = "integration" and type = "page" and space = "DT" labels bancontact belgique choixdelamarque
Contenu par étiquette showLabels false max 10 spaces com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@9a3 showSpace false sort title type page cql label in ( "plugin" , "prestashop" ) and label = "prestashop" and type = "page" and space = "DT" labels bancontact belgique choixdelamarque