VibeFox EveryPay for WooCommerce — Aide

Prérequis

WordPress : 6.0 ou ultérieur.

WooCommerce : 7.0 ou ultérieur, installé et activé.

PHP : 8.0 ou ultérieur.

Compte EveryPay : vous avez besoin du nom d'utilisateur API, du secret API et du nom du compte de traitement de votre boutique en ligne. Ils se trouvent dans le Merchant Portal d'EveryPay, dans les paramètres de votre boutique : le portail de démonstration (mwt-demo.every-pay.com) pour le mode test, et le portail de production (portal.every-pay.eu) pour les paiements réels. Les environnements de test et de production ont des identifiants distincts. Vous devez également configurer l'URL de callback de votre boutique dans les deux portails (voir Configuration).

Devise de la boutique : le compte de traitement définit la devise débitée ; par exemple, EUR3D1 débite en EUR. Le moyen de paiement n'est proposé que pour les commandes dans cette devise.

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

2. Cliquez sur Activate.

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

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

5. Saisissez le nom d'utilisateur API de test, le secret API de test et le nom du compte de traitement du Merchant Portal de démonstration. Laissez Test Mode activé.

6. Copiez l'URL de callback affichée sur la page des réglages dans Callback notification URL de votre boutique, dans le Merchant Portal.

7. Activez Enable/Disable et passez une commande de test. Lorsque tout fonctionne, saisissez les identifiants de production, configurez aussi l'URL de callback dans le portail de production et décochez Test Mode.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > EveryPay. Au-dessus des champs, la page affiche Test mode is on: payments go to the EveryPay demo environment, no real money is charged. tant que le mode test est activé. Elle vous avertit lorsque la passerelle est activée mais que le nom d'utilisateur API, le secret API ou le compte de traitement du mode actuel manque (le moyen de paiement est alors masqué sur la page de paiement), et lorsque le compte de traitement débite une autre devise que la devise de la boutique. Dans la liste des moyens de paiement, EveryPay est signalé comme nécessitant une configuration tant que le mode actuel n'est pas configuré. Les espaces et les sauts de ligne collés avec les identifiants sont supprimés à l'enregistrement.

Général

Enable/Disable: Enable EveryPay payment gateway active ou désactive le moyen de paiement. Par défaut : désactivé.

Title: le nom du moyen de paiement que voient les clients sur la page de paiement. Par défaut : EveryPay.

Description: le texte affiché sous le moyen de paiement sur la page de paiement. Par défaut : Pay securely by card or bank link on the EveryPay payment page.

Compte EveryPay

Le nom d'utilisateur API, le secret API et le nom du compte de traitement figurent dans le Merchant Portal d'EveryPay (paramètres de la boutique) : le portail de démonstration pour le mode test, le portail de production pour les paiements réels.

Test Mode: Enable test mode envoie les paiements à l'environnement de démonstration d'EveryPay avec les identifiants de test. Aucun argent réel n'est débité. Par défaut : activé.

Test API Username: le nom d'utilisateur API de l'environnement de démonstration.

Test API Secret: le secret API de l'environnement de démonstration.

Live API Username: le nom d'utilisateur API de l'environnement de production.

Live API Secret: le secret API de l'environnement de production.

Processing Account Name: le compte de traitement EveryPay, par exemple EUR3D1. Le compte définit la devise débitée : la passerelle n'est proposée que pour les commandes dans cette devise. Le même nom de compte est utilisé dans les deux modes.

Notifications de paiement (callback)

Le callback indique à votre boutique qu'un paiement a été finalisé, de sorte que les commandes sont mises à jour même si le client ferme le navigateur. Copiez l'URL affichée dans cette section dans Callback notification URL de votre boutique, dans le Merchant Portal d'EveryPay, à la fois pour la démonstration et la production. L'URL ressemble à https://your-site/wc-api/wc_evp_payment/. La requête de paiement ne transporte pas d'URL de callback : elle doit donc être renseignée dans le portail.

Le callback ne contient que des références de paiement. À sa réception, l'extension demande à l'API EveryPay le statut du paiement dans l'environnement où il a été créé, et vérifie que la réponse appartient à cette commande. Les callbacks concernant un paiement que la commande n'a pas créé sont rejetés. Sans callback, une commande est confirmée lorsque le client revient dans la boutique après avoir payé, ou lorsque vous lancez Check EveryPay payment status sur la commande.

Avancé

Debug log: Log payment events écrit les événements de paiement dans WooCommerce > Status > Logs, source wcp_everypay_payment. Les erreurs sont toujours journalisées. Les secrets API et les données de carte ne sont jamais journalisés. Par défaut : désactivé.

Uninstall: Delete the gateway settings and logs when the plugin is deleted. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut EveryPay) et passe la commande. En mode test, la page de paiement affiche TEST MODE: EveryPay demo environment, no real money is charged. L'extension crée un paiement EveryPay unique pour le total de la commande, avec l'e-mail et les données de facturation du client, et envoie le client sur la page de paiement EveryPay. La langue de la page suit la langue du site (anglais, estonien, russe, letton, lituanien, finnois ou allemand ; sinon anglais). Le client y paie avec l'un des moyens activés pour votre compte EveryPay.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'après confirmation d'EveryPay : l'extension interroge l'API EveryPay sur le statut du paiement au retour du client et lors du callback. Une commande payée, une commande en cours de vérification ou un paiement encore en cours de traitement mène à la page « Commande reçue ».

Si le paiement échoue, le client revient à la page de paiement (ou à la page Pay for order) avec le message Your EveryPay payment was not successful. Please try again or choose another payment method. Si le client a quitté la page de paiement sans payer, le message est The EveryPay payment was not completed. You can try again or choose another payment method. Chaque nouvelle tentative crée un nouveau paiement EveryPay ; les tentatives précédentes sont mémorisées, de sorte qu'un paiement effectué avec un ancien lien est tout de même reconnu.

Si EveryPay ne peut pas démarrer le paiement, le client voit un bref message, par exemple EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. Les détails figurent dans le journal.

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). Les textes destinés aux clients sont traduits en estonien.

L'extension ne prend en charge que les paiements uniques. Elle ne propose ni remboursements ni captures depuis WooCommerce, ni cartes enregistrées ou paiements en un clic, ni abonnements ou paiements récurrents, ni champs de carte intégrés, et elle ne gère pas plusieurs devises.

Commandes

Statuts de commande

Pending payment: le client a été envoyé vers EveryPay et n'a pas encore payé, ou le paiement est encore en cours de traitement.

Processing: EveryPay a signalé le paiement comme réglé ou autorisé (les commandes ne contenant que des produits virtuels téléchargeables passent à Terminée, le comportement par défaut de WooCommerce). La note de commande indique le montant, la devise et la référence du paiement. L'ID de transaction de la commande est la référence du paiement EveryPay. Pour un paiement autorisé, la note indique que les fonds sont réservés : si votre compte ne capture pas automatiquement, capturez le paiement dans le Merchant Portal d'EveryPay. Lorsqu'il est réglé plus tard, une note l'indique.

On hold after payment: le paiement nécessite une vérification manuelle. Le montant ou la devise payés diffèrent de la commande, la commande avait été annulée avant l'arrivée du paiement, ou la commande utilise désormais un autre moyen de paiement. La note l'explique et indique que la commande n'a pas été marquée payée. Vérifiez le paiement dans le Merchant Portal, puis finalisez-le ou remboursez-le manuellement. Les callbacks ultérieurs de ce paiement ne finalisent pas la commande automatiquement.

Failed: la dernière tentative de paiement d'une commande non payée a échoué, a été abandonnée ou annulée (void). La note indique la raison donnée par EveryPay. Le client peut réessayer.

Si un second paiement est effectué pour une commande déjà payée, la commande ne change pas. Une note vous demande de rembourser le paiement en double dans le Merchant Portal d'EveryPay.

Check EveryPay payment status

Sur l'écran de la commande, choisissez l'action de commande Check EveryPay payment status. L'extension vérifie chaque paiement EveryPay de la commande auprès de l'API, applique le résultat comme indiqué ci-dessus et ajoute une note indiquant l'état de chaque paiement. Utilisez cette action pour les commandes dont le callback n'est jamais arrivé.

Remboursements

Les remboursements depuis WooCommerce ne sont pas pris en charge. Remboursez dans le Merchant Portal d'EveryPay, puis modifiez le statut de la commande dans WooCommerce. Lorsque EveryPay signale un paiement comme remboursé ou rétrofacturé, l'extension ajoute seulement une note à la commande ; le statut de la commande ne change pas.

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 > EveryPay. 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, EveryPay n'est pas affiché aux clients sur la page de 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 la 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 Extensions 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 vérification du statut fonctionne.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

EveryPay n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le nom d'utilisateur API, le secret API et le Processing Account Name du mode actuel sont renseignés, et que la devise de la boutique (sur la page Pay for order, la devise de la commande) est celle du compte de traitement. La page des réglages affiche un avertissement dans ces cas.

Le paiement a abouti, mais la commande reste en Pending payment : le callback ne fonctionne pas. Vérifiez que l'URL de callback des réglages est renseignée dans Callback notification URL du Merchant Portal du mode utilisé (démonstration ou production). Vous pouvez aussi ouvrir la commande et lancer Check EveryPay payment status. Activez Debug log et consultez WooCommerce > Status > Logs, source wcp_everypay_payment.

Le callback répond Unknown payment reference ou Payment does not belong to this order : le paiement n'a pas été créé par cette commande, ou la réponse d'EveryPay ne lui correspond pas. La commande n'est pas modifiée.

Le callback répond Not configured : les identifiants de l'environnement où le paiement a été créé sont manquants, par exemple pour un paiement de test après la suppression des identifiants de test. Saisissez-les à nouveau ; EveryPay relance le callback.

Le callback répond Payment status unavailable ou Busy, please retry : l'API EveryPay était injoignable, ou la commande était en cours de mise à jour par une autre requête au même moment. EveryPay relance le callback.

Le client voit EveryPay is temporarily unavailable : EveryPay a refusé les identifiants ou était injoignable. Vérifiez le nom d'utilisateur API et le secret API du mode actuel.

Le client voit This payment method does not support the order currency : la devise de la commande diffère de celle du compte de traitement.

La commande est On hold after payment : lisez la note de commande. Le montant ou la devise différaient, ou la commande avait été annulée avant l'arrivée du paiement. Vérifiez le paiement dans le Merchant Portal, puis finalisez-le ou remboursez-le manuellement.

Le bloc de licence affiche une erreur : 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 puis 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.

Pour les développeurs, la documentation de l'extension répertorie les filtres wc_evp_icon, wc_evp_locale, wc_evp_currency_decimals et wc_evp_oneoff_request.

Désinstallation

La désactivation de 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 ne sont supprimés que si Uninstall (Delete the gateway settings and logs when the plugin is deleted) était activé. Sinon, ils restent en place pour une réinstallation ultérieure. Les références de paiement EveryPay enregistrées sur les commandes sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs ID de transaction.

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