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

Devise de la commande : AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR ou USD. Pour les commandes dans d'autres devises, le mode de paiement n'est pas proposé au moment de la commande.

Accès Internet à votre boutique : Tap envoie le résultat du paiement à un webhook de votre boutique ; le site doit donc être joignable depuis Internet. L'URL du webhook est transmise avec chaque paiement ; rien n'a besoin d'être configuré dans le tableau de bord Tap.

Compte Tap : vous avez besoin des clés API de votre tableau de bord Tap (goSell, identifiants API). Les clés de test commencent par pk_test_ / sk_test_, les clés de production par pk_live_ / sk_live_. La clé secrète est toujours nécessaire ; la clé publique uniquement pour la fenêtre de paiement intégrée. Les modes de paiement proposés (mada, KNET, Benefit et d'autres) et la vérification de domaine Apple Pay se configurent dans votre compte Tap.

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

Installation

Le téléchargement est un unique fichier zip contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 wcp_tap_payment_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_tap_payment_gateway.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_tap_payment_gateway-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 Tap Payments 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 vos clés de test et de production Tap, choisissez l'action de paiement, le type de paiement et la langue de la page Tap (voir Configuration).

5. Activez Enable / Disable et cliquez sur Save. Testez avec les cartes de test Tap, puis désactivez Test mode.

OpenCart 4

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

4. Saisissez la clé de licence, vos clés Tap et les options de paiement comme aux étapes 3 à 5 pour OpenCart 3. La page de réglages et ses champs sont les mêmes dans les deux versions.

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 Tap Payments > 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 Test mode is on: payments use your Tap test keys and no real money is charged. ou Live mode: real payments are accepted. Elle vous avertit aussi lorsque les clés du mode actuel manquent (le mode de paiement n'est alors pas affiché au moment de la commande) et lorsque la devise par défaut de la boutique n'est pas proposée avec Tap. 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é. Une clé dont le préfixe ne correspond pas à son champ n'est pas enregistrée : la valeur précédente est conservée, les autres réglages sont enregistrés et un message tel que Test secret key was not saved: a Tap key for this field starts with "sk_test_". s'affiche. Par exemple, une clé de production saisie dans un champ de test est refusée.

Tap Payments

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

Title : le nom du mode de paiement que voient les clients au moment de la commande. C'est aussi le nom du mode de paiement enregistré dans la commande. Valeur par défaut : Tap Payments. 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 Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Sort Order : la position de Tap 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 Tap 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 Tap soit proposé. Laissez vide pour proposer Tap quel que soit le montant.

Clés API Tap

Retrouvez vos clés dans le tableau de bord Tap (goSell, identifiants API). La section renvoie vers la documentation développeur de Tap.

Test mode : utilise les clés de test, aucun paiement réel n'est débité. Les paiements, les vérifications de statut, les captures et les remboursements utilisent toujours les clés du mode dans lequel le paiement a été effectué ; un paiement de test est donc encore vérifié et remboursé avec la clé de test après le passage en production. Valeur par défaut : activé. Tant qu'il est activé, les clients voient Test mode: no real payment will be made. à l'étape Confirm Order et sur la page de paiement de la fenêtre.

Test publishable key : commence par pk_test_. Nécessaire pour la fenêtre de paiement.

Test secret key : commence par sk_test_.

Live publishable key : commence par pk_live_. Nécessaire pour la fenêtre de paiement.

Live secret key : commence par sk_live_.

Merchant ID : facultatif. Votre identifiant de marchand Tap ; nécessaire uniquement si Tap vous a demandé d'acheminer les paiements vers un compte marchand précis.

Les clés secrètes enregistrées ne sont jamais réaffichées. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que pour la modifier. Pour supprimer une clé enregistrée, cochez Clear the saved value sous le champ et cliquez sur Save. Les clés publiques sont publiques et restent visibles.

Paiement

Payment action : ce qui se passe avec l'argent lorsque le client paie.

Checkout type : l'endroit où le client paie.

Tap page language : langue de la page de paiement Tap et de la fenêtre : English (valeur par défaut) ou Arabic.

Notifications de paiement (webhook)

Tap envoie le résultat du paiement à l'URL affichée dans Webhook URL dans cette section. Sur OpenCart 3, elle ressemble à https://your-store/index.php?route=extension/payment/wcp_tap_payment_gateway/webhook, et sur OpenCart 4 à https://your-store/index.php?route=extension/wcp_tap_payment_gateway/payment/wcp_tap_payment_gateway.webhook. Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart. L'URL est transmise avec chaque paiement ; rien n'a donc besoin d'être configuré dans le tableau de bord Tap. Vérifiez seulement qu'elle est joignable depuis Internet (non bloquée par un pare-feu ou une authentification HTTP) ; le mode maintenance ne la bloque pas (sur OpenCart 4, une action de démarrage de l'extension laisse passer le webhook et le retour du client dans la boutique). Chaque notification est vérifiée avec la signature hashstring (HMAC-SHA256 avec la clé secrète du mode dans lequel le paiement a été effectué). Les webhooks sans signature valide sont rejetés. Même une notification signée n'est pas considérée comme fiable en soi : l'extension relit le paiement depuis l'API Tap avant de modifier la commande. Sans webhook fonctionnel, la commande ne reçoit son statut que lorsque le client revient dans la boutique après avoir payé.

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 Tap a confirmé le paiement via l'API. Chacun des champs ci-dessous liste vos statuts de commande OpenCart.

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

Authorized Status : Authorize only : les fonds sont réservés, pas encore capturés. Valeur par défaut : En attente.

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.

Voided Status : défini après que Void Tap authorization a libéré les fonds réservés. 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 : écrit les événements de paiement dans tap_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs, sur OpenCart 4 system/storage/logs). Le fichier ne peut pas être lu depuis le web et, à 5 Mo, il est déplacé vers tap_p_debug.old.log.php. Les erreurs et les avertissements sont toujours journalisés ; activez cette option pour journaliser aussi chaque événement de paiement. Le journal ne contient jamais de clés, ni de données de carte ou de client. Valeur 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 : si activé, la désinstallation de l'extension supprime les réglages de la passerelle et le journal. Les enregistrements de paiement des commandes sont toujours conservés. Valeur par défaut : désactivé.

Importer / Exporter

Export : Download JSON enregistre les réglages dans un fichier JSON. Les clés secrètes ne sont pas exportées.

Import : collez un JSON précédemment exporté et cliquez sur Import pour restaurer les réglages. Les clés secrètes enregistrées sont conservées.

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Tap Payments). À l'étape Confirm Order, le client voit votre description. OpenCart crée la commande à cette étape, toujours sans statut. Le client clique ensuite sur Confirm Order. Sur OpenCart 4, le client choisit le mode de paiement avec le bouton Choose du bloc des modes de paiement, dans la fenêtre Payment method options, puis clique sur Confirm Order en bas de la page de paiement.

Tap payment page : l'extension crée un débit Tap (ou une autorisation en mode Authorize only) pour le montant de la commande dans la devise de la commande, avec la description Order # et le numéro de commande, puis envoie le client sur la page de paiement Tap. Le nom, l'adresse e-mail et le numéro de téléphone du client sont transmis à Tap. Là, le client choisit une carte, mada, KNET, Benefit, Apple Pay ou Google Pay (selon ce qui est activé dans votre compte Tap) et paie. Si Tap ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec le message The Tap payment could not be started. Please try again or choose another payment method. et la raison est écrite dans le journal.

Tap checkout popup : le client accède à la page Tap payment de l'extension, où s'ouvre le formulaire de paiement Tap. La page affiche aussi le lien Pay on the Tap payment page instead. Si la fenêtre est fermée, le bouton Pay now la rouvre. Si le formulaire ne peut pas être chargé, le client est invité à utiliser la page de paiement Tap. Recharger la page réutilise la même tentative de paiement.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'une fois que Tap a confirmé le paiement : l'extension relit le paiement depuis l'API Tap avec la clé du mode du paiement, vérifie qu'il se rapporte à cette commande et qu'il a été lancé par son paiement, et compare le montant et la devise à la commande. L'identifiant Tap présent dans l'adresse de retour ne modifie jamais la commande à lui seul. Le webhook effectue la même vérification en arrière-plan. La commande reçoit alors son statut de la manière standard d'OpenCart, avec les e-mails habituels de commande et la mise à jour du stock, et le client voit la page de confirmation de commande d'OpenCart. Sur OpenCart 4, quand le client revient de la page de paiement Tap, une page intermédiaire courte rouvre l'adresse de retour de votre boutique, afin que le panier et la connexion du client soient conservés. Pour un paiement autorisé, la page affiche en outre Your payment has been authorized. We will process the order as soon as the payment is captured. Pour un paiement en cours de vérification, elle affiche Your payment is being reviewed. We will contact you if anything else is needed.

Si Tap n'a pas encore confirmé le paiement au retour du client, une page Payment confirmation affiche We have not received the payment confirmation from Tap yet. If you completed the payment, the order will be updated automatically in a few minutes — there is no need to pay again. avec les boutons Check again et Back to checkout. Le webhook définit le statut de la commande dès son arrivée.

Si le paiement a été refusé, abandonné ou annulé, la commande reste sans statut. Le client revient à la page de paiement avec le message Your payment was not completed. Please try again or choose another payment method. (avec la raison donnée par Tap lorsque Tap en fournit une). Un paiement inachevé affiche The payment was not completed. You can try again or choose another payment method. Le panier est conservé et peut être payé à nouveau. Sur OpenCart 4, ces messages s'affichent au-dessus de la page de paiement.

OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée, OpenCart 4 met à jour la commande de la page de paiement. Si une autre commande du même panier a déjà été payée, le client accède directement à la page de réussite au lieu de payer à nouveau. Avant le lancement d'un nouveau paiement, les pages de paiement Tap ouvertes pour la commande et pour le panier des dernières 24 heures sont vérifiées auprès de Tap, afin qu'un paiement effectué dans un autre onglet soit confirmé au lieu d'être débité deux fois. Toute modification du panier, y compris une nouvelle quantité, est considérée comme un nouveau panier qui nécessite son propre paiement.

Sur OpenCart 4, la commande reste sur la page de paiement jusqu'à l'affichage de la page de confirmation. Après un paiement refusé ou annulé, le prochain Confirm Order lance un nouveau paiement Tap pour la même commande. Si cette commande a été fermée sans paiement entre-temps (par exemple parce que vous l'avez annulée ou que son autorisation a été annulée), le client est renvoyé à la page de paiement avec le message Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., et le prochain Confirm Order paie une nouvelle commande.

Autres messages au moment de la commande : Tap does not accept payments in suivi de la devise, lorsque la devise de la commande n'est pas prise en charge, et The order total must be greater than zero to pay with Tap.

L'extension ne gère ni cartes enregistrées ni tokenisation, ni abonnements, ni champs de carte intégrés à votre page de paiement. Capture Tap payment capture toujours le montant total de la commande ; la capture partielle n'est pas prise en charge.

Commandes et remboursements

Statuts de commande

Aucun statut (commande manquante) : le client a été envoyé vers Tap et n'a pas payé, ou Tap 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. Sur OpenCart 4.1, une telle commande peut aussi avoir le statut Voided, que OpenCart attribue lorsque l'étape de confirmation est de nouveau affichée. L'extension la compte comme une commande sans statut.

Paid Order Status (default Processing) : Tap a confirmé un paiement capturé. Une note indique le montant, l'identifiant de débit Tap (chg_...), le mode de paiement et (en mode test) le caractère de test du paiement.

Authorized Status (default Pending) : le paiement a seulement été autorisé et attend la capture ou l'annulation.

On Hold (Review) Status (default Pending) : le montant ou la devise payés ne correspondaient pas à la commande (Tap: amount/currency mismatch — manual review required.), ou un paiement est arrivé après l'annulation de la commande. La note l'explique. Vérifiez la commande et honorez-la, ou remboursez le paiement.

Voided Status (default Canceled) : l'autorisation a été annulée avec Void Tap authorization, de sorte que les fonds réservés ont été libérés.

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

Une tentative échouée ne modifie jamais une commande qui a déjà un statut. Si un second paiement réussi arrive pour une commande déjà payée, la commande 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 Tap. 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 qui se rapporte à la commande mais qui n'a pas été lancé par son paiement est seulement noté.

Les notes sont des entrées de l'History de la commande que le client ne voit pas. Elles commencent par « Tap ».

Onglet VibeFox Tap Payments

Dans Sales > Orders, ouvrez une commande payée avec Tap. En bas de la page de la commande, à côté de History et Additional, l'onglet VibeFox Tap Payments affiche le Tap ID, l'Authorization et le Charge, le Mode (une étiquette Test pour les paiements de test), le Status du paiement et le mode de paiement, Charged / refunded, le formulaire de remboursement, l'historique des remboursements, les Payment attempts de la commande et les Tap notes. L'onglet est affiché aux utilisateurs ayant accès à l'extension ; la capture, l'annulation et les remboursements nécessitent le droit de modifier l'extension (défini dans System > Users > User Groups).

Capture et annulation

En mode Authorize only, ouvrez la commande autorisée. Capture Tap payment (avec le montant total de la commande sur le bouton) capture le montant de la commande après la question Capture the reserved funds of this order through Tap? ; la commande reçoit alors le Paid Order Status. Void Tap authorization affiche Release the reserved funds? The order will be canceled., libère les fonds et définit le Voided Status. Un second clic sur la capture dans les 2 minutes est bloqué. Si Tap rejette l'action, une erreur s'affiche dans l'onglet et est ajoutée aux notes. Ces changements de statut sont effectués sans notifier le client et sans modifier le stock, comme un changement de statut manuel. Si une autorisation est capturée directement dans le tableau de bord Tap, le webhook marque la commande comme payée ; les remboursements de ce paiement doivent être effectués dans le tableau de bord Tap.

Remboursements

Dans l'onglet, saisissez le Amount (le montant non encore remboursé est prérempli), éventuellement un Reason (optional), puis cliquez sur Refund via Tap. Confirmez la question Refund this amount through Tap? This cannot be undone. Les remboursements totaux et partiels sont pris en charge pour les débits Tap capturés. Vous pouvez rembourser jusqu'au montant et à la devise que Tap a effectivement débités, même si la commande a été modifiée par la suite. Le remboursement est envoyé avec la clé secrète du mode dans lequel le paiement a été effectué ; cette clé doit donc être renseignée. Un remboursement accepté par Tap est ajouté à l'historique des remboursements et aux notes, avec l'identifiant et le statut du remboursement Tap. Si Tap le rejette, l'onglet affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement total définit le Refunded Status sans notifier le client et sans remettre de produits en stock ; un remboursement partiel ne modifie pas le statut. Pour une commande autorisée, les remboursements ne sont disponibles qu'une fois l'autorisation capturée. Une commande en cours de vérification après un écart de montant ou de devise est remboursée dans le tableau de bord Tap.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Tap. Les remboursements effectués dans le tableau de bord Tap n'apparaissent pas dans OpenCart.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Tap Payments est le premier bloc de Extensions > Extensions > Payments > VibeFox Tap Payments > 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-tap 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, Tap Payments 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, la capture et l'annulation 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

Tap Payments n'apparaît pas au moment de la commande : vérifiez que la licence est active, que Enable / Disable est activé et que le mode actuel dispose d'une clé secrète (et d'une clé publique lorsque Checkout type est la fenêtre). Vérifiez que la devise de la commande fait partie de AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD, 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 non prise en charge.

Le paiement a abouti, mais la commande reste sans statut : le webhook ne parvient pas à atteindre votre boutique. Vérifiez que l'URL affichée dans Webhook URL est joignable depuis Internet (pas de pare-feu ni d'authentification HTTP), et activez Debug log pour voir les réponses dans le champ Log. La commande reçoit aussi son statut lorsque le client revient de Tap.

Webhook answers invalid signature : la notification n'a pas été signée avec la clé secrète du mode du paiement. Vérifiez les clés secrètes dans les réglages.

Webhook answers gateway not configured : la clé secrète du mode du paiement (test ou production) est vide. Saisissez-la.

Webhook answers verification failed : l'API Tap n'a pas pu être jointe pour vérifier le paiement. Tap réessaie le webhook plus tard.

Webhook answers order not found : la notification désigne une commande qui n'a aucune tentative de paiement Tap dans cette boutique.

Webhook answers busy, retry later or order could not be updated, retry later : la commande était en cours de confirmation par une autre requête au même moment, ou le statut de la commande n'a pas pu être défini. Tap réessaie le webhook. Consultez le champ Log pour connaître la raison.

Une clé n'est pas enregistrée : la clé doit commencer par le préfixe de son champ : pk_test_, sk_test_, pk_live_ ou sk_live_.

Le client voit The Tap payment could not be started : consultez le champ Log de la page de l'extension. Une clé incorrecte ou une requête rejetée y est journalisée.

Le client voit 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 voit We could not match this payment to an order : le paiement n'appartient pas à cette commande ou n'a pas été lancé par son paiement. Si de l'argent a été prélevé, vérifiez le paiement dans le tableau de bord Tap.

La commande est en statut de vérification : lisez les notes dans l'onglet VibeFox Tap Payments. Le montant ou la devise payés ne correspondaient pas à la commande, ou le paiement est arrivé après son annulation.

Le remboursement échoue avec un message concernant le mode : le paiement a été effectué en mode test ou production, et aucune clé secrète n'est configurée pour ce mode. Saisissez-la et réessayez. Si l'onglet indique qu'aucun débit Tap capturé n'a été trouvé, remboursez le paiement dans le tableau de bord Tap.

Pour les développeurs : les événements OpenCart tap_p_charge_payload, tap_p_supported_currencies et tap_p_currency_decimals permettent de modifier la requête de paiement, les devises prises en charge et les décimales des devises.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Tap Payments. 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 est aussi supprimé (sur OpenCart 4, ses événements et son action de démarrage, qui laisse passer le webhook et le retour du client en mode maintenance). Si Delete data on uninstall est activé, les autres réglages de la passerelle (titre, description, clés, options de paiement, interrupteur du journal de débogage) et le journal sont supprimés. Sinon, ils sont conservés pour une réinstallation ultérieure. Les tentatives de paiement et les remboursements Tap 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 Tap Payments dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet téléchargé.

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