VibeFox Tpay for OpenCart — Aide

Prérequis

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

PHP : 8.0 ou ultérieur. L'extension OpenSSL et les connexions HTTPS sortantes vers secure.tpay.com sont nécessaires pour la vérification de la signature JWS des notifications.

Devise : uniquement le złoty polonais (PLN). Tpay règle en PLN et son Open API n'a pas de champ de devise. Ajoutez PLN dans System > Localisation > Currencies si votre boutique ne l'a pas : Tpay n'est affiché que lorsque le client paie en PLN.

Accès Internet à votre boutique : Tpay envoie les notifications de paiement à votre boutique ; l'adresse de notification doit donc être joignable depuis Internet (non bloquée par un pare-feu ou une authentification HTTP).

Compte Tpay : vous avez besoin de ces valeurs du tableau de bord marchand Tpay : le Merchant ID (l'identifiant de votre compte Tpay), les clés Open API Client ID et Client secret (Integration, API) et le code de sécurité (Settings, Notifications). Les clés du bac à sable (sandbox) proviennent d'un compte sandbox Tpay distinct.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne pour un seul domaine.

Installation

Le téléchargement est un seul fichier zip avec les paquets des deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_tpay_payment-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_tpay_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_tpay_payment-oc3-(version).ocmod.zip. L'extension ne contient aucune modification OCMOD, donc Extensions > Modifications n'a pas besoin d'être actualisé. 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 Tpay 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 License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir Clé de licence).

4. Saisissez les clés du bac à sable et les clés de production (voir Configuration). Rien ne doit être configuré dans le tableau de bord Tpay à part le code de sécurité : l'adresse de notification est transmise avec chaque transaction.

5. Activez Enable/Disable et cliquez sur Save. Testez un paiement en mode bac à sable, puis désactivez Sandbox mode pour accepter des paiements réels.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_tpay_payment.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 tire le code de l'extension 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é de celui-ci.

3. Allez dans Extensions > Extensions et choisissez le type Payments. Repérez VibeFox Tpay 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 Tpay comme aux étapes 3 à 5 pour OpenCart 3. La page des réglages et ses champs sont identiques 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 bac à sable activé.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Tpay Payment > Edit. Les sections sont listées à gauche ; le bouton Save situé sous la liste enregistre toute la page. Au-dessus des réglages, la page affiche Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged. tant que le mode bac à sable est activé. Elle vous avertit lorsque les clés du mode actuel sont incomplètes (Tpay n'est alors pas affiché au moment de la commande), lorsque la devise par défaut de la boutique n'est pas le PLN (Tpay n'est alors affiché que si le client paie en PLN), et lorsque l'extension PHP OpenSSL manque alors que la vérification JWS est activée (les paiements ne seraient alors pas confirmés). 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, Sort Order doit être un nombre entier (les valeurs négatives sont admises), Total doit être un nombre égal ou supérieur à 0, et les statuts de commande doivent exister ; sinon, rien n'est enregistré. Les clés incomplètes n'empêchent pas l'enregistrement. Les espaces collés avec le Merchant ID ou le Client ID sont supprimés, et les secrets sont nettoyés des espaces superflus.

Tpay

Enable/Disable : Enable Tpay payments active ou désactive le mode de paiement. Valeur par défaut : désactivé.

Title : le titre du mode de paiement affiché aux clients au moment de la commande. C'est aussi le nom du mode de paiement enregistré dans la commande. Valeur par défaut : Tpay. Obligatoire, 128 caractères au maximum.

Description : le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Valeur par défaut : Pay with BLIK, online bank transfer or card on the secure Tpay page.

Sandbox mode : utilise le bac à sable Tpay (paiements de test, sans argent réel) avec les clés du bac à sable et openapi.sandbox.tpay.com. Désactivez-le pour accepter de vrais paiements avec les clés de production. Les remboursements vont toujours vers l'environnement dans lequel la commande a été payée. Valeur par défaut : activé.

Sort Order : la position de Tpay parmi les modes de paiement au moment de la commande. Laissez vide ou saisissez un nombre entier (les valeurs négatives sont admises).

Geo Zone : proposer Tpay uniquement pour les adresses de facturation situées dans la zone géographique choisie. Valeur par défaut : All zones. Les zones géographiques se configurent dans System > Localisation > Geo Zones.

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

Clés de production

Où les trouver : dans le tableau de bord marchand Tpay (la section y renvoie), sous Integration, API (clés Open API : Client ID et Secret) ; le Merchant ID est l'identifiant de votre compte Tpay ; le code de sécurité se trouve dans Settings, Notifications.

Merchant ID : l'identifiant de votre compte Tpay (chiffres). Tpay l'envoie dans chaque notification.

Client ID : le Client ID de l'Open API.

Client secret : le Client secret de l'Open API.

Security code : sert à vérifier la somme de contrôle MD5 des notifications Tpay.

Clés du bac à sable

Le bac à sable est un compte de test Tpay distinct, avec ses propres clés (la section renvoie vers la documentation API de Tpay). Elles ne sont utilisées que lorsque Sandbox mode est activé.

Sandbox Merchant ID : le Merchant ID du compte bac à sable.

Sandbox Client ID : le Client ID de l'Open API du compte bac à sable.

Sandbox Client secret : le Client secret de l'Open API du compte bac à sable.

Sandbox Security code : le code de sécurité des notifications du compte bac à sable.

Les secrets enregistrés (Client secret et Security code des deux environnements) ne sont jamais ré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 un secret enregistré, cochez Clear the saved value sous le champ et cliquez sur Save.

Notifications de paiement

Notification URL : Tpay confirme les paiements à l'adresse affichée ici. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_tpay_payment/notify, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_tpay_payment/payment/wcp_tpay_payment.notify. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. L'adresse est transmise automatiquement avec chaque transaction ; rien ne doit être configuré dans le tableau de bord Tpay à part le code de sécurité. Une commande ne reçoit un statut qu'après une notification dont la somme de contrôle et la signature sont valides et dont le montant correspond (ou après une vérification de statut concordante lorsque le client revient). Tpay répète une notification jusqu'à ce que votre boutique l'accepte. Le mode maintenance ne bloque pas l'adresse (sur OpenCart 4, l'extension ajoute une action de démarrage pour les notifications et le retour du client).

JWS signature : vérifie également la X-JWS-Signature des notifications avec le certificat de Tpay (recommandé). Nécessite l'extension OpenSSL de PHP et des connexions HTTPS sortantes vers secure.tpay.com. Les certificats sont mis en cache pendant un jour. La somme de contrôle MD5 est toujours vérifiée. Valeur par défaut : activé.

Commandes

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). La commande ne reçoit un statut qu'une fois que Tpay a confirmé le paiement (par notification ou par vérification de statut). Chacun des champs ci-dessous liste vos statuts de commande OpenCart.

Paid Order Status : le statut après un paiement confirmé. Valeur par défaut : En cours.

On Hold (Review) Status : le paiement doit être vérifié par vos soins (voir Statuts de commande). Valeur par défaut : En attente, car OpenCart n'a pas de statut En pause. Vous pouvez créer votre propre statut dans System > Localisation > Order Statuses et le sélectionner ici.

Cancelled Order Status : l'extension ne définit jamais ce statut. Un paiement pour une commande dans ce statut place la commande en vérification au lieu de la rouvrir silencieusement. Valeur par défaut : Annulée.

Refunded Status : défini après le remboursement intégral du paiement depuis la page de la commande. Valeur par défaut : Remboursée.

Avancé

Debug log : journalise les événements de paiement : uniquement des événements techniques (sans clés ni données clients) dans wc_tp_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web et, à 5 Mo, il est déplacé vers une copie ancienne. Valeur par défaut : désactivé. Tant qu'il est désactivé, rien n'est écrit, erreurs comprises ; activez-le donc avant de chercher la cause d'un problème.

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

Delete data on uninstall : si activé, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les commandes et leurs données de paiement Tpay sont toujours conservées. Valeur par défaut : désactivé.

Importer / Exporter

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

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

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Tpay). À l'étape Confirm Order, le client voit votre description et la mention You will be redirected to the secure Tpay page to complete the payment. En mode bac à sable, il voit aussi Sandbox mode - no real money is charged. 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 de la page de paiement.

Lorsque le client clique sur Confirm Order, l'extension crée une transaction Tpay pour le montant de la commande en PLN, avec la description Order # et le numéro de commande, transmet le nom, l'adresse e-mail, l'adresse de facturation et le téléphone du client, et envoie le client sur la page de paiement Tpay. La page s'affiche en polonais, en anglais ou en ukrainien, selon la langue de la commande (les autres langues reçoivent l'anglais). Là, le client choisit BLIK, un virement bancaire, une carte ou une autre méthode activée sur votre compte Tpay, puis paie.

La commande n'est marquée payée qu'une fois que Tpay la confirme. Tpay envoie une notification à votre boutique ; l'extension vérifie la somme de contrôle MD5 avec le code de sécurité, le Merchant ID et (si activée) la signature JWS, en utilisant les clés de l'environnement dans lequel le paiement a été lancé, puis le montant : il doit être égal au montant demandé pour cette tentative de paiement et au total de la commande, et le montant payé ne peut pas être inférieur. Les notifications sans somme de contrôle ou signature valide sont rejetées. 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 du stock.

Après le paiement, le client revient dans votre boutique. Le retour seul ne marque rien comme payé. Si la notification n'est pas encore arrivée, l'extension demande à l'API Tpay le statut de la transaction (au plus toutes les 10 secondes) et applique les mêmes vérifications. Lorsque le paiement est confirmé, le client voit la page de confirmation de commande d'OpenCart. Tant qu'il n'est pas confirmé, une page Payment confirmation affiche Tpay has not confirmed your payment yet. If you have paid, refresh this page in a moment. If the payment did not go through, you can try again: avec un bouton Refresh et un bouton Pay again qui ramène à la page de paiement. La notification définit le statut de la commande dès son arrivée. Si la commande est passée en vérification, la page de réussite affiche aussi Your payment is being verified. We will contact you as soon as it is confirmed.

Si Tpay signale que le paiement a échoué, le client revient à la page de paiement avec le message Tpay reports that the payment did not go through. Please try again or choose another payment method. Si le paiement échoue sur la page Tpay, Tpay renvoie le client à la page de paiement. Le panier est conservé dans les deux cas.

Sur OpenCart 3, une nouvelle commande est créée chaque fois que l'étape Confirm Order est affichée. Sur OpenCart 4, la commande de paiement est conservée et mise à jour, donc Pay again lance une nouvelle tentative sur la même commande. Chaque tentative de paiement a sa propre référence. Lorsque le client paie à nouveau, les transactions Tpay non payées antérieures de la commande et des autres commandes du même panier sont annulées chez Tpay ; un paiement déjà effectué via un lien précédent reste accepté. Si une autre commande du même panier est déjà payée, le client accède à la page de réussite au lieu d'un nouveau paiement.

Sur OpenCart 4, si la commande en cours de paiement a été fermée entre-temps par la boutique, ou est déjà payée mais que le panier a changé depuis, y compris une nouvelle quantité, le client est renvoyé à la page de paiement avec Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. Pour une commande que la boutique a annulée avant tout paiement, le message est Order #… was cancelled by the store before the payment was completed. No Tpay payment was received for it. Please place a new order or contact us. Le prochain Confirm Order paie une nouvelle commande. Sur OpenCart 4, ces messages, le message concernant le paiement échoué et We could not match this payment to an order. If you were charged, please contact us. s'affichent au-dessus de la page de paiement.

Si Tpay ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec le message The Tpay payment could not be started. Please try again or choose another payment method. et la raison est écrite dans le journal (lorsque Debug log est activé). Autres messages : Tpay accepts payments in Polish złoty (PLN) only. Please choose another payment method. et The order total must be greater than zero.

L'extension fonctionne uniquement en PLN. Il n'y a pas de choix de banque ni de code BLIK dans la boutique (le client choisit sur la page Tpay), pas de cartes enregistrées, pas d'abonnements, pas de boutons Apple Pay ou Google Pay dans la boutique et pas de simulateurs de paiement échelonné.

Commandes et remboursements

Statuts de commande

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

Paid Order Status (default Processing) : Tpay a confirmé le paiement. Une note indique le titre de la transaction Tpay (TR-...), le montant payé, si la confirmation provient d'une notification ou d'une vérification de statut, l'environnement et l'éventuel trop-perçu.

On Hold (Review) Status (default Pending) : un paiement est arrivé, mais la devise de la commande n'est pas le PLN, son montant ne correspondait pas au montant demandé ou au total de la commande (par exemple, la commande a été modifiée après le début du paiement), seule une partie a été payée, ou le paiement est arrivé pour une commande dans le Cancelled Order Status. La note l'explique. Vérifiez le paiement dans le tableau de bord Tpay, puis honorez la commande ou remboursez-la. Si le client paie ensuite le bon montant par une autre tentative, la commande passe au Paid Order Status.

Refunded Status (default Refunded) : le paiement a été entièrement remboursé via l'extension.

Si Tpay signale un autre paiement pour une commande déjà payée ou remboursée, la commande n'est pas modifiée ; une note vous demande de rembourser le paiement supplémentaire dans le tableau de bord Tpay, si nécessaire. Un paiement pour une autre commande d'un panier déjà payé laisse cette commande sans statut et est noté sur la commande payée. Un paiement échoué pour une commande qui a déjà un statut, un impayé (chargeback) et un statut Tpay inconnu ajoutent seulement une note.

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

Onglet VibeFox Tpay Payment

Dans Sales > Orders, ouvrez une commande payée avec Tpay. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Tpay Payment affiche le titre de la Tpay transaction et le Transaction ID, la référence du paiement (CRC), l'Environment (une étiquette Sandbox pour les paiements en bac à sable), le Status du paiement et son mode de confirmation, le montant payé, Order total / refunded, Refundable (paid through Tpay) lorsque ce montant diffère du total de la commande, le formulaire de remboursement, l'historique des remboursements, les Payment attempts de la commande (avec link cancelled pour les liens annulés) et les Payment notes. L'onglet est affiché aux utilisateurs ayant accès à l'extension.

Remboursements

Dans l'onglet, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement un Reason (optional, kept in the note), puis cliquez sur Refund via Tpay. Confirmez la question Refund this amount through Tpay? This cannot be undone. Les remboursements totaux et partiels sont pris en charge pour les commandes dont le paiement a été reçu via Tpay, y compris les commandes en vérification. Vous avez besoin du droit de modifier l'extension (défini dans System > Users > User Groups). Vous pouvez rembourser jusqu'au montant que la transaction Tpay ayant effectué le paiement a encaissé, sans dépasser le total de la commande. Le remboursement est envoyé à l'environnement (bac à sable ou production) dans lequel la commande a été payée ; les clés de cet environnement doivent donc être renseignées. Un remboursement n'est considéré comme effectué que lorsque Tpay le confirme ; un remboursement rejeté ou non confirmé par Tpay s'affiche comme une erreur et n'est pas enregistré. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes, avec le motif que vous avez saisi (le motif n'est pas envoyé à Tpay). Rembourser la totalité du montant remboursable définit la commande sur le Refunded Status sans notifier le client et sans remettre de produits en stock, comme un changement de statut manuel. Un remboursement partiel ne modifie pas le statut.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Tpay. Les remboursements effectués dans le tableau de bord marchand Tpay ne sont pas ajoutés automatiquement à OpenCart.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Tpay Payment est le premier bloc de Extensions > Extensions > Payments > VibeFox Tpay 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 active, 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-tpay et le lien Manage licenses and domains in your account, 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 la raison, 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é une place 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 sa place de domaine. Libérez la place dans votre compte vibefox.net.

Sans clé active, Tpay n'est pas affiché aux clients au moment de la commande. 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, 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 ou 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 le statut de licence.

Dépannage

Tpay n'apparaît pas au moment de la commande : vérifiez que la licence est active, que Enable/Disable est activé et que les quatre clés du mode actuel sont saisies (Merchant ID, Client ID, Client secret, Security code). Vérifiez que le client paie en PLN, que l'adresse de facturation se trouve dans la Geo Zone choisie et que la commande atteint le Total défini dans les réglages. La page des réglages affiche un avertissement en cas de clés manquantes et de devise de boutique autre que le PLN.

Le paiement a abouti, mais la commande reste sans statut : Tpay n'a pas pu remettre la notification ou celle-ci a été rejetée. Activez Debug log et consultez le champ Log sur la page de l'extension. Les causes habituelles sont un code de sécurité ou un Merchant ID erroné pour l'environnement du paiement, une adresse de notification bloquée (pare-feu, authentification HTTP) ou un serveur sans OpenSSL ni HTTPS sortant pour la vérification JWS. La commande reçoit aussi son statut lorsque le client revient dans la boutique après le paiement.

Notification answered FALSE - invalid checksum : le Merchant ID ou le code de sécurité des réglages ne correspond pas au compte Tpay (bac à sable ou production) du paiement.

Notification answered FALSE - invalid JWS signature : la signature n'a pas pu être vérifiée, par exemple parce qu'OpenSSL est absent ou que le certificat Tpay ne peut pas être téléchargé. Corrigez le serveur ou, si nécessaire, désactivez JWS signature ; la somme de contrôle MD5 reste vérifiée.

Notification answered FALSE - busy, retry later or FALSE - order could not be updated : le panier était en cours de traitement par une autre requête au même moment, ou le statut de la commande n'a pas pu être défini. Tpay répète la notification automatiquement. Activez Debug log pour voir la raison.

L'URL de notification affiche FALSE - POST only in the browser : c'est normal. L'URL n'accepte que les notifications de Tpay.

La commande est en statut de vérification : lisez les notes dans l'onglet VibeFox Tpay Payment (voir Statuts de commande), vérifiez le paiement dans le tableau de bord Tpay, puis honorez la commande ou remboursez le paiement.

Le client a vu The Tpay payment could not be started : les clés du mode actuel sont incorrectes ou Tpay a rejeté la requête. Activez Debug log ; le journal affiche l'erreur de Tpay.

Le client a vu This payment method is not available : la session de paiement ne correspond plus à la commande, ou le mode de paiement a été désactivé ou a perdu ses clés entre-temps. Le client recharge la page de paiement.

Le client a vu We could not match this payment to an order : le lien de retour n'appartenait pas à la commande. Si le client a été débité, la notification définit tout de même le statut de la commande ; vérifiez le tableau de bord Tpay.

Le remboursement échoue : si le message indique que les clés manquent, saisissez les clés de l'environnement dans lequel la commande a été payée. Si le message indique que le montant est trop élevé, seul le montant affiché peut être remboursé au maximum. Si Tpay n'a pas confirmé le remboursement, vérifiez la transaction dans le tableau de bord marchand Tpay avant de réessayer. Si l'onglet indique Tpay transaction ID not found., la commande n'a pas de paiement Tpay confirmé à rembourser.

Pour les développeurs : avant la création de la transaction Tpay, l'extension déclenche l'événement OpenCart wc_tp_transaction_data avec les données de la transaction, la commande et l'environnement.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Tpay 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 Orders, qui reviennent à leurs valeurs par défaut lors d'une nouvelle installation. L'événement OpenCart de l'extension (sur OpenCart 4, ses événements et son action de démarrage) ainsi que les jetons d'accès Tpay et les certificats mis en cache sont toujours supprimés. Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, mode bac à sable, clés, signature JWS, interrupteur du journal de débogage) et le journal sont aussi supprimés. Sinon, ils sont conservés pour une réinstallation ultérieure. Les transactions et remboursements Tpay sont toujours conservés ; les commandes payées auparavant peuvent donc ê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 Tpay Payment dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de poubelle) pour supprimer le paquet téléchargé.

Tpay est une marque de commerce de son titulaire. Cette extension n'est ni affiliée à Tpay ni approuvée par Tpay.