VibeFox Windcave for WooCommerce — Aide

Prérequis

WordPress: 6.0 ou ultérieur.

WooCommerce: 8.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.

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 gestionnaire 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.

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

Installation

1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier wcp_windcave_payment_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Windcave > Manage, ou cliquez sur Settings sous le nom de l'extension sur la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. 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).

6. Choisissez le type de transaction et les moyens de paiement, activez Enable/Disable et enregistrez. Effectuez un paiement de test avec Test mode activé, puis désactivez Test mode pour encaisser de vrais paiements.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Windcave. 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. Dans la liste des moyens de paiement, Windcave est signalé comme nécessitant une configuration tant que le mode actuel ne dispose pas à la fois d'un nom d'utilisateur et d'une clé d'API. La version de l'extension est affichée en bas de la page.

Général

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

Title: le nom du moyen de paiement que voient les clients au moment du paiement. Par défaut : Credit/Debit Card (Windcave).

Description: le texte affiché sous le moyen de paiement au moment du paiement. Par défaut : You will be redirected to the secure Windcave payment page to complete your payment.

Windcave REST API

Saisissez les identifiants de l'API REST délivrés par Windcave (nom d'utilisateur et clé d'API, pas 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 uniquement ceux de production.

Test mode: Use the Windcave UAT test environment (uat.windcave.com). Aucun argent réel n'est débité. Les nouveaux paiements utilisent les identifiants UAT. Les remboursements et les captures sont toujours envoyés dans l'environnement où la commande a été payée. Par défaut : désactivé.

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).

Paiement

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

Purchase (capture immediately): l'argent est encaissé au moment où le client paie.

Auth (authorise now, capture later): l'argent est seulement réservé. La commande passe En attente, et vous encaissez l'argent avec Capture Windcave payment dans les actions de commande, ou vous le libérez en remboursant le montant total. Les autorisations non capturées expirent au bout de quelques jours.

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. Ils doivent être activés sur votre compte Windcave. Laissez le champ vide pour afficher tous les moyens activés sur le compte. Par défaut : Cards.

Avancé

Debug log: Log API requests and payment events. Le journal se trouve dans WooCommerce > Status > Logs, source wcp_windcave_payment_gateway. Les erreurs et avertissements sont toujours journalisés ; cette option ajoute les requêtes API et les événements de paiement. Les clés d'API, les données de carte et les données personnelles des clients sont masquées. Par défaut : désactivé.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Les données de paiement enregistrées sur les commandes (identifiants de transaction Windcave nécessaires aux remboursements) sont toujours conservées. Par défaut : désactivé.

URL de notification

Vous n'avez pas besoin de configurer une URL de notification chez Windcave. L'extension envoie ses adresses de retour et son adresse de notification avec chaque session de paiement. Windcave envoie la notification (Fail-Proof Result Notification) à https://your-site/wc-api/windcave_p_notification/. Ni le retour du client ni la notification ne sont signés par Windcave : l'extension ne leur fait donc jamais confiance seuls. Elle lit toujours le résultat de la session via l'API REST de Windcave, avec vos identifiants de l'environnement dans lequel la session a été créée.

Paiement

Le client choisit le moyen de paiement (par défaut Credit/Debit Card (Windcave)) et passe la commande. 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 vers la Windcave Hosted Payment Page. Le numéro de commande est transmis comme référence marchande, avec la langue de la boutique et le nom, l'adresse e-mail, le téléphone ainsi que les adresses de facturation et de livraison du client. En mode test, le bloc Paiement affiche Test mode: payments go to the Windcave UAT environment, no real money is taken. sous le moyen de paiement.

Après le paiement, le client revient sur la page de confirmation de commande de votre boutique. La commande n'est marquée payée qu'après confirmation de Windcave : l'extension demande à l'API REST de Windcave le résultat de la session, à la fois au retour du client et à l'arrivée de la notification de Windcave. Un verrou par commande garantit que le paiement n'est appliqué qu'une seule fois. Si le résultat n'est pas encore connu, la page de confirmation le vérifie une fois de plus et 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.

Si le client revient sans paiement abouti, la page de paiement (ou la page Pay for order, si la tentative a commencé là) affiche l'un de ces messages :

Declined: votre paiement a été refusé. Veuillez réessayer ou choisir un autre moyen de paiement.

Cancelled or expired: le paiement n'a pas été finalisé sur la page Windcave. Votre commande est enregistrée : vous pouvez réessayer ou choisir un autre moyen de paiement.

Not confirmed yet: nous n'avons pas encore pu confirmer votre paiement. Si vous l'avez effectué, ne payez pas à nouveau : vous recevrez un e-mail de confirmation dès que Windcave l'aura validé.

Return could not be processed: nous n'avons pas pu traiter votre retour depuis la page de paiement. Si un montant a été débité, contactez-nous avant de payer à nouveau.

Le panier n'est pas vidé et le stock n'est pas décrémenté avant que le client ait payé. Un client peut payer à nouveau une commande impayée, par exemple depuis la page Pay for order. Une nouvelle tentative vérifie d'abord la session précédente : si elle est déjà payée, aucun second paiement n'est créé ; si le client n'a jamais utilisé la page de paiement et que la commande n'a pas changé, il est renvoyé vers la même page. Si le paiement précédent est en cours de confirmation à ce moment-là, 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 voit un bref message indiquant que Windcave n'a pas pu lancer le paiement avec les détails de cette commande, ou que le service de paiement est temporairement indisponible. La raison est ajoutée aux notes de commande. Si le mode actuel ne dispose d'aucun identifiant, le client voit This payment method is not available at the moment. Please choose another payment method or contact us.

Le moyen de paiement fonctionne sur le paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

L'extension ne propose 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 prise en charge de l'API PxPay 2.0, et n'ajoute aucune surtaxe. Si Windcave ajoute une surtaxe, la commande est rapprochée de la transaction principale.

Commandes et remboursements

Statuts de commande

Pending payment: le client a été envoyé vers Windcave et n'a pas encore payé, ou Windcave n'a pas encore confirmé le paiement. Si le client annule ou si la session expire, la commande reste En attente de paiement et une note est ajoutée.

Processing or Completed: un paiement Purchase a été confirmé. WooCommerce passe la commande en En cours, ou en Terminée pour les commandes sans expédition, comme d'habitude. La note de commande indique le montant, l'identifiant de transaction Windcave, le code d'autorisation, le type de carte avec le numéro masqué et l'environnement (UAT ou production). L'identifiant de transaction de la commande est l'identifiant de transaction Windcave.

On hold (authorised): un paiement Auth a été approuvé mais pas encore capturé. La note de commande explique comment le capturer ou le libérer.

On hold (does not match): Windcave a transmis un montant, une devise, une référence marchande ou un type de transaction différent de la commande (par exemple, la commande a été modifiée après le début du paiement). La note liste les écarts. Vérifiez le paiement dans Windcave Payline avant l'expédition, et remboursez-le si nécessaire.

Failed: le paiement a été refusé. La note affiche le texte et le code de réponse de Windcave. Le client peut réessayer.

Si un paiement approuvé arrive pour une commande annulée, ou un second paiement approuvé pour une commande déjà payée, 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).

Capture (mode Auth)

Ouvrez la commande, choisissez Capture Windcave payment dans les actions de commande et cliquez sur le bouton de mise à jour. L'action n'apparaît que pour une commande En attente avec une autorisation non encore capturée ou libérée. Le total de la commande est capturé, la capture est ajoutée aux notes de commande et la commande passe au statut de commande payée (en général En cours). Si Windcave refuse la capture, l'écran de commande affiche Windcave capture failed: avec la raison, et cette raison est ajoutée aux notes de commande.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Windcave. Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé à l'environnement (UAT ou production) et au compte dans lequel le paiement a été effectué ; les identifiants de cet environnement doivent donc être enregistrés. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant de transaction Windcave.

Pour un paiement Auth non capturé, seul un remboursement total est possible : il libère (annule) l'autorisation. Un montant partiel génère une erreur vous demandant de rembourser le montant total ou de capturer d'abord le paiement.

Si Windcave refuse le remboursement, WooCommerce affiche Windcave declined the refund: avec la raison, et aucun remboursement n'est enregistré. Si Windcave traite encore le remboursement, WooCommerce 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 tentative répétée du même remboursement n'est pas envoyée deux fois à Windcave. Les remboursements effectués dans Windcave Payline ne sont pas remontés à la boutique.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > Windcave. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active, et votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.

Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas l'emplacement du domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, Windcave n'est pas affiché aux clients au moment du paiement. Si un paiement est lancé malgré tout, le client voit This payment method is not available. Please choose another one. Les gestionnaires connectés de la boutique continuent de voir le moyen de paiement, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés, 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 en arrière-plan.

Dépannage

Windcave does not appear at checkout: 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.

The payment went through, but the order stays Pending payment: l'extension n'a pas encore pu obtenir le résultat auprès de Windcave. Ouvrez les notes de commande : une note indique quand la session n'a pas pu être vérifiée et pourquoi. 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 par une erreur jusqu'à ce que le résultat puisse être vérifié, afin que Windcave réessaie) et lorsque le client ouvre la page de confirmation de commande. Votre serveur doit accepter les requêtes de Windcave vers https://your-site/wc-api/windcave_p_notification/.

Authentication failed in the order notes or the log: le nom d'utilisateur ou la clé de l'API REST est incorrect, ou appartient à l'autre environnement. Les identifiants UAT ne fonctionnent qu'en mode test, ceux de production uniquement en mode réel. Les clés PxPay ne fonctionnent pas.

The customer sees that Windcave could not start the payment with the details of this order: 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 les notes de commande et dans le journal.

Order is On hold after payment: lisez la note de commande. Soit le paiement est un Auth qui attend une capture, soit le montant payé, la devise ou la référence marchande ne correspondait pas à la commande. Capturez, expédiez ou remboursez le paiement.

Test payments and live payments: 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 sont envoyés à l'environnement du paiement, même si vous changez Test mode plus tard. Les commandes créées avec la version 1.0 de l'extension utilisent l'environnement de l'ancien réglage API URL.

Refund fails with a message about the environment: 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 is missing in the order actions: l'action n'est affichée que pour les commandes En attente payées avec Auth et non encore capturées ou libérées.

Where to find details: les erreurs et avertissements sont toujours écrits dans WooCommerce > Status > Logs, source wcp_windcave_payment_gateway. Activez Debug log pour journaliser également les requêtes API et les événements de paiement.

The license block shows an error: suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net et cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé pour le nouveau domaine. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Désinstallation

Désactiver l'extension conserve toutes les données. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension sont toujours supprimés. Les réglages de la passerelle, les options de l'extension et les journaux (fichiers de log, y compris ceux archivés, et entrées de journal en base de données) ne sont supprimés que si Clean uninstall était activé. Sinon, ils restent pour une réinstallation ultérieure. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction Windcave.

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