- 1. Installation via Composer.
- 1.1 Aide
- 1.2 Mise à jour du module de paiement:
- 2. Installation via le Back-office Magento
- 3 Mise à jour des statuts de paiement:
- 4. Désinstallation du module.
1. Installation via Composer (recommandée):
Vous pouvez installer le module PayPlug en vous aidant de notre documentation mise à jour sur Github.
Afin d'installer le module PayPlug sur Magento 2 via Composer, il vous faudra appliquer les commandes suivantes à la racine de Magento :
composer require payplug/payplug-magento2 # (*)
composer install
php bin/magento module:enable Payplug_Payments --clear-static-content
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy <languages> # (**)(***)
php bin/magento cache:clean
(*) Si vous ne les avez pas sauvegardées quand vous avez installé Magento 2, cette commande vous demandera vos clés d’authentification Magento (https://devdocs.magento.com/guides/v2.3/installgde/prereq/connect-auth.html). Login= Public Key Password=Private Key
(**) Avec l’option <languages> vous pouvez définir pour quelle langue vous souhaitez générer le contenu. Les langues doivent être séparées par un espace. par exemple pour générer un contenu en_US et fr_FR vous pouvez appliquer la commande:
php bin/magento setup:static-content:deploy en_US fr_FR
(***)Si vous n’êtes pas en production, utilisez l’option “--force”. Dans le cas contraire, la commande échouera. Par exemple pour généré un contenu en en_US et fr_FR vous pouvez appliquer la commande :
php bin/magento setup:static-content:deploy --force en_US fr_FR # --force # if you are not running on production mode
1.1 Aide:
Si vous obtenez un message d’erreur lors du processus de paiement comme cela:
[ReflectionException] Class Payplug\Authentication does not exist
Il est probable que la library PHP de PayPlug ne se soit pas installée avec l’installation du module Magento. Cela peut arriver si vous n’avez pas lancé composer pour installer le module. Pour résoudre cela vous devriez demander les dépendances manquantes avec composer:
composer require payplug/payplug-php:^3.0
Vous devrez alors installer une autre library que nous utilisons pour normaliser le numéro de téléphone du client.
composer require giggsey/libphonenumber-for-php:^8.10
1.2 Mise à jour du module de paiement:
Pour mettre à jour votre module, il vous faudra appliquer les commandes suivantes à la racine de Magento :
composer require --update-with-all-dependencies payplug/payplug-magento2:VERSION_YOU_WANT_TO_UPDATE_TO # (*)
composer install
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy <languages> # (**)
php bin/magento cache:clean
(*) Pour déterminer quelle valeur pour VERSION_YOU_WANT_TO_UPDATE_TO vous pouvez vérifier notre dernière release, par exemple, vous pouvez appliquer:
composer require --update-with-all-dependencies payplug/payplug-magento2:^1.5
(**) avec l'option "langue", vous pouvez définir quelle langue vous voulez générer pour le contenu. Par exemple, pour générer le contenu en en_US et fr_FR, vous pouvez appliquer les commandes :
php bin/magento setup:static-content:deploy en_US fr_FR
2. Installation via le Back-office Magento:
Vous pouvez suivre la documentation Magento fournie sur cette page :
https://devdocs.magento.com/guides/v2.3/comp-mgr/extens-man/extensman-main-pg.html
- Créez vos identifiants pour accéder à la Marketplace Magento
- Chercher puis ajouter au panier le module PayPlug Magento 2, vous obtiendrez les clés d’authentification.
- Connectez-vous à votre back-office Magento
- Rendez-vous dans le menu System/Système> Web Setup Wizard
- Cliquez sur Extension Manager/ l’extension Manager
- Si demandé, connectez-vous à Extension Manager
- Il vous sera ensuite demandé de vous connecter avec la clé publique et privée obtenue sur la Marketplace lors du téléchargement du module
- Cliquez sur Submit/Soumettre.
- Après vous être connecté au module PayPlug vous retrouverez l’écran ci-dessous :
- Rendez-vous dans les Extensions Ready to Install/Extension à installer
3. Mise à jour des statuts de paiement:
3 méthodes sont disponibles pour mettre à jour les paiements:
- paymentReturn: appelée automatiquement par PayPlug après la validation du formulaire de paiement.
- Notification de Paiement Instantanée: déclenchée par PayPlug après la soumission du formulaire de paiement. A noter que pour bénéficier de l’IPN, votre serveur devra être accessible par PayPlug. Les appels d’IPN échoueront dans la plupart des environnements de développement.
- Le bouton “Update Payment” sur la vue de la commande du back-office Magento: lance une requête à PayPlug pour obtenir le statut actuel du paiement.
Pour les paiements fractionnés, chaque fois qu’un nouveau paiement sera ajouté au paiement fractionné, une notification sera envoyée à votre serveur. Cela déclenchera la modification du montant dû pour la commande.
Annulation d'une commande non payée :
Il est également possible d'annuler plusieurs commandes simultanément :
Attention, les commandes PayLater via Oney ne sont pas annulables.
4. Désinstallation du module.
Comme tout moyen de paiement, il n’est pas conseillé de désinstaller les modules de paiement. Une fois que les commandes sont créées en utilisant un moyen de paiement donné, Magento aura besoin que le code du module affiche les informations de commande, et crashera s’il ne les trouve pas.
Ainsi, si vous souhaitez un jour arrêter d’utiliser notre module, nous vous recommandons de paramétrer simplement le Paramètre de Permission à Non, et PayPlug n’apparaîtra plus en bout de panier.