VibeFox Quickpay for WooCommerce — Aide

Prérequis

WordPress : 6.2 ou ultérieur.

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

PHP : 8.0 ou ultérieur.

Compte Quickpay : vous avez besoin de deux valeurs du gestionnaire Quickpay : la clé API d'un utilisateur API (pour créer les paiements, capturer et rembourser) et la clé privée du compte (pour vérifier la signature des callbacks Quickpay). Rien d'autre n'a besoin d'être configuré dans Quickpay. Votre site doit être accessible depuis Internet, sans protection par mot de passe ni mode maintenance, pour que les callbacks Quickpay puissent arriver.

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_quickpay_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Quickpay > 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. Collez la clé API et la clé privée du gestionnaire Quickpay et cliquez sur Test API key (voir Configuration).

6. Choisissez le mode de capture et le statut de commande après paiement, activez Enable/Disable et enregistrez. Tant que votre compte Quickpay est en mode test, activez Test payments et effectuez un paiement avec une carte de test Quickpay.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Quickpay. Tant que la clé API et la clé privée ne sont pas saisies, Quickpay est signalé comme nécessitant une configuration dans la liste des moyens de paiement et est masqué au paiement, car un paiement ne pourrait ni être créé ni être confirmé.

Général

Enable/Disable : Enable Quickpay 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 paiement. Par défaut : Quickpay.

Description : le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay securely by card or MobilePay on the Quickpay payment page.

Identifiants API Quickpay

Dans le gestionnaire Quickpay (manage.quickpay.net), ouvrez Settings > Integration. Copiez la clé API d'un utilisateur API (Settings > Users) et la clé privée du compte. La section affiche aussi l'URL de callback de votre boutique, qui ressemble à https://your-site/wc-api/qpg_quickpay/. Elle est envoyée automatiquement avec chaque paiement, donc rien n'a besoin d'être configuré dans Quickpay.

API key : la clé API d'un utilisateur API Quickpay. Elle sert à créer les paiements, à capturer et à rembourser.

Sous le champ, le bouton Test API key vérifie la clé saisie dans le champ (ou celle enregistrée, si le champ est vide) par une requête authentifiée vers Quickpay. Il répond Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured. ou Connection failed: suivi de la raison.

Private key : la clé privée du compte. Elle sert à vérifier la signature (HMAC-SHA256) des callbacks Quickpay. Sans elle, aucun paiement ne peut être confirmé, et les callbacks sont rejetés.

Test payments : Accept payments made with Quickpay test cards. Quickpay n'a pas de sandbox séparé : tant que votre compte Quickpay est en mode test, les paiements sont effectués avec des cartes de test et signalés comme tels. N'activez cela que pendant les tests. Lorsqu'il est désactivé, un paiement de test ne marque jamais une commande comme payée, et la commande reçoit une note à la place. Lorsqu'il est activé, le paiement affiche Test mode: Quickpay test cards are accepted. Par défaut : désactivé.

Paiement

Capture : le moment où l'argent est prélevé sur la carte.

Order status after payment : le statut de la commande une fois que Quickpay a confirmé le paiement capturé. Le statut est défini immédiatement, avec un seul changement de statut et un seul envoi d'e-mails.

Avancé

Debug log : Enable logging. Le journal se trouve dans WooCommerce > Status > Logs, source wcp_quickpay_gateway. Les erreurs et avertissements, comme les callbacks rejetés et les erreurs de l'API Quickpay, sont toujours journalisés. Activez ceci pour journaliser aussi chaque requête et chaque callback. Les clés API, les données de carte et les données clients ne sont jamais journalisées. Par défaut : désactivé.

Delete data : Delete the gateway settings and logs when the plugin is deleted. Désactiver l'extension ne supprime jamais rien. Les données de commande (identifiants de paiement Quickpay, notes) sont toujours conservées. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut Quickpay, affiché avec les icônes Visa et Mastercard) et passe la commande. L'extension crée pour la commande un paiement Quickpay dans la devise de la commande et un lien de paiement pour le montant total, puis envoie le client vers la fenêtre de paiement Quickpay. Le client y paie avec l'une des méthodes activées dans votre fenêtre de paiement Quickpay. L'e-mail de facturation est transmis à Quickpay. La fenêtre de paiement s'ouvre dans la langue de votre site lorsque Quickpay la propose (danois, allemand, anglais, espagnol, finnois, français, italien, néerlandais, norvégien, polonais, suédois), sinon en anglais.

Après le paiement, le client revient sur la page de confirmation de commande de votre boutique. Le retour lui-même ne marque rien comme payé. La commande n'est marquée payée qu'après que Quickpay l'a confirmée par le callback signé et que le montant et la devise correspondent à la commande. Avec Authorize only, la commande passe à la place au statut En attente, et vous capturez le paiement plus tard.

Si le client annule sur la fenêtre de paiement pendant le paiement, la commande non payée est annulée de la façon standard de WooCommerce et le panier est restauré. Sur la page Pay for order, l'annulation renvoie le client sur cette page, de sorte que la commande reste payable. Un paiement échoué ou annulé peut être retenté : la nouvelle tentative réutilise le paiement Quickpay de la commande avec un nouveau lien, de sorte qu'un ancien lien ne peut jamais être payé en parallèle. Lorsqu'une commande non payée est annulée, son lien de paiement est supprimé dans Quickpay.

Si le paiement ne peut pas être lancé, le client voit The Quickpay payment could not be started. Please try again or choose another payment method. La raison technique est ajoutée aux notes de la commande et au journal. Si les clés sont absentes, le client voit Quickpay is not available at the moment. Please choose another payment method.

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 gère que les paiements uniques. Elle ne gère ni abonnements ni paiements récurrents, ni cartes enregistrées, ni frais de paiement, n'envoie aucun panier ni aucune ligne de facture à Quickpay, et n'a pas de méthodes séparées MobilePay, Apple Pay ou Klarna : le client choisit parmi les méthodes de votre fenêtre de paiement Quickpay.

Commandes et remboursements

Statuts de commande

Pending payment: le client a été envoyé vers Quickpay et n'a pas encore payé. Avec la capture automatique, un paiement autorisé en attente de capture est noté sur la commande.

Processing or Completed: Quickpay a confirmé le paiement capturé, avec le bon montant et la bonne devise. Le statut suit Order status after payment. La note de commande affiche l'identifiant de paiement Quickpay (marqué TEST pour les paiements de test), et il est enregistré comme identifiant de transaction de la commande.

On hold: le paiement est seulement autorisé et attend Capture Quickpay payment ; ou Quickpay a signalé un montant ou une devise différent du total de la commande (par exemple, la commande a été modifiée après le début du paiement, ou un autre montant a été capturé dans le gestionnaire Quickpay) ; ou la capture a échoué et le montant est toujours seulement réservé. La note de commande l'explique, y compris lorsque la commande était déjà En attente.

Failed: la tentative de paiement a été refusée. Le client peut payer à nouveau.

Cancelled: le client a annulé sur la fenêtre de paiement, la commande a été annulée par vous ou par le délai de maintien de stock de WooCommerce, ou le paiement a été annulé dans le gestionnaire Quickpay.

Un paiement reçu pour une commande déjà payée, annulée ou remboursée ne modifie pas la commande. Une note vous demande de vérifier le paiement dans le gestionnaire Quickpay, par exemple pour rembourser un double paiement.

Capture

Avec Authorize only, ouvrez la commande, choisissez Capture Quickpay payment dans les actions de la commande et cliquez sur le bouton de mise à jour. Le total de la commande est capturé ; la capture partielle n'est pas disponible. Si Quickpay confirme immédiatement, la commande est marquée payée. Sinon, une note indique que la capture a été demandée, et la commande est marquée payée lorsque le callback Quickpay la confirme. Une capture refusée est affichée sur l'écran de la commande et notée sur la commande.

L'annulation d'une commande autorisée ne libère pas automatiquement le montant réservé. La note de commande vous rappelle d'annuler le paiement dans le gestionnaire Quickpay ; sinon, la réservation prend fin lorsque l'autorisation expire.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Quickpay. Les remboursements totaux et partiels sont pris en charge pour les paiements capturés. Quickpay traite les remboursements de manière asynchrone : une note indique que le remboursement a été demandé, et le callback ajoute le résultat final, confirmed ou FAILED avec la raison. Si Quickpay refuse le remboursement immédiatement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Un paiement autorisé qui n'a jamais été capturé ne peut pas être remboursé ; annulez-le dans le gestionnaire Quickpay.

Les paiements et remboursements effectués directement dans le gestionnaire Quickpay sont seulement notés sur la commande. Ils ne sont pas enregistrés automatiquement comme remboursements WooCommerce. Si nécessaire, créez un remboursement manuel dans WooCommerce sans utiliser Refund via Quickpay.

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 > Quickpay. 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 son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, Quickpay n'est pas proposé aux clients au paiement. Si un paiement est tout de même lancé, le client voit This payment method is not available. Please choose another one. Les gestionnaires de boutique connectés voient toujours 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 la capture 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 en arrière-plan.

Dépannage

Quickpay n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que API key et Private key sont saisies. Sans les deux clés, le moyen de paiement est masqué.

Le paiement a abouti, mais la commande reste Pending payment : le callback Quickpay n'a pas atteint votre boutique ou a été refusé. Vérifiez que votre site est accessible depuis Internet (sans protection par mot de passe ni mode maintenance) et que Private key est la clé privée du même compte Quickpay. Les callbacks refusés sont toujours écrits dans WooCommerce > Status > Logs, source wcp_quickpay_gateway. Activez Debug log pour voir chaque callback.

Le journal affiche Callback rejected: invalid checksum.: la clé privée des réglages n'appartient pas au compte qui a envoyé le callback. Copiez-la à nouveau depuis Settings > Integration dans le gestionnaire Quickpay.

Le journal affiche Callback rejected: the private key is not configured.: saisissez la clé privée. Les callbacks ne sont jamais acceptés sans elle.

Le journal affiche Callback: no order found for payment …: le callback concerne un paiement Quickpay qu'aucune commande de cette boutique ne connaît, par exemple un paiement créé en dehors de WooCommerce ou pour une commande supprimée.

Le journal affiche Callback: order #… is locked by another request.: un autre callback de la même commande était en cours d'application à ce moment-là. Le callback reçoit une réponse d'erreur, il n'est donc pas considéré comme traité. Si la commande reste inchangée, vérifiez le paiement dans le gestionnaire Quickpay.

Un paiement de test n'a pas marqué la commande comme payée : Test payments est désactivé. La note de commande indique que le paiement de test n'a pas été accepté. Activez le réglage pendant les tests, et désactivez-le lorsque votre compte passe en production.

La commande est On hold après le paiement : lisez la note de commande. Le paiement peut n'être qu'autorisé et attendre Capture Quickpay payment, le montant ou la devise payés peuvent différer de la commande, ou la capture a échoué. Capturez, exécutez la commande ou remboursez le paiement dans le gestionnaire Quickpay.

Test API key says Quickpay rejected the API key.: la clé est incorrecte ou appartient à un utilisateur sans accès API. Copiez la clé API d'un utilisateur API depuis le gestionnaire Quickpay.

Le client voit The Quickpay payment could not be started.: ouvrez les notes de la commande ou le journal. La note affiche l'erreur Quickpay, par exemple une devise que votre compte Quickpay n'accepte pas.

Le remboursement échoue : la commande doit avoir un paiement Quickpay capturé. Le message The Quickpay payment of this order has not been captured — there is nothing to refund. signifie que le paiement n'est qu'autorisé ; annulez-le plutôt dans le gestionnaire Quickpay.

Le bloc de licence affiche une erreur : suivez le message du 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 et les journaux de l'extension (fichiers journaux, y compris ceux qui ont été archivés, et entrées de journal en base de données) ne sont supprimés que si Delete data était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

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