VibeFox PayU for WooCommerce — Aide

Prérequis

WordPress: 5.8 ou ultérieur.

WooCommerce: 7.0 ou ultérieur, installé et actif. L'extension refuse de s'activer sans lui ; si WooCommerce est désactivé ultérieurement, l'extension n'effectue aucune action et affiche une notification dans la zone d'administration.

PHP: 8.0 ou ultérieur.

Devise de la boutique : l'une des devises PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH. La devise doit également être activée pour votre point de vente chez PayU. Pour les autres devises, le moyen de paiement est masqué sur la page de paiement.

Accès Internet à votre site : PayU envoie des notifications de paiement à votre boutique, le site doit donc être accessible depuis Internet (pas derrière une authentification HTTP ou une page de maintenance). Sans notifications, les commandes sont tout de même contrôlées lorsque le client revient de PayU.

Compte PayU : vous avez besoin de quatre clés de votre point de vente (POS) : POS ID, Second Key (MD5), client_id OAuth et client_secret OAuth. Elles se trouvent dans l'espace marchand PayU sous Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Les clés sandbox proviennent d'un compte sandbox PayU distinct.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un 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 également téléverser le dossier wcp_payu_payment dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

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

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

5. Saisissez les quatre clés Sandbox et les quatre clés Live (voir Configuration). Aucune URL de notification n'a besoin d'être configurée dans PayU.

6. Activez Enable/Disable. Laissez Test Mode activé jusqu'à ce que vous ayez effectué un paiement de test, puis décochez-le pour accepter de vrais paiements avec les clés Live.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > PayU. Au-dessus des champs, la page vous avertit tant que le mode sandbox est actif, lorsqu'une des quatre clés du mode en cours est manquante et lorsque PayU n'accepte pas la devise de la boutique. Dans ces deux derniers cas, PayU n'est pas affiché sur la page de paiement.

Lors de l'enregistrement, les espaces et les sauts de ligne sont supprimés de toutes les clés, car la copie depuis le panneau PayU en ajoute fréquemment.

Général

Enable/Disable: Enable PayU payment gateway active ou désactive le moyen de paiement. Par défaut : désactivé.

Title: le titre du moyen de paiement affiché au client. Par défaut : PayU.

Description: la description du moyen de paiement affichée au client. Par défaut : Pay securely via PayU.

Identifiants API

Retrouvez les clés dans l'espace marchand PayU : Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Les clés sandbox proviennent d'un compte sandbox PayU distinct. Les quatre clés d'un mode doivent être renseignées.

Test Mode: Enable sandbox (test) mode. Utilise le sandbox PayU et les clés Sandbox ci-dessous. Aucun argent réel n'est débité. Sur le paiement classique et le bloc Paiement, le client voit Sandbox mode — no real money is charged. Désactivez-le pour accepter de vrais paiements avec les clés Live. Par défaut : activé.

Live POS ID: le POS ID (merchantPosId) de votre point de vente de production.

Live Second Key (MD5): utilisée pour vérifier la signature des notifications PayU.

Live OAuth Client ID: le client_id OAuth du point de vente.

Live OAuth Client Secret: le client_secret OAuth du point de vente.

Sandbox POS ID: le POS ID de votre point de vente sandbox PayU.

Sandbox Second Key (MD5): utilisée pour vérifier la signature des notifications sandbox PayU.

Sandbox OAuth Client ID: le client_id OAuth du point de vente sandbox.

Sandbox OAuth Client Secret: le client_secret OAuth du point de vente sandbox.

Chaque paiement conserve en mémoire son environnement. Les notifications, vérifications d'état et remboursements d'un paiement utilisent toujours les clés de cet environnement, de sorte que les paiements antérieurs continuent de fonctionner après un changement. Une notification signée avec la clé sandbox n'est jamais acceptée pour un paiement live.

Notifications de paiement

Cette section affiche l'URL de notification, qui se présente sous la forme https://your-site/wc-api/wc_pu_payment/. L'extension l'envoie à PayU lors de chaque paiement, il n'y a donc rien à configurer dans le panneau PayU. Assurez-vous qu'elle est accessible depuis Internet (non bloquée par un pare-feu, un mode maintenance ou une authentification HTTP).

Avancé

Receive payments automatically: Automatically receive payments waiting for confirmation. Cela ne s'applique que si la réception automatique est désactivée pour votre point de vente dans le panneau PayU : les paiements restent alors en attente de confirmation (WAITING_FOR_CONFIRMATION). Lorsque cette option est activée, l'extension réceptionne ces paiements immédiatement. Lorsqu'elle est désactivée, ces commandes sont mises en attente et vous réceptionnez ou annulez le paiement avec les actions de commande Receive PayU payment et Cancel PayU payment. Par défaut : activé.

Logging: Enable logging consigne les événements techniques (numéros de commande, identifiants de commande PayU, statuts, erreurs, sans clés ni données personnelles) dans WooCommerce > Status > Logs, source wcp_payu_payment. Par défaut : désactivé.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Les commandes et leurs données de paiement ne sont jamais supprimées. La désactivation de l'extension conserve l'ensemble des données. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut PayU) et valide sa commande. L'extension crée une commande PayU pour le montant total de la commande dans la devise de celle-ci, avec la description Order #, le numéro de commande et le nom de votre boutique, ainsi que les articles commandés, la livraison et les frais pour affichage sur la page PayU. La langue de la page PayU suit celle de la boutique lorsque PayU la prend en charge, sinon l'anglais. Le client est redirigé vers la page de paiement PayU, y choisit un moyen de paiement et règle sa commande.

Chaque tentative de paiement reçoit sa propre commande PayU. Lorsque le client effectue une nouvelle tentative de paiement (après un paiement échoué ou annulé, ou depuis la page Pay for order), le paiement PayU inachevé précédent de la commande est annulé auprès de PayU, évitant ainsi qu'un ancien lien de paiement ne soit réglé deux fois.

Le simple retour sur votre boutique ne valide jamais une commande comme payée. La commande n'est marquée payée qu'une fois confirmée par PayU : soit par une notification signée avec la Second Key de l'environnement du paiement, soit par une vérification de l'état de la commande PayU sur le serveur au retour du client (utile en cas de notification retardée). La commande PayU doit correspondre à celle créée pour cette commande, et le montant ainsi que la devise doivent correspondre. L'extension gère les statuts PayU suivants :

Sur la page de commande reçue, tant que la commande est en « En attente de paiement », le client voit We have not received the payment confirmation from PayU yet. If the payment was interrupted, you can try again: ou, après un paiement échoué, The payment was not completed. You can try again:, chacun avec un bouton Pay again. Pour une commande mise en attente, le message est Your payment is being verified. We will send you an e-mail as soon as it is confirmed.

Si PayU ne peut pas initialiser le paiement, le client voit Payment error. Please try again or choose another payment method. La raison technique (code HTTP et statut PayU) est inscrite dans le journal et dans une note de commande PayU payment could not be started:. Si les clés du mode en cours sont manquantes, le message est Payment gateway is not configured properly. Please contact the administrator.

Le moyen de paiement fonctionne sur le paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec le High-Performance Order Storage (HPOS) de WooCommerce.

Le client choisit le mode de paiement sur la page PayU, non sur votre page de paiement. L'extension ne comporte aucun formulaire de carte sur votre boutique, pas de cartes enregistrées ni de paiement en un clic, pas d'abonnements et pas de widgets de crédit ou de paiement échelonné PayU. Elle utilise un seul point de vente par environnement (aucun point de vente par devise).

Commandes et remboursements

Statuts de commande

Pending payment: le client a été redirigé vers PayU et n'a pas encore payé. La note de commande indique l'identifiant de commande PayU et l'environnement (sandbox ou live).

Processing: le paiement a été confirmé. La note de commande indique l'identifiant de commande PayU, le montant et l'environnement. L'identifiant de transaction correspond à l'identifiant de commande PayU qui a été payé. Les commandes composées uniquement de produits virtuels téléchargeables passent à Terminée, conformément au comportement par défaut de WooCommerce.

On hold: le montant payé ou la devise ne correspondait pas à la commande, un paiement a été effectué pour une commande qui avait été annulée, ou un paiement attend votre confirmation (réception automatique désactivée ou échec de réception). La note de commande précise la situation et les démarches à suivre.

Failed: le dernier paiement PayU a été annulé ou refusé. Le client peut réessayer de payer.

Chaque notification est traitée une seule fois, sous un verrou par commande : les notifications répétées n'ajoutent pas de notes, ne réduisent pas les stocks et n'envoient pas d'e-mails en double. Si un autre paiement est validé pour une commande déjà payée ou remboursée, une note vous invite à la rembourser dans le panneau PayU. Un paiement en attente de confirmation associé à une commande déjà payée ou clôturée est annulé automatiquement, afin d'éviter tout double encaissement.

Paiements en attente de confirmation

Pour une commande impayée associée à un paiement en attente de confirmation, l'écran de commande propose deux actions de commande : Receive PayU payment (waiting for confirmation) et Cancel PayU payment (release the funds). Choisissez-en une et cliquez sur le bouton de mise à jour. L'action est consignée dans les notes de commande avec votre nom d'utilisateur, et le nouveau statut PayU est appliqué immédiatement.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via PayU (le bouton affiche votre Title). Les remboursements totaux et partiels sont pris en charge. Le remboursement est transmis pour la commande PayU réellement payée, avec les clés de l'environnement du paiement, ces clés doivent donc être configurées. Le motif du remboursement est transmis en tant que description de remboursement. Si PayU rejette le remboursement, WooCommerce affiche l'erreur de PayU et aucun remboursement n'est enregistré.

Les remboursements sont asynchrones chez PayU. L'extension ajoute immédiatement une note contenant l'identifiant de remboursement PayU et son statut ; le statut final arrive ultérieurement sous forme de notification PayU et est consigné dans une note. Si PayU annule un remboursement, la note signale que les fonds n'ont pas été restitués au client.

Les commandes mises en attente en raison d'un montant ou d'une devise non concordants conservent l'identifiant de commande PayU comme identifiant de transaction, ce qui permet de rembourser le paiement depuis WooCommerce ainsi que dans le panneau PayU.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox achetée sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > PayU. 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 ainsi que votre domaine. Utilisez Check now pour revérifier 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 domaine. Supprimer la clé d'un site ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, PayU n'est pas affiché aux clients sur la page de paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Les gestionnaires de boutique connectés voient toujours le moyen de paiement avec la mention (unlicensed — visible to admins only), ce qui vous permet de configurer et tester l'extension avant d'acheter une clé. Un rappel s'affiche sur la page Extensions et sur les pages de WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà initiés continuent d'être 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 revérifié automatiquement en arrière-plan.

Dépannage

PayU n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé et que les quatre clés du mode sélectionné sont renseignées : les clés Sandbox en mode sandbox, les clés Live en mode live. Vérifiez que la devise de la boutique (ou la devise de la commande sur la page Pay for order) figure parmi les devises prises en charge. La page des réglages affiche un avertissement pour chacun de ces problèmes.

Le paiement a réussi, mais la commande reste en En attente de paiement : PayU n'a pas encore délivré la notification et le contrôle d'état sur la page de retour n'a pas détecté de paiement abouti. Vérifiez que l'URL de notification indiquée dans les réglages est accessible depuis Internet. Activez Logging pour examiner les événements reçus.

La notification répond Invalid signature : la notification n'a pas été signée avec la Second Key de l'un des environnements. Vérifiez Live Second Key (MD5) et Sandbox Second Key (MD5). La réponse Invalid signature for this payment indique que la notification a été signée avec la clé d'un environnement distinct de celui du paiement.

La notification répond Ignored : la commande PayU n'appartient à aucune commande de cette boutique réglée avec PayU, par exemple une autre boutique sur le même point de vente. PayU cesse ses tentatives.

Le paiement n'est pas créé : activez Logging et consultez WooCommerce > Status > Logs, source wcp_payu_payment. Le journal affiche le code HTTP et le statut PayU. Could not authenticate with PayU (check the OAuth client ID / secret). indique des clés OAuth erronées pour le mode sélectionné.

La commande est En attente : consultez la note de commande. La cause est une non-concordance de montant ou de devise, un paiement reçu après annulation ou un paiement en attente de confirmation. Dans ce dernier cas, utilisez les actions de commande Receive PayU payment ou Cancel PayU payment.

Le remboursement échoue : This order has no completed PayU payment. Cannot process refund. indique que la commande ne comporte aucune commande PayU payée. Un message signalant que les clés Sandbox ou Live sont manquantes signifie que le paiement a été effectué dans cet environnement et que ses clés ne sont pas configurées. Renseignez-les et réessayez.

Autres devises : les développeurs peuvent modifier la liste des devises via le filtre wc_pu_supported_currencies et l'icône de paiement via le filtre wc_pu_icon.

Le bloc de licence affiche une erreur : suivez les instructions du message. 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é pour le nouveau domaine. Si le serveur de licences est inaccessible, l'extension continue de fonctionner avec le dernier statut connu.

Désinstallation

Désactiver l'extension conserve l'ensemble des réglages ; seuls les jetons d'accès PayU mis en cache sont purgés. Pour la supprimer, désactivez-la et supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension sont systématiquement supprimés, de même que les jetons en cache. Les réglages de la passerelle et le journal de cette extension 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 commande PayU et identifiants de transaction.

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