VibeFox Peach Payments 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 OpenSSL (utilisée pour déchiffrer les webhooks).

Devise : la devise de paiement du client doit être ZAR, KES ou MUR ; votre boutique doit donc disposer d'au moins une de ces devises dans System > Localisation > Currencies. Pour les clients qui paient dans d'autres devises, le mode de paiement est masqué. La page de configuration vous avertit lorsque la devise par défaut de la boutique n'en fait pas partie.

Compte Peach Payments : vous avez besoin des identifiants API Card de votre compte Peach Payments : l'Entity ID et l'Access Token. Les identifiants de test proviennent du tableau de bord sandbox de Peach Payments, les identifiants de production du tableau de bord de Peach Payments ; ils sont différents. Pour les webhooks, vous avez également besoin d'une clé de déchiffrement des webhooks, que Peach Payments vous transmet lorsqu'il active les webhooks Card pour votre boutique (voir Configuration). Votre boutique doit être accessible depuis Internet pour recevoir les webhooks.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur 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_peach_pay-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_peach_pay.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_peach_pay-oc3-(version).ocmod.zip. L'extension n'apporte aucune modification OCMOD ; il n'est donc pas nécessaire d'actualiser Extensions > Modifications. Au lieu de passer par l'installateur, vous pouvez 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 Peach Payments Pay Gateway 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 de configuration. Collez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Saisissez l'Entity ID et l'Access Token de test du tableau de bord sandbox de Peach Payments, et demandez à Peach Payments d'activer les webhooks Card pour l'URL de webhook affichée sur la page de configuration (voir Configuration).

5. Activez Enable/Disable et cliquez sur Save. Gardez Test mode activé et effectuez un paiement avec une carte de test sandbox de Peach Payments en ZAR, KES ou MUR. Désactivez ensuite Test mode, saisissez les identifiants de production et la clé de webhook de production, puis cliquez sur Save.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_peach_pay.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 Peach Payments Pay Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence, les identifiants Peach Payments et le webhook 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 webhook diffère (voir Webhook).

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 Peach Payments Pay Gateway > 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 affiche des avis : Test mode is on: payments go to the Peach Payments sandbox and no real money is charged. ; une erreur lorsque l'Entity ID ou l'Access Token du mode actuel est manquant (jusque-là, le mode de paiement n'est pas affiché à l'étape de paiement) ; un avertissement lorsque la clé de déchiffrement des webhooks du mode actuel est manquante (les paiements ne sont alors confirmés que lorsque le client revient dans la boutique) ; et un avis lorsque la devise par défaut de la boutique n'est pas prise en charge (le mode de paiement n'est alors affiché qu'aux clients qui paient dans une devise prise en charge). Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

Lors de l'enregistrement, Title ne doit pas être vide ni dépasser 128 caractères (la page affiche Enter a title for the payment method (up to 128 characters).), Sort Order doit être un nombre entier (les valeurs négatives sont acceptées), 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é. Les espaces sont retirés des identifiants. Une clé de webhook qui n'est pas une valeur hexadécimale de 64 caractères, ou une liste de marques de carte vide, est enregistrée avec un avertissement.

Peach Payments

Enable/Disable : Enable Peach Payments active ou désactive le mode de paiement. Par défaut : désactivé.

Title : le nom du mode de paiement affiché au client à l'étape de paiement. C'est aussi le nom du mode de paiement enregistré dans la commande. Par défaut : Credit / Debit Card (Peach Payments). Obligatoire, 128 caractères maximum.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation, à côté d'une icône de carte. Par défaut : Pay securely with your card. You will enter the card details in the Peach Payments form on the next page.

Sort Order : la position de Peach Payments parmi les modes de paiement à l'étape de paiement. Laissez ce champ vide ou saisissez un nombre entier.

Geo Zone : proposer Peach Payments uniquement pour les adresses de facturation de 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, que la commande doit atteindre pour que Peach Payments soit proposé. Laissez ce champ vide pour le proposer quel que soit le montant.

Identifiants API

L'Access Token et l'Entity ID de la Card API figurent dans le tableau de bord de Peach Payments (identifiants de test : dans le tableau de bord sandbox). La section renvoie vers les deux tableaux de bord et vers la documentation pour développeurs de Peach Payments.

Test mode : envoie les nouveaux paiements au sandbox de Peach Payments avec les identifiants de test, et aucun argent réel n'est débité. Désactivez-le pour accepter de vrais paiements avec les identifiants de production. Un paiement lancé dans un mode est toujours vérifié dans ce mode, même après un changement. Par défaut : activé. Tant qu'il est activé, le client voit Test mode: no real payment will be made. à l'étape Confirm Order.

Test Entity ID : l'Entity ID (canal 3-D Secure) de votre compte sandbox.

Test Access Token : le jeton d'accès Bearer de votre compte sandbox.

Test Webhook Decryption Key : la clé hexadécimale de 64 caractères utilisée pour déchiffrer les webhooks Card du sandbox.

Live Entity ID : l'Entity ID (canal 3-D Secure) de votre compte de production.

Live Access Token : le jeton d'accès Bearer de votre compte de production.

Live Webhook Decryption Key : la clé hexadécimale de 64 caractères utilisée pour déchiffrer les webhooks Card de votre compte de production.

Les jetons d'accès et les clés de webhook enregistrés ne sont plus jamais affichés. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que pour la modifier. Pour supprimer une valeur enregistrée, cochez Clear the saved value on save sous le champ, puis cliquez sur Save.

Webhook

Les webhooks confirment les paiements même lorsque le client ferme son navigateur avant de revenir dans la boutique. Le champ Webhook URL affiche l'URL de webhook de votre boutique. Sur OpenCart 3, elle se présente sous la forme https://your-store/index.php?route=extension/payment/wcp_peach_pay/webhook, sur OpenCart 4 https://your-store/index.php?route=extension/wcp_peach_pay/payment/wcp_peach_pay.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. Copiez l'URL exactement telle qu'elle est affichée dans les réglages. Demandez à Peach Payments (support@peachpayments.com) d'activer les webhooks Card pour votre compte avec cette URL, puis saisissez la clé de déchiffrement reçue dans le champ Webhook Decryption Key du même mode.

Peach Payments chiffre chaque webhook (AES-256-GCM). Un webhook qui ne peut pas être déchiffré avec la clé de test ou de production est rejeté : seul Peach Payments peut ainsi modifier vos commandes. Un webhook déchiffré avec la clé d'un mode n'est appliqué qu'aux paiements lancés dans ce mode. L'extension utilise les notifications de paiement suivantes :

Les autres notifications, par exemple la notification de test envoyée lors de l'activation du webhook, reçoivent la réponse ignored. Sans la clé de webhook, une commande ne reçoit un statut que lorsque le client revient dans la boutique après avoir payé.

Formulaire de paiement

Card brands : les marques affichées dans le formulaire de Peach Payments : Visa, Mastercard, American Express, Diners Club. Sélectionnez uniquement les marques activées pour votre Entity ID. Par défaut : Visa et Mastercard. Si aucune marque n'est sélectionnée, l'enregistrement affiche un avertissement et le formulaire affiche Visa et Mastercard.

Commandes

La commande est créée à l'étape Confirm Order sans statut (une commande manquante) et ne reçoit un statut qu'après que Peach Payments a confirmé le paiement. Un paiement refusé ou abandonné laisse la commande sans statut, et le panier est conservé. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Order Status After Payment : défini lorsque Peach Payments confirme le paiement et que le montant et la devise correspondent. Par défaut : En traitement.

Awaiting Payment Status : Peach Payments a signalé un paiement asynchrone qui attend une confirmation ; le webhook le confirme plus tard. Par défaut : En attente, car OpenCart n'a pas de statut On hold. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

On Hold (Review) Status : vérification manuelle : le montant ou la devise payé ne correspond pas à la commande, ou un paiement est arrivé après l'annulation de la commande. Une note explique la raison. Par défaut : En attente.

Payment Failed Status : défini lorsque le paiement asynchrone attendu par la commande est refusé. Un paiement réussi ultérieur finalise tout de même la commande. Par défaut : Échec.

Canceled Status : l'extension ne le définit pas. Un paiement pour une commande dans ce statut la place en attente de vérification au lieu de la rouvrir. Par défaut : Annulé.

Refunded Status : l'extension ne le définit pas. Un paiement reçu pour une commande dans ce statut est seulement noté, et la commande n'est pas modifiée. Par défaut : Remboursé.

Avancé

Logging : enregistre les requêtes API et les résultats de paiement dans peach_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être lu depuis le web et, à 5 Mo, il est déplacé vers peach_p_debug.old.log.php. Les erreurs et les avertissements sont toujours enregistrés. Les journaux ne contiennent aucune donnée de carte, aucune clé et aucune donnée client. 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 données Peach Payments des commandes (tentatives de paiement, identifiants de paiement) sont conservées, car elles font partie des commandes. Par défaut : désactivé.

Importer / Exporter

Export : Download JSON enregistre les réglages dans un fichier JSON. Les jetons d'accès et les clés de webhook ne sont pas exportés.

Import : collez le JSON exporté précédemment et cliquez sur Import pour restaurer les réglages. Les jetons d'accès et les clés de webhook enregistrés sont conservés.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Credit / Debit Card (Peach Payments)). À l'étape Confirm Order, le client voit une icône de carte et votre description ; OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension prépare un paiement Peach Payments pour le montant total de la commande dans la devise de la commande et ouvre la page Peach Payments payment de votre boutique avec Please enter your card details to complete the payment:, le formulaire de carte Peach Payments et les marques de carte sélectionnées, dans la langue du client lorsque Peach Payments la prend en charge. En mode test, la page affiche Test mode: use a Peach Payments test card, no real payment will be made. Les données de carte se saisissent dans le formulaire de Peach Payments, et le script du formulaire est chargé avec un hachage Subresource Integrity. Le lien Choose another payment method ramène à l'étape de paiement. Le rechargement de la page réutilise le même paiement pendant 25 minutes au maximum, sauf si le total de la commande a changé. 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 de la page de paiement.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée comme payée qu'après la confirmation de Peach Payments : la boutique lit le résultat du paiement de cette commande depuis l'API Peach Payments, dans le mode dans lequel le paiement a été créé, et vérifie que le paiement appartient à cette commande. Le webhook fait de même de manière indépendante ; le premier arrivé définit le statut de la commande, et l'autre ne change rien. La commande reçoit ensuite son statut de la manière habituelle d'OpenCart, avec les e-mails de commande habituels et la mise à jour du stock, et le client voit la page de succès de commande d'OpenCart. Sur OpenCart 4, lorsque le client revient d'une page 3-D Secure de sa banque, une courte page intermédiaire rouvre l'adresse de retour de votre boutique, afin que le panier et la connexion du client soient conservés.

Si le paiement n'est pas finalisé, le client revient à l'étape de paiement avec un message et peut réessayer : Payment failed: suivi du motif donné par Peach Payments et de Please try again or use another card., ou The payment was not completed. Please try again. Le panier est conservé. Si le résultat ne peut pas encore être confirmé (par exemple parce que Peach Payments n'a pas répondu, ou parce que le webhook traite ce même panier à cet instant), le message est We could not confirm your payment yet. If you were charged, the order will be updated automatically; otherwise please try again. Lorsqu'aucune clé de webhook n'est définie pour le mode du paiement, le client est au contraire invité à vous contacter. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de paiement.

OpenCart 3 crée une nouvelle commande à chaque affichage de l'étape Confirm Order, OpenCart 4 met à jour la commande du passage à la commande, mais un panier n'est payé qu'une seule fois : si une autre commande de ce même panier est déjà payée, le client est directement redirigé vers la page de succès.

Sur OpenCart 4, la commande est conservée jusqu'à l'affichage de la page de succès. Après un essai refusé, le client paie à nouveau la même commande avec une nouvelle page de paiement Peach Payments. Si cette commande a été fermée entre-temps (par exemple si le paiement attendu a échoué ou si vous l'avez annulée), le client est renvoyé au paiement avec le message Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order., et le prochain Confirm Order paie une nouvelle commande. Si la commande a été payée puis annulée ou remboursée par vous, le message est This order was cancelled or refunded by the store. Please contact the store about its payment, or confirm the order again: the cart will be paid with a new order.

Si le formulaire de paiement ne peut pas être préparé, le client reste à l'étape Confirm Order avec un bref message : The payment form is not available right now (payment configuration error). Please contact us or choose another payment method. (identifiants manquants ou incorrects), un message indiquant que certaines données de facturation n'ont pas été acceptées par le prestataire de paiement, ou The payment form could not be loaded. Please try again in a moment. Le motif technique est écrit dans le journal.

Le webhook fonctionne aussi lorsque la boutique est en mode maintenance, car OpenCart laisse passer les requêtes des extensions de paiement. Sur OpenCart 4, une action de démarrage de l'extension permet de laisser passer le webhook et le retour du client.

L'extension ne comporte aucun formulaire de carte à l'étape de paiement elle-même, ni cartes enregistrées, ni abonnements, ni pré-autorisation puis capture, ni méthodes non liées à la carte comme EFT, BNPL, QR ou autres.

Commandes

Statuts de commande

Aucun statut (commande manquante) : le client n'a pas payé, le paiement a été refusé ou n'a pas été finalisé, ou Peach Payments ne l'a pas encore confirmé. Le client peut payer à nouveau. Dans Sales > Orders, ces commandes ne s'affichent qu'avec le filtre Order Status réglé sur Missing Orders. Sur OpenCart 4.1, une telle commande peut aussi avoir le statut Voided, que OpenCart définit lorsque l'étape de confirmation est à nouveau affichée ; l'extension la compte comme une commande sans statut.

Order Status After Payment (default Processing) : le paiement a été confirmé, et le montant et la devise correspondent à la commande. Une note affiche le code de résultat, la description et l'identifiant de paiement de Peach Payments. Si Peach Payments a signalé le paiement pour une vérification manuelle, la note vous demande de le vérifier dans le tableau de bord de Peach Payments avant l'expédition.

Awaiting Payment Status (default Pending) : Peach Payments a signalé un paiement qui attend une confirmation. Le webhook fait ensuite passer la commande à Order Status After Payment ou à Payment Failed Status.

On Hold (Review) Status (default Pending) : le montant ou la devise payé ne correspond pas à la commande (note amount/currency mismatch — manual review required), ou le paiement est arrivé après l'annulation de la commande. Vérifiez le paiement dans le tableau de bord de Peach Payments, puis traitez la commande ou remboursez le paiement.

Payment Failed Status (default Failed) : Peach Payments a refusé le paiement attendu par la commande en attente. Une tentative refusée ne modifie jamais une commande payée ou en vérification.

Si un second paiement réussi concerne une commande déjà payée, ou un paiement pour une autre commande d'un panier déjà payé, la commande payée n'est pas modifiée. Une note indique qu'il s'agit d'un paiement en double et vous demande de le rembourser dans le tableau de bord de Peach Payments. Un paiement reçu pour une commande remboursée est seulement noté sur la commande.

Les notes sont des entrées de l'History de la commande, invisibles pour le client.

Onglet VibeFox Peach Payments Pay Gateway

Dans Sales > Orders, ouvrez une commande payée avec Peach Payments. En bas de la page de commande, à côté de History et Additional, l'onglet de l'extension affiche le Payment ID, avec une étiquette Test mode pour les paiements de test, le Checkout ID, le Merchant transaction ID, le Amount sent to Peach Payments, le Result et le code de résultat, ainsi que les Peach Payments notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Remboursements

Les remboursements depuis OpenCart ne sont pas disponibles. Remboursez le paiement dans le tableau de bord de Peach Payments, puis enregistrez-le dans OpenCart si nécessaire. Lorsque le webhook est configuré, les remboursements, annulations et rétrofacturations effectués dans Peach Payments sont ajoutés aux notes de la commande avec le montant et l'identifiant ; le statut de la commande ne change pas. Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Peach Payments.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Peach Payments Pay Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Peach Payments Pay Gateway > Edit, au-dessus des réglages. Collez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, l'état (par exemple la date jusqu'à laquelle la licence est active et votre domaine), ainsi que les boutons Check now pour vérifier à nouveau l'état, 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-peach et le lien Gérer les licences et les domaines dans votre compte, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant du droit Modify sur 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 le motif, 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 état connu.

Une clé fonctionne sur 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, Peach Payments n'est pas proposé aux clients à l'étape de 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 le retour du client et par le webhook.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. L'état est vérifié automatiquement à l'ouverture du Dashboard ou de la page Edit de l'administration : 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 l'état de la licence.

Dépannage

Peach Payments n'apparaît pas à l'étape de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que l'Entity ID et l'Access Token du mode actuel sont saisis (Test Entity ID et Test Access Token en mode test, Live Entity ID et Live Access Token en mode production), et que le client paie en ZAR, KES ou MUR. Vérifiez également 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. Les avis affichés en haut des réglages indiquent le problème.

Le paiement a abouti, mais la commande reste sans statut : le client n'est pas revenu dans la boutique et le webhook n'est pas arrivé. Vérifiez que Peach Payments a activé les webhooks Card exactement pour l'URL affichée dans les réglages, que la Webhook Decryption Key du mode dans lequel le paiement a été effectué est saisie, et qu'aucun pare-feu ni aucune protection par mot de passe ne bloque l'URL. Activez Logging et consultez le champ Log pour repérer les webhooks rejetés.

Le webhook répond Decryption failed : le webhook n'a pas pu être déchiffré avec la clé de test ni avec la clé de production. La clé est incorrecte ou appartient à un autre compte ou à un autre mode. Saisissez la clé que Peach Payments a envoyée pour cette URL de webhook.

Le webhook répond Webhook key not configured : aucune clé de webhook n'est définie ou valide. Saisissez la clé de 64 caractères. Peach Payments renverra le webhook plus tard.

Le webhook répond Busy, retry later : le panier était en cours de traitement par le retour du client au même moment. Rien n'a été modifié, et Peach Payments renvoie le webhook. Le journal indique le motif.

Le webhook répond Missing or malformed data : la requête ne contenait pas de corps chiffré ni les en-têtes X-Initialization-Vector / X-Authentication-Tag, par exemple parce qu'un proxy les a modifiés. Rien n'a été modifié.

Le webhook répond ignored : la notification est authentique, mais elle n'appartient à aucun paiement de cette boutique (autre boutique avec le même Entity ID), ou elle provient d'un autre mode que le paiement. Rien n'a été modifié.

L'URL du webhook affiche Method not allowed dans le navigateur : c'est normal. L'URL n'accepte que les requêtes provenant de Peach Payments.

Le client voit The payment form is not available right now : l'Access Token ou l'Entity ID du mode actuel est incorrect. Vérifiez les identifiants et le mode, et consultez le journal pour le code Peach Payments.

Le client voit The payment session was not found. Please confirm the order again. : la page de paiement a été ouverte pour une commande qui n'est plus la commande en cours du client, ou le mode de paiement a été désactivé entre-temps. Le client doit confirmer à nouveau la commande.

La commande est au statut de vérification après le paiement : consultez les notes dans l'onglet de l'extension. Le montant ou la devise payé différait de la commande, ou le paiement est arrivé après l'annulation de la commande. Vérifiez le paiement dans le tableau de bord de Peach Payments, puis traitez la commande ou remboursez le paiement.

L'enregistrement indique que la clé de webhook doit être la clé hexadécimale de 64 caractères : la valeur n'est pas la clé fournie par Peach Payments. Les webhooks ne peuvent pas être déchiffrés tant qu'elle n'est pas corrigée.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Peach Payments Pay Gateway. La clé de licence et l'état de la 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 Orders, qui reviennent à leurs valeurs par défaut lors d'une réinstallation. Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, mode test, identifiants, clés de webhook, marques de carte, journalisation) et le journal sont supprimés. Dans le cas contraire, ils sont conservés pour une future réinstallation. Les tentatives de paiement et les identifiants de paiement sont toujours conservés. Sur OpenCart 4, les événements de l'extension et son action de démarrage, qui permettent de laisser passer le webhook et le retour du client en mode maintenance, sont toujours supprimés. 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 Peach Payments Pay Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet envoyé.

Peach Payments est une marque déposée de son propriétaire respectif. Cette extension n'est ni affiliée à Peach Payments, ni approuvée par Peach Payments.