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

Compte Windcave : vous avez besoin d'un compte marchand Windcave avec des identifiants de l'API REST : un nom d'utilisateur d'API et une clé d'API. Windcave les délivre séparément pour l'environnement de test UAT (uat.windcave.com) et pour la production (sec.windcave.com). Demandez-les au support Windcave ou à votre responsable de compte. Les clés PxPay ne fonctionnent pas avec cette extension. Les moyens de paiement que vous voulez proposer (cartes, portefeuilles et autres) doivent être activés sur votre compte Windcave.

Notification : votre boutique doit être accessible depuis Internet, afin que Windcave puisse envoyer sa notification de paiement. Rien n'est à configurer chez Windcave pour cela.

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_windcave_payment_gateway-oc3-(version).ocmod.zip et le paquet OpenCart 4 wcp_windcave_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_windcave_payment_gateway-oc3-(version).ocmod.zip. L'extension n'a 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 Windcave Payment 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 crayon) pour ouvrir la page des réglages. Saisissez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page, puis cliquez sur Activate (voir License key).

4. Saisissez votre nom d'utilisateur et votre clé de l'API REST : les identifiants UAT pour le mode test, les identifiants de production pour les paiements réels (voir Configuration).

5. Choisissez le type de transaction et les moyens de paiement, activez Enable/Disable et cliquez sur Save. Effectuez un paiement de test avec Test mode activé, puis désactivez Test mode pour accepter de vrais paiements.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier wcp_windcave_payment_gateway.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension dans le 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 Windcave Payment Gateway, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton crayon).

4. Saisissez la clé de licence, les identifiants Windcave et les réglages 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'adresse de notification diffère (voir Windcave REST API).

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

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit. Les sections sont listées à gauche ; le bouton Save sous la liste enregistre toute la page. Tant que le mode test est activé, la page affiche Test mode is on: payments go to the Windcave UAT environment and no real money is taken. Si le mode de paiement est activé mais que le mode actuel n'a pas de nom d'utilisateur ou de clé d'API, la page indique qu'il est masqué au moment du paiement, par exemple Windcave is enabled but the UAT API username / key are empty — the payment method is hidden at checkout. Sans le droit de modifier l'extension, la page affiche les réglages mais ne peut pas les enregistrer.

À l'enregistrement, Title ne doit pas être vide et doit comporter au plus 128 caractères (Enter a title for the payment method (at most 128 characters).), Sort Order doit être un nombre entier (Sort Order must be a whole number.), Total doit être un nombre supérieur ou égal à 0 (Total: enter a number, 0 or greater.), et la zone géographique ainsi que les statuts de commande sélectionnés doivent exister ; sinon, rien n'est enregistré et la page affiche l'erreur.

Windcave

Enable/Disable: Enable Windcave payments active ou désactive le mode de paiement. Par défaut : off.

Title: le nom du mode de paiement que voient les clients au moment du paiement. C'est aussi le nom enregistré dans la commande. Par défaut : Credit/Debit Card (Windcave). Obligatoire, 128 caractères au maximum.

Description: le texte affiché au client à l'étape Confirm Order, au-dessus du bouton de confirmation. Par défaut : You will be redirected to the secure Windcave payment page to complete your payment.

Sort Order: la position de Windcave parmi les modes de paiement au moment du paiement. Laissez vide ou saisissez un nombre entier ; les nombres négatifs sont autorisés.

Geo Zone: ne proposer Windcave que 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 total du paiement, dans la devise par défaut de la boutique, que doit atteindre une commande pour que Windcave soit proposé : un nombre supérieur ou égal à 0. Laissez vide pour le proposer quel que soit le total.

Windcave REST API

Saisissez les identifiants de l'API REST délivrés par Windcave (nom d'utilisateur et clé d'API, et non les clés PxPay). Les identifiants de production et UAT peuvent être enregistrés côte à côte. Le mode test n'utilise que les identifiants UAT, le mode réel n'utilise que les identifiants de production. La section renvoie vers la documentation de l'API REST de Windcave.

Test mode: utilise l'environnement de test UAT de Windcave (uat.windcave.com). Aucun argent réel n'est prélevé. Les nouveaux paiements utilisent les identifiants UAT. Les remboursements et les captures vont toujours dans l'environnement où la commande a été payée. Par défaut : off.

Production API username: le nom d'utilisateur de l'API REST pour sec.windcave.com.

Production API key: la clé de l'API REST pour sec.windcave.com.

UAT API username: le nom d'utilisateur de l'API REST pour uat.windcave.com (mode test).

UAT API key: la clé de l'API REST pour uat.windcave.com (mode test).

Les clés d'API 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 key on save sous le champ puis cliquez sur Save.

Notification URL: affiche l'adresse à laquelle Windcave envoie sa notification de paiement (Fail-Proof Result Notification). Elle est construite à partir de l'adresse de la vitrine de votre installation OpenCart et ressemble, sur OpenCart 3, à https://your-store/index.php?route=extension/payment/wcp_windcave_payment_gateway/notify et, sur OpenCart 4, à https://your-store/index.php?route=extension/wcp_windcave_payment_gateway/payment/wcp_windcave_payment_gateway.notify. Rien n'est à configurer chez Windcave : l'extension transmet ses adresses de retour et cette adresse de notification avec chaque session de paiement. L'adresse doit être accessible depuis Internet ; sinon, les commandes ne sont confirmées que lorsque le client revient de Windcave. Ni le retour du client ni la notification ne sont signés par Windcave, donc l'extension ne leur fait jamais confiance seuls : elle lit toujours le résultat de la session depuis l'API REST de Windcave, avec les identifiants de l'environnement dans lequel la session a été créée.

Payment

Transaction type: la manière dont le paiement est prélevé. Par défaut : Purchase.

Payment methods: les moyens affichés sur la page de paiement Windcave : Cards, Account2Account (virement bancaire néo-zélandais), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm. Vous pouvez en sélectionner plusieurs. Les moyens doivent être activés sur votre compte Windcave. Laissez le champ vide (Every method enabled on the account) pour afficher tous les moyens activés sur le compte. Par défaut : Cards.

Orders

OpenCart crée la commande à l'étape Confirm Order sans statut (une commande manquante). La commande ne reçoit un statut qu'après l'approbation du paiement par Windcave. Chaque champ ci-dessous liste vos statuts de commande OpenCart.

Order Status After Payment: défini après un Purchase approuvé ou après une capture. Par défaut : Processing.

Windcave Payment On Hold Status: un paiement Auth autorisé mais pas encore capturé, ou un paiement approuvé qui ne correspond pas à la commande (montant, devise, référence). Une note explique la raison ; vérifiez-la avant l'expédition. Par défaut : Pending, 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.

Cancelled Order Status: non défini par l'extension. Un paiement approuvé reçu pour une commande dans ce statut ne la modifie pas ; une note vous demande de le rembourser dans Windcave Payline ou de rétablir la commande. Par défaut : Canceled.

Refunded Status: défini après le remboursement total du paiement, ou la libération de l'autorisation, depuis la page de commande. Par défaut : Refunded.

Advanced

Debug log: journalise les requêtes API et les événements de paiement dans windcave_p_debug.log.php, dans le dossier des journaux d'OpenCart (storage/logs). Le fichier ne peut pas être ouvert depuis le web. Tant que cette option est désactivée, seules les erreurs et les avertissements sont journalisés. Les clés d'API, les données de carte et les données personnelles des clients ne sont jamais journalisées. Par défaut : off.

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

Clean uninstall: supprime les réglages et les journaux de l'extension lors de sa désinstallation. Les données de paiement enregistrées avec les commandes (identifiants de transaction Windcave nécessaires aux remboursements) sont toujours conservées. Par défaut : off.

La version de l'extension est affichée en bas de la section.

Import / Export

Export: Download JSON enregistre les réglages dans un fichier JSON. Les clés d'API ne sont pas exportées.

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

Paiement

À l'étape Payment Method, le client choisit le mode de paiement (par défaut Credit/Debit Card (Windcave)). À l'étape Confirm Order, le client voit votre description ; en mode test, il voit aussi Test mode: payments go to the Windcave UAT environment, no real money is taken. OpenCart crée la commande à cette étape, toujours sans statut. Lorsque le client clique sur Confirm Order, l'extension crée une session de paiement Windcave pour le total de la commande dans la devise de la commande, et envoie le client sur la Windcave Hosted Payment Page. Le numéro de commande OpenCart est transmis comme référence marchand, avec la langue de la commande et le nom, l'e-mail, le téléphone et l'adresse de facturation du client (ainsi que l'adresse de livraison lorsque la commande doit être expédiée). 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, et clique sur Confirm Order au bas de la page de commande.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'une fois Windcave l'a confirmée : l'extension demande le résultat de la session à l'API REST de Windcave, à la fois au retour du client et à réception de la notification de Windcave. Un verrou par panier garantit que le paiement n'est appliqué qu'une fois. 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, et le client voit la page de confirmation de commande d'OpenCart avec Your Windcave payment has been received. Pour une commande en attente (une autorisation ou un paiement qui ne correspond pas à la commande), la page affiche Your payment was received by Windcave. The store will check it before processing your order — please do not pay again.

Si le client revient d'un paiement approuvé mais que le résultat n'est pas encore connu, une page Payment confirmation affiche We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again. et un bouton Check again. La notification définit le statut de la commande dès que Windcave confirme le paiement.

Si le client revient sans paiement abouti, la commande reste sans statut, le panier est conservé et la page de paiement affiche l'un de ces messages :

Sur OpenCart 4, ces messages s'affichent au-dessus de la page de paiement.

Le client peut réessayer avec le même panier (OpenCart 3 crée une nouvelle commande chaque fois que l'étape Confirm Order est affichée ; OpenCart 4 garde une commande pour le paiement et la met à jour, si bien que la même commande est payée dans une nouvelle session Windcave). Une nouvelle tentative vérifie d'abord les sessions précédentes du panier : si l'une est déjà payée, ce paiement est appliqué, le client arrive sur la page de succès et aucun second paiement n'est lancé ; si le client n'a jamais utilisé la page de paiement et que la commande n'a pas changé, il est renvoyé sur la même page. Si le paiement précédent est en cours de confirmation à ce moment, le client voit Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again.

Si Windcave ne peut pas démarrer le paiement, le client reste à l'étape Confirm Order avec un message au-dessus du bouton : Windcave could not start the payment with the details of this order. Please check your billing details and try again, or choose another payment method. ou The payment could not be started because the payment service is temporarily unavailable. Please try again in a moment or choose another payment method. La raison est écrite dans le journal. Si le mode actuel n'a pas d'identifiants, le client voit This payment method is not available at the moment. Please choose another payment method or contact us.

Sur OpenCart 4, si la commande du paiement a reçu un statut sans paiement Windcave, ou si la boutique l'a fermée entre-temps, le Confirm Order suivant renvoie le client au paiement avec This order can no longer be paid. Please check your cart and confirm the order again. au-dessus de la page de paiement, et le panier est payé avec une nouvelle commande. Si la commande du paiement est déjà payée mais que le panier a changé depuis, y compris une nouvelle quantité, le client est renvoyé au paiement et le nouveau panier est payé avec une nouvelle commande.

La notification et le retour du client fonctionnent aussi lorsque la boutique est en mode maintenance : OpenCart 3 laisse passer les requêtes des extensions de paiement, et sur OpenCart 4 l'extension ajoute une action de démarrage pour elles.

L'extension ne gère ni abonnements ni paiements récurrents, ni cartes enregistrées, ni formulaire de carte intégré à votre site (le client paie toujours sur la page Windcave), ni l'API PxPay 2.0, et n'ajoute aucune surcharge. Si Windcave ajoute une surcharge, la commande est rapprochée de la transaction principale.

Commandes et remboursements

Order statuses

Aucun statut (commande manquante) : le client a été envoyé vers Windcave et n'a pas payé, Windcave n'a pas encore confirmé le paiement, ou le paiement a été refusé, annulé ou a expiré. 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) : un paiement Purchase a été approuvé et correspond à la commande. Une note affiche le montant, l'identifiant de transaction, le code d'autorisation, le type de carte avec le numéro de carte masqué et l'environnement (UAT ou production).

Windcave Payment On Hold Status, autorisé (par défaut Pending) : un paiement Auth a été approuvé mais pas encore capturé. La note explique comment le capturer ou le libérer.

Windcave Payment On Hold Status, ne correspond pas (par défaut Pending) : Windcave a indiqué un montant, une devise, une référence marchand ou un type de transaction différent de la commande (par exemple, le panier a été modifié dans un autre onglet après le début du paiement), ou la commande avait déjà un statut défini par quelqu'un d'autre. La note liste les écarts. L'argent approuvé peut tout de même être remboursé depuis l'onglet de la commande. Vérifiez le paiement dans Windcave Payline avant l'expédition, et remboursez-le si nécessaire.

Refunded Status (par défaut Refunded) : le paiement a été entièrement remboursé ou l'autorisation a été libérée via l'extension.

Si un paiement approuvé arrive pour une commande dans Cancelled Order Status, ou si un second paiement approuvé arrive pour une commande ou un panier déjà payé, la commande n'est pas modifiée. Une note avec l'identifiant de transaction vous demande de le rembourser dans Windcave Payline (ou de rétablir manuellement la commande annulée).

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

VibeFox Windcave Payment Gateway tab

Dans Sales > Orders, ouvrez une commande payée avec Windcave. En bas de la page de commande, à côté de History et Additional, l'onglet VibeFox Windcave Payment Gateway affiche le Transaction ID, le Session ID, le Type / status avec l'environnement, l'Amount paid, l'Auth code / card, la Capture transaction ou une autorisation libérée, le Payment total / refunded, une étiquette Test mode (UAT) pour les paiements de test, le bouton de capture, le formulaire de remboursement et son historique, les Windcave sessions of this cart et les Windcave notes de la commande. L'onglet est affiché aux utilisateurs qui ont accès à l'extension.

Capture (Auth mode)

Pour une commande en Windcave Payment On Hold Status avec une autorisation qui n'a pas encore été capturée ni libérée, l'onglet affiche Capture Windcave payment. Cliquez dessus et confirmez Capture the authorised amount through Windcave now? Le montant autorisé est capturé, la commande passe à Order Status After Payment et la transaction de capture apparaît dans l'onglet. Si Windcave refuse la capture, l'onglet affiche Windcave capture failed: avec la raison, la raison est ajoutée aux notes et la commande reste en attente. La capture nécessite le droit de modifier l'extension et les identifiants de l'environnement du paiement.

Refunds

Dans l'onglet VibeFox Windcave Payment Gateway, saisissez le Amount (le montant non encore remboursé est prérempli), facultativement une Reason (optional), et cliquez sur Refund via Windcave. Confirmez la question Refund this amount through Windcave? This cannot be undone. Les remboursements totaux et partiels sont pris en charge. Vous devez avoir le droit de modifier l'extension (défini dans System > Users > User Groups). Les remboursements sont décomptés du montant et de la devise approuvés par Windcave ; après un écart, vous pouvez donc rembourser jusqu'à ce que le client a réellement payé, et non jusqu'au total de la commande. Un remboursement après une capture porte sur la transaction de capture. Le remboursement est envoyé à l'environnement (UAT ou production) et au compte où le paiement a été effectué ; les identifiants de cet environnement doivent donc être enregistrés. Un remboursement réussi est ajouté à l'historique des remboursements et aux notes, avec l'identifiant de transaction Windcave. Un remboursement total définit la commande en Refunded Status sans prévenir le client et sans remettre les produits en stock, comme un changement de statut manuel. Un remboursement partiel ne modifie pas le statut.

Pour un paiement Auth non capturé, le bouton est Release authorisation (void) et seul le montant total peut être libéré. Un montant partiel donne une erreur vous demandant de rembourser le montant total ou de capturer d'abord le paiement.

Si Windcave refuse le remboursement, l'onglet affiche Windcave declined the refund: avec la raison, et aucun remboursement n'est enregistré. Si Windcave traite encore le remboursement, l'onglet affiche Windcave has not confirmed the refund yet. See the order notes. et le remboursement n'est pas enregistré. Vérifiez la transaction dans Windcave Payline : si elle a été approuvée, enregistrez le remboursement manuellement ; sinon, réessayez. Une nouvelle tentative du même remboursement n'est pas envoyée deux fois à Windcave.

Les retours de produits dans Sales > Returns ne renvoient pas d'argent via Windcave. Les remboursements effectués dans Windcave Payline ne sont pas signalés à la boutique.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Windcave Payment Gateway est le premier bloc de Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit, au-dessus des réglages. Saisissez 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) et 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 se trouvent la ligne Product: opencart-payment-windcave et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs ayant le 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é 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 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 l'emplacement dans votre compte vibefox.net.

Sans clé active, Windcave n'est pas affiché aux clients au moment 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 encore 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 administrateur, 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 la notification ou lorsque le client revient, et les remboursements et captures 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

Windcave n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode actuel dispose des deux identifiants : UAT API username et UAT API key en mode test, Production API username et Production API key en mode réel. La page des réglages affiche un avertissement lorsqu'ils manquent. Vérifiez aussi 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.

Le paiement a abouti, mais la commande reste sans statut : l'extension n'a pas encore pu obtenir le résultat auprès de Windcave. Consultez le champ Log sur la page de l'extension : les erreurs sont toujours journalisées, par exemple lorsque la session n'a pas pu être vérifiée. Vérifiez que les identifiants de l'environnement du paiement sont enregistrés et corrects. La vérification est répétée lorsque Windcave renvoie la notification (l'extension répond alors payment could not be verified yet, retry later avec un code d'erreur, afin que Windcave réessaie), lorsque le client clique sur Check again et lorsque le client lance un nouveau paiement pour le même panier. Votre serveur doit accepter les requêtes de Windcave vers la Notification URL affichée dans les réglages.

La notification répond order not found : la session n'a pas été créée par cette boutique, par exemple une session d'une autre boutique qui utilise le même compte Windcave. Elle est ignorée.

Authentication failed dans le journal : le nom d'utilisateur ou la clé de l'API REST est erroné, ou il appartient à l'autre environnement. Les identifiants UAT ne fonctionnent qu'en mode test, les identifiants de production uniquement en mode réel. Les clés PxPay ne fonctionnent pas.

Le client voit que Windcave n'a pas pu démarrer le paiement avec les données de cette commande : Windcave a rejeté la demande de session, par exemple à cause de la devise ou d'un moyen de paiement non activé sur votre compte. La raison exacte figure dans le journal.

Le client voit This payment method is not available. après Confirm Order : la session de paiement ne correspond plus à la commande, ou le mode de paiement a été désactivé entre-temps. Le client recharge la page de paiement.

La commande est dans le statut de vérification après paiement : lisez les notes de l'onglet VibeFox Windcave Payment Gateway. Soit le paiement est un Auth en attente de capture, soit le montant payé, la devise ou la référence marchand différait de la commande. Capturez, traitez ou remboursez le paiement.

Paiements de test et paiements réels : UAT et production sont séparés. Chaque session est vérifiée dans l'environnement où elle a été créée, et les remboursements et captures vont dans l'environnement du paiement, même si vous changez Test mode plus tard.

Le remboursement échoue avec un message concernant l'environnement : le paiement a été effectué en UAT ou en production, et aucun identifiant de cet environnement n'est enregistré. Saisissez-les et réessayez.

Capture Windcave payment est absent de l'onglet de la commande : le bouton n'est affiché que pour les commandes en Windcave Payment On Hold Status payées avec Auth et non encore capturées ou libérées, uniquement lorsque les identifiants de l'environnement du paiement sont enregistrés, et uniquement pour les utilisateurs autorisés à modifier l'extension.

Où trouver les détails : les erreurs et avertissements sont toujours écrits dans le journal ; activez Debug log pour journaliser également les requêtes API et les événements de paiement.

Pour les développeurs : avant la création de la session Windcave, l'extension déclenche l'événement OpenCart windcave_p_session_request avec les paramètres de session et la commande.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Payments et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Windcave Payment Gateway. 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 réinstallation. L'événement OpenCart de l'extension est aussi supprimé (sur OpenCart 4, ses événements et son action de démarrage, qui laissent passer en mode maintenance la notification et le retour du client). Si Clean uninstall est activé, les autres réglages (titre, description, mode test, identifiants d'API, type de transaction, moyens de paiement, journalisation) et le journal sont supprimés. Sinon, ils sont conservés pour une réinstallation ultérieure. Les sessions, transactions et remboursements Windcave sont toujours conservés, de sorte que les commandes payées auparavant peuvent encore être remboursées et capturé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 Windcave Payment Gateway dans la liste des extensions installées, puis sur Delete (le bouton rouge corbeille) pour supprimer le paquet téléversé.

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