VibeFox PayPal for WooCommerce — Aide
Prérequis
WordPress : 6.0 ou ultérieur.
WooCommerce : 7.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.
PHP : 8.0 ou ultérieur.
HTTPS : votre site doit utiliser HTTPS pour les paiements en production.
Compte PayPal : un compte PayPal Business avec une application REST API dans le PayPal Developer Dashboard. Vous avez besoin du Client ID et du Secret de l'application. Les applications sandbox et production ont des identifiants différents. Aucun webhook n'est nécessaire : l'extension confirme chaque paiement sur votre serveur pendant que le client est sur la page de paiement.
Devise : l'une des devises prises en charge par PayPal : AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD ou USD.
Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.
Installation
1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_paypal_gateway dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Dans le PayPal Developer Dashboard, créez une application REST API (sandbox et/ou production) et copiez son Client ID et son Secret.
4. Ouvrez les réglages : WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage, ou cliquez sur Settings sous le nom de l'extension dans la page Plugins.
5. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.
6. Saisissez les identifiants du mode que vous utilisez, choisissez Capture ou Authorize, activez Enable/Disable et enregistrez.
7. Testez avec un compte acheteur sandbox PayPal, puis décochez Sandbox mode et saisissez les identifiants de production.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > PayPal (Smart Buttons). Au-dessus des champs, la page vous avertit lorsque le moyen de paiement est activé mais que le Client ID ou le Secret du mode sélectionné est vide, et lorsque PayPal ne prend pas en charge la devise de la boutique. Dans les deux cas, le moyen de paiement est masqué sur la page de paiement. Dans la liste des moyens de paiement, PayPal affiche un badge Test mode en mode sandbox et est signalé comme nécessitant une configuration tant que les identifiants du mode sélectionné ne sont pas renseignés.
Général
Enable/Disable : Enable PayPal Gateway active ou désactive le moyen de paiement. Par défaut : off.
Title : le nom du moyen de paiement que voient les clients sur la page de paiement. Par défaut : PayPal.
Description : le texte affiché sous le moyen de paiement sur la page de paiement. Par défaut : Pay with your PayPal account or a card via PayPal.
Identifiants API
Créez une application REST API dans le PayPal Developer Dashboard et copiez son Client ID et son Secret. La section contient des liens vers les applications sandbox et les applications de production. Seuls les champs du mode sélectionné sont affichés.
Sandbox mode : Enable sandbox (test) mode. Les paiements sont envoyés au sandbox PayPal avec les identifiants sandbox ; aucun argent réel n'est déplacé. Par défaut : on. Décochez-le pour accepter des paiements réels.
Sandbox Client ID : le Client ID de votre application REST API sandbox.
Sandbox Secret : le Secret de votre application REST API sandbox.
Live Client ID : le Client ID de votre application REST API de production.
Live Secret : le Secret de votre application REST API de production.
Paiement
Payment action : ce qui se passe lorsque le client approuve le paiement. Par défaut : Capture.
Avancé
Debug log : Log API requests (errors are always logged). Les entrées sont enregistrées dans WooCommerce > Status > Logs, source wcp_paypal_gateway. Les identifiants et les données des acheteurs ne sont jamais journalisés. Par défaut : off.
Delete data on uninstall : Delete the gateway settings when the plugin is deleted. Les données de paiement des commandes (identifiants PayPal stockés dans les commandes) sont toujours conservées. Par défaut : off.
Paiement
Lorsque le client choisit PayPal (par défaut PayPal), le bouton PayPal remplace Place order. En mode sandbox, la page de paiement affiche Mode sandbox : payez avec un compte acheteur sandbox PayPal ; aucun argent réel n'est débité. Un clic sur le bouton crée sur votre serveur une commande PayPal pour le total du panier (ou pour le total de la commande sur la page Pay for order). Le montant est toujours calculé sur le serveur, jamais dans le navigateur.
Le client approuve le paiement dans la fenêtre PayPal avec un compte PayPal ou une autre source de financement proposée par PayPal. La page de paiement affiche alors Paiement PayPal approuvé. Finalisation de votre commande… et envoie la commande. Votre serveur lit la commande PayPal et vérifie qu'elle est approuvée, qu'elle a été créée lors de ce paiement, qu'elle n'est utilisée par aucune autre commande et que son montant et sa devise correspondent à la commande. Ce n'est qu'alors que le paiement est capturé (ou autorisé) et que le client arrive sur la page de confirmation de commande.
Si le total du panier a changé après l'approbation, rien n'est capturé. Le client voit Le total de la commande a changé après que vous avez approuvé le paiement dans PayPal. Veuillez cliquer à nouveau sur le bouton PayPal pour approuver le nouveau total. Si un champ du paiement manque, l'approbation est conservée : après correction, le client clique sur Place order pour finaliser le paiement. Si PayPal refuse le paiement, le client est invité à cliquer sur le bouton PayPal et à choisir un autre moyen de paiement. Si le client ferme la fenêtre PayPal, la page de paiement affiche Vous avez annulé le paiement PayPal.
Si PayPal ne répond pas pendant la capture, le client voit Nous ne pouvons pas encore confirmer votre paiement PayPal. Veuillez réessayer dans un instant : vous ne serez pas débité deux fois. Une nouvelle tentative utilise la même approbation ; si PayPal avait finalisé la tentative précédente, ce paiement est utilisé et la nouvelle approbation n'est pas capturée.
Le moyen de paiement fonctionne sur la page de paiement classique, sur le bloc Paiement et sur la page Pay for order. Le script PayPal est chargé dans son propre espace de noms, il n'entre donc pas en conflit avec un autre plugin PayPal de la page. Il est compatible avec le stockage haute performance des commandes de WooCommerce (HPOS).
L'extension n'a pas de webhooks PayPal, ni messages Pay Later, ni champs de carte, ni réglages Venmo, ni Apple Pay, Google Pay ou Fastlane, ni moyens de paiement enregistrés ou abonnements, ni boutons sur les pages produit ou panier. L'adresse de livraison saisie dans la page de paiement WooCommerce est utilisée, et non une adresse provenant de PayPal.
Commandes et remboursements
Order statuses
Pending payment : la commande a été créée, mais le paiement n'est pas encore capturé, par exemple après une réponse inconnue de PayPal.
Processing : la capture est terminée. Les commandes ne contenant que des produits virtuels téléchargeables passent en Terminée, valeur par défaut de WooCommerce. La note de commande indique le montant, la commande PayPal et la capture. L'identifiant de transaction est l'identifiant de capture PayPal ; sur l'écran de la commande, il renvoie vers le paiement dans votre compte PayPal (sandbox ou production).
On hold : le paiement a été autorisé et attend d'être capturé (action de paiement Authorize) ; ou la capture est PENDING chez PayPal, par exemple lors d'un examen du paiement ; ou le montant ou la devise payés diffèrent de la commande ; ou le paiement n'a pas pu être lu dans la réponse de PayPal. La note de commande l'explique.
Failed : PayPal a refusé la capture ou l'autorisation.
Cancelled : l'autorisation a été annulée avec Void PayPal authorization.
Actions sur la commande
Ouvrez la commande, choisissez une action dans Order actions et cliquez sur la flèche.
Remboursements
Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via PayPal (le bouton affiche le titre de votre moyen de paiement). Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé à l'environnement PayPal dans lequel le paiement a été effectué (sandbox ou production), les identifiants de cet environnement doivent donc être renseignés. Le motif est transmis à PayPal sous forme de note pour l'acheteur. Si PayPal n'accepte pas le remboursement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant et le statut du remboursement PayPal ; un remboursement PENDING est finalisé plus tard par PayPal.
Un paiement seulement autorisé ne peut pas être remboursé : utilisez plutôt Void PayPal authorization. Les remboursements, litiges et annulations effectués dans votre compte PayPal ne sont pas synchronisés avec WooCommerce.
Clé de licence
L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > PayPal (Smart Buttons). Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active, et votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.
Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine : libérez-le dans votre compte vibefox.net.
Sans clé active, PayPal n'est pas affiché aux clients sur la page de paiement. Si un paiement est lancé malgré tout, le client voit This payment method is not available. Please choose another one. Les gestionnaires de la boutique connectés voient toujours le moyen de paiement, marqué (unlicensed — visible to admins only), afin de pouvoir configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les remboursements et les actions sur les commandes continuent de fonctionner.
Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.
Dépannage
PayPal n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le Client ID et le Secret du mode sélectionné sont renseignés, que la devise de la boutique est prise en charge par PayPal et que le total du panier est supérieur à zéro. La page des réglages affiche un avertissement lorsque les identifiants ou la devise posent problème. Une extension de navigateur qui bloque www.paypal.com masque aussi le bouton.
Le paiement a abouti, mais la commande reste en Paiement en attente : l'extension n'a pas de webhook, le paiement n'est donc confirmé que pendant la page de paiement. Cela arrive lorsque PayPal n'a pas répondu pendant la capture. Lisez la note de commande, vérifiez le paiement dans votre compte PayPal et finalisez la commande manuellement, ou laissez le client réessayer : une nouvelle tentative ne débite jamais deux fois.
PayPal n'est pas disponible pour le moment : les identifiants sont incorrects ou appartiennent à l'autre mode. Recopiez le Client ID et le Secret de la bonne application.
Votre approbation PayPal n'a pas pu être associée à cette page de paiement : la commande PayPal n'a pas été créée pendant cette session de paiement, par exemple après l'expiration de la session. Le client clique à nouveau sur le bouton PayPal.
La commande est En attente après le paiement : lisez la note de commande. Le paiement a été autorisé (capturez-le avec Capture PayPal payment), la capture est PENDING chez PayPal (utilisez plus tard Check PayPal payment status), ou le montant ou la devise payés ne correspondaient pas à la commande.
La capture d'une autorisation échoue : l'autorisation peut dater de plus de 29 jours ou avoir déjà été annulée. La note de commande affiche l'erreur PayPal.
Le remboursement échoue : la commande n'a pas de capture PayPal (seulement une autorisation), ou les identifiants de l'environnement dans lequel le paiement a été effectué sont absents. Les développeurs peuvent modifier la liste des devises avec le filtre wc_plg_supported_currencies.
Le bloc de licence affiche une erreur : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net et cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé sur le nouveau domaine. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.
Désinstallation
Désactiver l'extension conserve toutes les données. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension sont toujours supprimés. Les réglages de la passerelle et les jetons d'accès PayPal en cache ne sont supprimés que si Delete data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes existantes conservent leurs notes de paiement, identifiants de transaction et identifiants PayPal.
PayPal est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à PayPal ni approuvée par PayPal.