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

Devise et montants : euro (EUR), de 0,99 à 20 000,00 par paiement, les valeurs par défaut de PayPlug. Avec une autre devise ou en dehors de ces limites, le moyen de paiement est masqué.

Compte PayPlug : vous avez besoin des clés secrètes de votre compte PayPlug : la clé de test (sk_test_...) et/ou la clé de production (sk_live_...). Aucune autre clé n'est nécessaire, et aucune notification n'a besoin d'être configurée dans PayPlug. Votre site doit être accessible depuis Internet pour recevoir les notifications ; sinon, les commandes sont mises à jour lorsque le client revient de PayPlug.

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_payplug_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > PayPlug > Manage, ou cliquez sur Settings sous le nom de l'extension dans la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. Collez vos clés secrètes provenant du portail PayPlug (voir Configuration).

6. Activez Enable/Disable et enregistrez. Testez un paiement avec Test Mode activé, puis désactivez-le pour accepter des paiements réels.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > PayPlug. Au-dessus des champs, la page vous avertit lorsque le moyen de paiement est activé mais que la clé secrète du mode actuel est vide, et lorsque la devise de la boutique n'est pas l'EUR. Dans les deux cas, le moyen de paiement est masqué sur la page de paiement. Dans la liste des moyens de paiement, PayPlug affiche un badge de mode test en mode test et est signalé comme nécessitant une configuration tant que le mode actuel n'a pas de clé secrète.

Paiement

Enable/Disable : Enable PayPlug 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 : PayPlug.

Description : le texte affiché sous le moyen de paiement sur la page de paiement. Par défaut : Pay securely by card via PayPlug.

Clés d'API

Retrouvez vos clés secrètes dans le portail PayPlug, sous Developers > API keys. La section affiche aussi l'URL de notification que l'extension transmet avec chaque paiement. Elle ressemble à ceci : https://your-site/wc-api/ppg_payplug_webhook/. Aucune configuration de notification n'est nécessaire dans PayPlug.

Test Mode : Enable test mode utilise la clé secrète de test pour les nouveaux paiements. Aucun paiement réel n'est traité. Les paiements effectués dans l'autre mode continuent d'utiliser la clé de leur propre mode pour les vérifications de statut et les remboursements. Par défaut : on.

Test Secret Key : votre clé secrète de test PayPlug. Elle commence par sk_test_.

Live Secret Key : votre clé secrète de production PayPlug. Elle commence par sk_live_.

Une clé avec un mauvais préfixe n'est pas enregistrée. La page affiche par exemple Test Secret Key doit commencer par « sk_test_ ». La valeur précédente a été conservée.

Commandes

Order Status After Payment : le statut de commande défini après un paiement réussi. Le statut est défini immédiatement, sans second changement de statut.

Avancé

Logging : Enable debug logging journalise les appels API et les notifications dans WooCommerce > Status > Logs, source wcp_payplug_gateway. Les erreurs sont toujours journalisées. Les clés secrètes, les données de carte et les données clients ne sont jamais journalisées. Par défaut : off.

Delete Data on Uninstall : Remove all plugin data when uninstalling. Lorsque la case est cochée, les réglages de l'extension et ses journaux sont supprimés à la suppression de l'extension. Les identifiants de paiement PayPlug enregistrés dans les commandes sont conservés. Par défaut : off.

Paiement

Le client choisit le moyen de paiement (par défaut PayPlug) et valide la commande. En mode test, la page de paiement affiche Mode test : aucun paiement réel ne sera effectué. L'extension crée un paiement PayPlug pour le total de la commande en centimes et envoie le client sur la page de paiement PayPlug. Les coordonnées de facturation et de livraison de la commande ainsi que la langue de votre site sont transmises à PayPlug. Le client y paie par carte.

Après le paiement, le client revient sur votre boutique. La commande n'est marquée payée qu'après confirmation de PayPlug : l'extension lit le paiement depuis l'API PayPlug lorsque la notification arrive et lorsque le client revient. Un paiement réussi conduit le client à la page de confirmation de commande.

Si le client annule sur la page PayPlug, la page de paiement est fermée chez PayPlug, de sorte qu'elle ne peut pas être payée plus tard par erreur. Le client revient sur la page Pay for order avec un message, par exemple Vous avez annulé le paiement PayPlug. Vous pouvez réessayer ou choisir un autre moyen de paiement., La session de paiement PayPlug a expiré. Veuillez réessayer ou choisir un autre moyen de paiement. ou Le paiement PayPlug a échoué. Veuillez réessayer ou choisir un autre moyen de paiement.

Lorsque le client paie à nouveau la même commande, l'extension examine d'abord la tentative précédente. Si elle a été payée entre-temps, la commande est finalisée sans nouveau paiement. Si elle est encore ouverte pour le même montant, la même page de paiement est réutilisée. Sinon, l'ancienne page est fermée chez PayPlug et un nouveau paiement est créé.

Si PayPlug ne peut pas démarrer le paiement, le client voit un court message, par exemple PayPlug n'a pas pu accepter vos coordonnées de facturation (code postal). Veuillez les vérifier et réessayer. ou Le prestataire de paiement est injoignable. Veuillez réessayer dans un instant. La raison technique est ajoutée aux notes de commande.

Le moyen de paiement fonctionne sur la page de paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec le stockage haute performance des commandes de WooCommerce (HPOS).

Les paiements sont capturés immédiatement. L'extension ne propose ni paiement en plusieurs fois Oney, ni Bancontact, Apple Pay ou American Express, ni cartes enregistrées en un clic, ni formulaire de paiement intégré, ni abonnements, ni capture différée.

Commandes et remboursements

Order statuses

Pending payment : le client a été redirigé vers PayPlug et n'a pas encore payé, ou PayPlug n'a pas encore confirmé le paiement.

Processing or Completed : le paiement a été confirmé. Le statut suit Order Status After Payment. La note de commande indique le paiement PayPlug et son mode. L'identifiant de transaction est l'identifiant du paiement PayPlug (pay_...).

On hold : le montant ou la devise payés diffèrent de la commande (note amount/currency mismatch) ; ou un paiement de test a été effectué alors que la boutique est en mode production, de sorte qu'aucun argent n'a été reçu ; ou le paiement est arrivé pour une commande annulée ; ou un paiement est autorisé mais non capturé (capturez-le dans le portail PayPlug ; la commande est marquée payée lorsque PayPlug la signale comme payée). La note de commande explique ce qu'il faut vérifier.

Failed : la dernière tentative de paiement d'une commande en attente a échoué ou a été annulée. L'échec d'une tentative plus ancienne ne modifie pas la commande. Le client peut payer à nouveau.

Si une seconde tentative sur une commande déjà payée est également payée, la commande n'est pas modifiée. Une note vous demande de rembourser le paiement en double dans le portail PayPlug.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via PayPlug. Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé au paiement qui a réellement réglé la commande, avec la clé secrète du mode (test ou production) dans lequel il a été effectué ; cette clé doit donc être renseignée. Si PayPlug 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 de remboursement PayPlug.

Les remboursements effectués dans le portail PayPlug arrivent par notification et sont ajoutés aux notes de commande. Ils ne sont pas créés automatiquement dans WooCommerce. Enregistrez-les manuellement si besoin.

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 > PayPlug. 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, PayPlug 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 paiements déjà lancés sont toujours confirmés, et les remboursements fonctionnent.

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

PayPlug n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le mode actuel possède une clé secrète (Test Secret Key en mode test, Live Secret Key en mode production), que la devise de la boutique est l'EUR et que le total de la commande est compris entre 0,99 et 20 000,00 EUR. Les comptes ayant d'autres limites peuvent les modifier avec le filtre ppg_amount_limits (valeurs en centimes).

Le paiement a abouti, mais la commande reste en Paiement en attente : la notification n'a pas atteint votre boutique et le client n'est pas revenu. Vérifiez que votre site est accessible depuis Internet à l'URL de notification affichée dans les réglages, par exemple qu'aucun mode maintenance, pare-feu ou protection par mot de passe ne le bloque. Consultez WooCommerce > Status > Logs, source wcp_payplug_gateway, pour voir les notifications rejetées.

La notification répond Verification failed : le paiement n'a pas pu être lu depuis l'API PayPlug, par exemple parce que PayPlug n'a pas répondu. La commande n'est pas modifiée, et PayPlug renvoie la notification.

La notification répond Busy, retry : la commande était en cours de mise à jour par une autre requête au même moment, par exemple le retour du client. PayPlug renvoie la notification.

La notification répond Unknown payment ou Payment does not belong to the order : le paiement n'a pas été créé par cette boutique ou ne concerne pas cette commande, par exemple un paiement d'une autre boutique sur le même compte PayPlug. Il est ignoré.

Le client voit Payment could not be initiated : la tentative de paiement précédente de la commande est en cours de confirmation, ou PayPlug a refusé la demande. Patientez un instant puis réessayez ; les notes de commande affichent l'erreur PayPlug.

La commande est En attente après le paiement : lisez la note de commande. Le montant ou la devise payés ne correspondaient pas à la commande, un paiement de test a été effectué alors que la boutique est en production, ou le paiement est arrivé après l'annulation de la commande. Traitez la commande ou remboursez le paiement.

Le remboursement échoue avec un message concernant le mode : le paiement a été effectué en mode test ou production, et la clé secrète de ce mode n'est pas configurée. Saisissez-la et réessayez.

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 journaux 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 de paiement PayPlug.

PayPlug est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à PayPlug ni approuvée par PayPlug.