VibeFox PayU for OpenCart — Aide

Prérequis

OpenCart : 3.0.x (testé avec la version 3.0.5.0) ou 4.0.2 et ultérieures (testé avec la version 4.1.0.3).

PHP : 8.0 ou ultérieur, avec l'extension cURL.

Devise : la devise de paiement du client doit faire partie de 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 mode de paiement n'est pas proposé lors du paiement.

Accès à Internet pour votre boutique : PayU envoie les notifications de paiement à votre boutique ; celle-ci doit donc être accessible depuis Internet (et non protégée par une authentification HTTP ou bloquée par un pare-feu). Sans notifications, les paiements sont tout de même vérifiés 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), OAuth client_id et OAuth client_secret. Elles se trouvent dans le panneau 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 pour un seul domaine.

Installation

Le téléchargement est un fichier zip unique contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_payu_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_payu_payment.ocmod.zip. Installez uniquement le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_payu_payment-oc3-(version).ocmod.zip. L'extension ne comporte aucune modification OCMOD : il n'est donc pas nécessaire d'actualiser Extensions > Modifications. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de ce paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox PayU Payment et cliquez sur Install (le bouton vert +). Votre utilisateur administrateur doit avoir le droit de modifier la liste des extensions de paiement.

3. Cliquez sur Edit (le bouton en forme de crayon) pour ouvrir la page des réglages. Collez votre clé de licence VibeFox dans le champ License key du bloc de licence situé en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Saisissez les quatre clés Sandbox et les quatre clés Live (voir Configuration). Aucune URL de notification n'est à configurer dans PayU.

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

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_payu_payment.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension à partir du nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées sur la même page. Cliquez sur Install (le bouton vert +) à côté.

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox PayU Payment, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence et les clés PayU comme aux étapes 3 à 5 pour OpenCart 3. La page des réglages et ses champs sont les mêmes dans les deux versions. Seule l'URL de notification diffère (voir Notifications de paiement).

Une nouvelle installation démarre avec le mode de paiement désactivé et le mode test activé.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox PayU Payment > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre la page entière. Au-dessus des réglages, la page vous avertit lorsque le mode sandbox est activé (Le mode sandbox (test) est activé : les paiements sont envoyés au sandbox PayU et aucun argent réel n'est débité. N'expédiez pas les commandes payées en mode test.), lorsqu'une des quatre clés du mode actuel manque (PayU n'est alors pas affiché lors du paiement) et lorsque PayU n'accepte pas la devise par défaut de la boutique (PayU est alors masqué pour les commandes dans cette devise). Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

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 ajoute souvent ces caractères. Title ne doit pas être vide ni dépasser 128 caractères (la page affiche Saisissez un titre pour le mode de paiement (128 caractères maximum).), Sort Order doit être un nombre entier (les nombres négatifs sont acceptés), Total doit être un nombre, égal ou supérieur à 0, et la zone géographique et les statuts de commande doivent exister. Sinon, rien n'est enregistré. L'enregistrement des réglages supprime également les jetons d'accès PayU mis en cache.

PayU

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

Title : le nom du mode de paiement affiché au client lors du paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : PayU. Obligatoire, 128 caractères maximum.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : Pay securely via PayU.

Sort Order : la position de PayU parmi les modes de paiement lors du paiement. Laissez le champ vide ou saisissez un nombre entier.

Geo Zone : proposer PayU uniquement pour les adresses de facturation situées dans la zone géographique sélectionnée. Par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

Total : le montant total du panier, dans la devise par défaut de la boutique, qu'une commande doit atteindre pour que PayU soit proposé. Laissez le champ vide pour proposer PayU quel que soit le montant.

Identifiants API

Trouvez les clés dans le panneau 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 toutes être renseignées. La section contient des liens vers la documentation développeur de PayU.

Test Mode : utilise le sandbox PayU et les clés Sandbox ci-dessous. Aucun argent réel n'est débité. Tant qu'il est activé, les clients voient Mode sandbox : aucun paiement réel n'est effectué. à l'étape Confirm Order. 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) : sert à 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 PayU sandbox.

Sandbox Second Key (MD5) : sert à vérifier la signature des notifications du 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.

Les Second Keys et les client secrets enregistrés ne sont jamais réaffichés. Le champ reste vide et affiche Enregistré — laissez vide pour le conserver. Ne saisissez une nouvelle valeur que pour la modifier. Les POS ID et les client ID sont affichés tels qu'enregistrés.

Clear saved secrets : cochez un secret et cliquez sur Save pour le supprimer. Un champ vide conserve la valeur enregistrée.

Chaque paiement mémorise son environnement. Les notifications, les vérifications de statut, la réception ou l'annulation d'un paiement, ainsi que les remboursements utilisent toujours les clés de cet environnement ; les anciens paiements continuent donc de fonctionner après un changement de mode. Une notification signée avec la clé sandbox n'est jamais acceptée pour un paiement réel, et inversement.

Statuts de commande

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). La commande ne reçoit un statut qu'après confirmation du paiement par PayU, soit par une notification signée, soit par la vérification du statut lorsque le client revient. OpenCart ne dispose pas du statut On hold : les statuts d'attente sont par défaut Pending, et l'onglet PayU de la commande ainsi que ses notes expliquent la raison. Chaque champ ci-dessous liste vos statuts de commande OpenCart ; vous pouvez créer vos propres statuts dans System > Localisation > Order Statuses.

Order Status After Payment : défini lorsque PayU confirme le paiement (COMPLETED) et que le montant et la devise correspondent. Par défaut : Processing.

Awaiting PayU Payment Confirmation : le paiement est autorisé et attend d'être reçu (réception automatique désactivée ou échouée). Utilisez Receive PayU payment ou Cancel PayU payment dans l'onglet PayU de la commande. Par défaut : Pending.

PayU Payment On Hold : le montant payé ou la devise ne correspond pas à la commande, ou un paiement a été finalisé pour une commande annulée. La commande n'est pas marquée comme payée ; la note indique la raison. Par défaut : Pending.

Payment Error Status : le paiement d'une commande en attente de confirmation a été annulé ou refusé. Par défaut : Failed.

Cancelled Order Status : un paiement PayU finalisé pour une commande dans ce statut met la commande en attente au lieu de la rouvrir silencieusement. L'extension ne définit jamais ce statut. Par défaut : Canceled.

Refunded Status : défini après un remboursement total du paiement depuis l'onglet PayU de la commande. Par défaut : Refunded.

Notifications de paiement

Notification URL : affiche l'adresse à laquelle PayU envoie les notifications. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_payu_payment/notify, sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_payu_payment/payment/wcp_payu_payment.notify. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. L'extension l'envoie à PayU à 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 ou une authentification HTTP). Les notifications fonctionnent aussi lorsque la boutique est en mode maintenance (sur OpenCart 4 grâce à l'action de démarrage de l'extension, qui permet aussi au client de revenir depuis PayU). Les notifications sans signature valide sont rejetées.

Avancé

Receive payments automatically : reçoit automatiquement les paiements en attente de confirmation. Cela n'a d'effet que si la réception automatique est désactivée pour votre point de vente dans le panneau PayU : les paiements attendent alors une confirmation (WAITING_FOR_CONFIRMATION). Lorsque cette option est activée, l'extension reçoit ces paiements immédiatement, et la commande passe à son statut payé dès que PayU signale le paiement comme finalisé. Lorsqu'elle est désactivée, ou si la réception échoue, la commande reçoit Awaiting PayU Payment Confirmation, et vous recevez ou annulez le paiement avec les boutons de l'onglet PayU de la commande. Par défaut : activé.

Logging : enregistre les événements techniques (numéros de commande, identifiants de commande PayU, statuts, erreurs ; aucune clé ni donnée personnelle) dans wc_pu_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web. Les erreurs sont toujours enregistrées ; les autres événements ne le sont que lorsque cette option est activée. Par défaut : désactivé.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Delete data on uninstall : lorsqu'elle est activée, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les commandes et leurs données de paiement (transactions et remboursements PayU) ne sont jamais supprimées. Les jetons d'accès PayU mis en cache sont toujours supprimés. Par défaut : désactivé.

Import / Export

Export : Download JSON enregistre les réglages dans un fichier JSON. Les secrets ne sont pas exportés.

Import : collez le JSON précédemment exporté et cliquez sur Import pour restaurer les réglages. Les secrets enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut PayU). À l'étape Confirm Order, le client voit votre description et la note Vous serez redirigé vers PayU pour finaliser le paiement (BLIK, virement bancaire, carte et autres moyens). OpenCart crée la commande à cette étape, toujours sans statut. Sur OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc du mode de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas du tunnel de paiement. Lorsque le client clique sur Confirm Order, l'extension crée une commande PayU pour le total de la commande dans la devise de la commande, avec la description Order #, le numéro de commande et le nom de votre boutique, ainsi que les produits, le mode de livraison et les autres lignes de total de la commande, pour affichage sur la page PayU. L'adresse e-mail, le nom et le téléphone du client sont transmis à PayU, et la langue de la page PayU suit la langue de la vitrine. Le client est envoyé sur la page PayU, y choisit un moyen de paiement et paie.

Chaque tentative obtient sa propre commande PayU. Lorsque le client réessaie (OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order, OpenCart 4 met à jour la commande du tunnel de paiement), les paiements PayU non terminés des tentatives précédentes de la même commande et du même panier sont annulés chez PayU, afin qu'un ancien lien de paiement ne puisse pas être payé deux fois. Si un paiement précédent se révèle déjà payé, il est pris en compte à la place, et une commande ou un panier déjà payé, en attente ou en attente de confirmation est directement redirigé vers la page de succès, sans second paiement. Une modification du panier, y compris une nouvelle quantité, est considérée comme un nouveau panier qui nécessite son propre paiement.

Le retour du client dans votre boutique ne règle jamais une commande à lui seul. La commande n'est marquée payée qu'après confirmation de PayU : par une notification signée avec la Second Key de l'environnement du paiement, ou par une vérification du statut de la commande PayU côté serveur lorsque le client revient (au plus une fois toutes les 10 secondes par paiement). Le montant et la devise doivent correspondre. La commande reçoit ensuite son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour des stocks. L'extension gère ces statuts PayU :

Après un paiement confirmé, le client voit la page de succès de commande d'OpenCart. Pour une commande en attente de confirmation ou en attente, la page ajoute Votre paiement est en cours de vérification. Nous vous enverrons un e-mail dès qu'il sera confirmé. Lorsqu'une telle commande est payée par la suite ou que son paiement échoue, OpenCart informe le client du nouveau statut. Si le paiement de la commande a échoué, la page affiche Votre paiement PayU n'a pas été finalisé. Veuillez nous contacter au sujet de cette commande.

Si PayU n'a pas encore confirmé le paiement lorsque le client revient, une page Payment confirmation affiche Nous n'avons pas encore reçu la confirmation de paiement de PayU. Si le paiement a été interrompu, vous pouvez réessayer : (ou, lorsque PayU a signalé une erreur, Le paiement n'a pas été finalisé. Vous pouvez réessayer :) avec les boutons Pay again (retour au paiement) et Check again. La notification définit le statut de la commande dès son arrivée. Si le paiement a été annulé, le client revient au paiement avec Le paiement n'a pas été finalisé. Vous pouvez réessayer ou choisir un autre mode de paiement. Le panier est conservé. Sur OpenCart 4, ce message s'affiche au-dessus du tunnel de paiement.

Sur OpenCart 4, la commande est conservée jusqu'à l'affichage de la page de succès. Si cette commande a été fermée entre-temps (par exemple si son paiement en attente de confirmation a été annulé, ou si vous l'avez annulée ou remboursée), le client est renvoyé au tunnel de paiement avec le message Votre commande précédente a été fermée (non payée, annulée ou remboursée). Veuillez confirmer à nouveau la commande pour payer avec une nouvelle commande. Lorsque le client revient de PayU vers une commande fermée sans paiement, le message est Le paiement n'a pas été finalisé. Vous pouvez réessayer ou choisir un autre mode de paiement. Si cette commande avait déjà été payée pour un panier antérieur et que le panier a changé depuis, le client est ramené au tunnel de paiement. Dans tous les cas, le prochain Confirm Order paie une nouvelle commande du panier actuel. Une commande fermée n'est jamais affichée comme payée.

Si PayU ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec Erreur de paiement. Veuillez réessayer ou choisir un autre mode de paiement. La cause technique est écrite dans le journal. Si les clés du mode actuel manquent, le message est La passerelle de paiement n'est pas correctement configurée. Veuillez contacter l'administrateur.

Le client choisit le mode de paiement sur la page PayU, et non dans votre tunnel de paiement. L'extension n'a pas de formulaire de carte sur votre site, pas de cartes enregistrées ni de paiement en un clic, pas d'abonnements, ni de widgets de paiement en plusieurs fois ou de crédit PayU. Elle utilise un point de vente par environnement.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé vers PayU et n'a pas payé, le paiement a été annulé, ou PayU n'a pas encore confirmé le paiement. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders.

Order Status After Payment (par défaut Processing) : le paiement a été confirmé. Une note affiche l'identifiant de commande PayU, le montant et l'environnement (sandbox ou live).

Awaiting PayU Payment Confirmation (par défaut Pending) : le paiement est autorisé et attend votre action (réception automatique désactivée, ou réception échouée).

PayU Payment On Hold (par défaut Pending) : le montant payé ou la devise ne correspondait pas à la commande, un paiement en attente de confirmation avait un autre montant, ou un paiement a été finalisé pour une commande qui avait été annulée. La note indique laquelle de ces situations s'est produite. Vérifiez la commande et exécutez-la, ou remboursez le paiement.

Payment Error Status (par défaut Failed) : le paiement d'une commande en attente de confirmation a été annulé ou refusé.

Refunded Status (par défaut Refunded) : le paiement a été intégralement remboursé via l'extension.

Chaque notification est traitée une seule fois : les notifications répétées n'ajoutent pas de notes et ne modifient pas à nouveau la commande. Si un autre paiement est finalisé pour une commande déjà payée ou remboursée, ou pour une autre commande d'un panier déjà payé, une note sur la commande payée vous invite à le rembourser dans le panneau PayU. Un paiement en attente de confirmation sur une commande déjà payée ou clôturée est annulé automatiquement, afin que l'argent ne soit pas prélevé deux fois.

Les notes sont des entrées de l'History de la commande, que le client ne voit pas.

Onglet VibeFox PayU Payment

Dans Sales > Orders, ouvrez une commande payée avec PayU. En bas de la page de commande, à côté de History et Additional, l'onglet VibeFox PayU Payment affiche le PayU order ID, avec une étiquette Sandbox pour les paiements sandbox, l'extOrderId, le PayU status, le Payment amount, les montants Paid / refunded, le formulaire de remboursement, l'historique des Refunds, les PayU payment attempts de la commande et les PayU notes. L'onglet est affiché aux utilisateurs ayant accès à l'extension ; ses actions nécessitent le droit de modifier l'extension (défini dans System > Users > User Groups).

Paiements en attente de confirmation

Pour une commande dont le paiement attend une confirmation, l'onglet affiche Receive PayU payment et Cancel PayU payment. Après avoir confirmé la question, l'action est envoyée à PayU avec les clés de l'environnement du paiement, ajoutée aux notes avec votre nom d'utilisateur, et le nouveau statut PayU est appliqué immédiatement : un paiement reçu définit Order Status After Payment, un paiement annulé définit Payment Error Status.

Remboursements

Dans l'onglet, saisissez le Amount (le montant non encore remboursé est pré-rempli), éventuellement un Reason (optional), puis cliquez sur Refund via PayU. Confirmez la question Refund this amount through PayU? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Les remboursements sont disponibles une fois que PayU a finalisé le paiement. Le remboursement est envoyé pour la commande PayU effectivement payée, avec les clés de l'environnement du paiement ; ces clés doivent donc être renseignées. Les remboursements sont effectués dans le montant et la devise débités par PayU ; ainsi, après un écart de montant ou de devise, vous pouvez rembourser jusqu'au montant réellement payé par le client, et non jusqu'au total de la commande. Le motif est transmis comme description du remboursement. Si PayU refuse le remboursement, l'onglet affiche l'erreur de PayU et aucun remboursement n'est enregistré. Un remboursement total place la commande au statut Refunded Status, sans notifier le client et sans remettre les produits en stock. Un remboursement partiel ne modifie pas le statut.

Les remboursements sont asynchrones chez PayU. L'extension ajoute immédiatement une note avec l'identifiant et le statut du remboursement PayU ; le statut final arrive plus tard par notification PayU et est ajouté aux notes et à l'historique des remboursements. Si PayU annule un remboursement, la note indique que l'argent n'a pas été restitué au client, et le montant peut être remboursé à nouveau.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via PayU.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox PayU Payment est le premier bloc de Extensions > Extensions > Payments > VibeFox PayU Payment > Edit, au-dessus des réglages. Collez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est valable et votre domaine), ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: opencart-payment-payu et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les administrateurs disposant du droit Modify pour l'extension peuvent modifier la clé. Les textes du bloc suivent la langue de l'administration (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique pourquoi, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Une clé fonctionne pour un seul domaine : l'adresse de la boutique issue de la configuration d'OpenCart. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, PayU n'est pas affiché aux clients lors du paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit toujours le mode de paiement dans la boutique, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, donc sans clé active le mode de paiement est masqué pour tout le monde. Après avoir ouvert une fois la page Edit, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés par les notifications, 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 lorsque vous ouvrez le Dashboard de l'administration ou la page Edit : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation de l'extension supprime toujours la clé de licence et le statut de licence.

Dépannage

PayU n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que les quatre clés du mode actuel sont renseignées : les clés Sandbox en mode sandbox, les clés Live en mode live. Vérifiez que la devise du client fait partie des devises prises en charge, que l'adresse de facturation se trouve dans la Geo Zone sélectionnée et que la commande atteint le Total défini dans les réglages. La page des réglages affiche un avertissement lorsque des clés manquent ou que la devise de la boutique n'est pas prise en charge.

Le paiement a abouti, mais la commande reste sans statut : PayU n'a pas encore transmis la notification, et la vérification de statut sur la page de retour n'a pas détecté de paiement finalisé. Vérifiez que l'URL de notification affichée dans les réglages est accessible depuis Internet. Activez Logging pour voir ce qui arrive. Le client peut aussi cliquer sur Check again sur la page Payment confirmation.

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

La notification répond Ignored: unknown PayU order : la commande PayU n'a pas été créée par cette boutique, par exemple une autre boutique sur le même point de vente. PayU arrête les tentatives.

La notification répond Busy, retry later : le panier était en cours de confirmation par une autre requête au même moment. PayU répète la notification. Activez Logging pour voir la raison.

L'URL de notification affiche POST expected dans le navigateur : c'est normal. L'URL n'accepte que les notifications de PayU.

Le client voit Payment error après Confirm Order : activez Logging et consultez le champ Log sur la page de l'extension. Le journal indique le code HTTP et le statut PayU. Could not authenticate with PayU (check the OAuth client ID / secret). signifie que les clés OAuth du mode actuel sont incorrectes. This payment method is not available. signifie que la session de paiement ne correspond plus à la commande, ou que le mode de paiement a été désactivé entre-temps : le client doit recharger la page de paiement.

La commande est en PayU Payment On Hold : lisez les notes de l'onglet VibeFox PayU Payment (voir Statuts de commande), puis exécutez la commande ou remboursez le paiement.

La commande est en Awaiting PayU Payment Confirmation : la réception automatique est désactivée pour votre point de vente et le paiement attend votre action. Utilisez Receive PayU payment ou Cancel PayU payment dans l'onglet.

Le remboursement échoue ou il n'y a pas de formulaire de remboursement : l'onglet indique la raison. Refunds are available once PayU has completed the payment. signifie que PayU n'a pas encore finalisé de paiement pour la commande. Un message indiquant que les clés Sandbox ou Live manquent signifie que le paiement a été effectué dans cet environnement et que ses clés ne sont pas renseignées. Saisissez-les et réessayez. Sans le droit de modifier l'extension, l'onglet affiche You do not have permission to refund (modify this extension).

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox PayU Payment. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart supprime toujours ses propres réglages de l'extension : Enable/Disable, Sort Order, Geo Zone, Total et les statuts de commande de la section Order statuses, qui reviennent à leurs valeurs par défaut lors d'une réinstallation. L'événement OpenCart de l'extension et les jetons d'accès PayU mis en cache sont également supprimés (sur OpenCart 4, également ses événements et son action de démarrage, qui permettent de laisser passer les notifications et le retour du client en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, mode test, clés, réception automatique, journalisation) ainsi que le journal sont supprimés. S'il est désactivé, ils sont conservés pour une réinstallation ultérieure. Les transactions et remboursements PayU sont toujours conservés, de sorte que les commandes payées auparavant peuvent être remboursées après une réinstallation. Les commandes existantes conservent leurs notes de paiement.

Sur OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation et cliquez sur Uninstall (le bouton orange −) à côté de VibeFox PayU Payment dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet envoyé.

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