VibeFox eWAY for WooCommerce — Aide

Prérequis

WordPress : 6.0 ou ultérieur.

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

PHP : 8.0 ou ultérieur.

Devise de la boutique : AUD, NZD, SGD, HKD ou MYR. Pour les autres devises, le moyen de paiement est masqué au moment du paiement. La commande est débitée dans sa propre devise.

Compte eWAY : vous avez besoin d'un compte marchand eWAY avec accès à l'API Rapid, ainsi que de sa clé et de son mot de passe de l'API Rapid, disponibles dans MyeWAY sous Settings, API Key. Pour les tests, vous avez besoin d'un compte sandbox eWAY avec sa propre clé et son propre mot de passe. Les clés sandbox et production sont différentes. Rien n'est à configurer dans eWAY : l'URL de retour est envoyée avec chaque paiement.

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

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > eWAY > 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 clé et votre mot de passe d'API sandbox, laissez Sandbox Mode activé, activez Enable/Disable et passez une commande test avec la carte de test eWAY 4444333322221111.

6. Saisissez votre clé et votre mot de passe d'API production, décochez Sandbox Mode et enregistrez.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > eWAY. Au-dessus des champs, un badge indique le mode : SANDBOX (les paiements sont envoyés au sandbox eWAY, aucun argent réel n'est débité) ou LIVE (les paiements réels sont traités avec la clé d'API production). La page vous avertit lorsque la clé et le mot de passe d'API du mode actuel sont absents (la passerelle n'est alors pas affichée au paiement) et lorsque la devise de la boutique n'est pas prise en charge. Dans la liste des moyens de paiement, eWAY est signalé comme nécessitant une configuration tant que le mode actuel n'a pas d'identifiants, et un badge de mode test s'affiche en mode sandbox.

Général

Enable/Disable : Enable eWAY 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 au moment du paiement. Par défaut : Credit Card (eWAY).

Description : le texte affiché sous le moyen de paiement au moment du paiement. Par défaut : Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

Identifiants d'API

La clé et le mot de passe de l'API Rapid se trouvent dans MyeWAY sous Settings, API Key. eWAY propose des guides pour les clés production et sandbox, liés dans cette section. Sandbox et production utilisent des clés différentes.

Sandbox Mode : Enable sandbox (test) mode envoie les paiements au sandbox eWAY avec la clé sandbox. Aucun argent réel n'est débité. Par défaut : activé. Décochez-le pour encaisser des paiements réels avec la clé production.

Live API Key : la clé de l'API Rapid de votre compte eWAY production.

Live API Password : le mot de passe de l'API Rapid de votre compte eWAY production.

Sandbox API Key : la clé de l'API Rapid de votre compte sandbox (partner/developer) eWAY.

Sandbox API Password : le mot de passe de l'API Rapid de votre compte sandbox eWAY.

Commandes

Order Status on Success : le statut de la commande une fois que eWAY confirme le paiement.

Avancé

Debug log : Enable logging écrit les appels à l'API et les résultats de paiement dans WooCommerce > Status > Logs, source wcp_eway_payment_gateway. Les données de carte et les clés ne sont pas journalisées. Les erreurs sont toujours journalisées. Par défaut : désactivé.

Uninstall : Delete all plugin data on uninstall. Lorsque la case est cochée, les réglages de la passerelle et ses journaux sont supprimés à la suppression de l'extension. Les références de paiement enregistrées sur les commandes sont conservées. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut Credit Card (eWAY)) et passe la commande. L'extension demande à eWAY une page de paiement pour le montant total de la commande, dans la devise de la commande, avec le numéro de commande comme référence de facture et les coordonnées de facturation du client, puis envoie le client sur la Responsive Shared Page d'eWAY. Il y paie par carte. Le paiement est encaissé immédiatement.

Après le paiement, le client revient dans votre boutique. L'extension ne fait pas confiance au navigateur : elle demande à eWAY, de serveur à serveur, le résultat de la page de paiement créée pour cette commande. La commande n'est marquée payée qu'après confirmation d'eWAY et si le montant et la devise approuvés correspondent à la commande. Le client arrive alors sur la page de commande reçue. Si eWAY n'a pas pu être interrogé à ce moment-là, la commande reste en « En attente de paiement » et la page affiche We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. Le paiement est vérifié à nouveau à l'ouverture de la page de commande reçue et avant que WooCommerce n'annule automatiquement la commande non payée.

Si le paiement est refusé, le client revient au paiement (ou à la page Pay for order) avec la raison, par exemple Your payment was declined: Insufficient funds. Please try again or use a different payment method. Si le client clique sur Cancel sur la page eWAY, l'extension vérifie d'abord auprès d'eWAY que rien n'a été payé. Une commande passée au paiement est alors annulée, tandis qu'une commande payée depuis la page Pay for order reste impayée. Le client voit You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. Si le paiement n'a pas abouti, le message est The payment was not completed. Please try again.

Un client peut payer à nouveau une commande impayée. Chaque page de paiement de la commande est suivie, donc le paiement effectué via une page plus ancienne est tout de même reconnu. Si eWAY ne peut pas créer la page de paiement, le client voit un bref message, par exemple Payment error: Unable to connect to eWAY. Please try again.

Le moyen de paiement fonctionne sur le paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec le stockage de commandes haute performance de WooCommerce (HPOS).

eWAY n'envoie pas de notifications de serveur à serveur pour la Shared Page : le résultat est récupéré au retour du client et lors des vérifications décrites ci-dessus. L'extension n'affiche aucun champ de carte sur votre site, ne gère ni cartes enregistrées ni abonnements, ni autorisation seule et capture, et n'évalue pas les scores de fraude Beagle (les transactions bloquées par les règles antifraude d'eWAY sont refusées par eWAY lui-même).

Commandes et remboursements

Statuts de commande

Pending payment : le client a été envoyé vers eWAY et n'a pas encore payé, ou le résultat n'a pas encore pu être récupéré auprès d'eWAY (la note de commande l'indique).

Processing or Completed : le paiement a été approuvé. Le statut suit Order Status on Success. La note de commande affiche l'identifiant de transaction eWAY, le code d'autorisation et la réponse. L'identifiant de transaction de la commande est l'identifiant de transaction eWAY.

On hold after payment : eWAY a approuvé un montant ou une devise différents de ceux de la commande (par exemple Approved for partial amount, ou la commande a été modifiée après l'ouverture de la page de paiement par le client), ou le paiement a été approuvé après l'annulation de la commande. La note l'explique. Sur la page de commande reçue, le client voit Your payment was received and is being reviewed by the store. We will contact you if anything is needed. Finalisez la commande ou remboursez le paiement.

Failed : eWAY a refusé le paiement. La note affiche le code eWAY et sa signification.

Cancelled : le client a annulé sur la page eWAY après avoir passé la commande au paiement, ou la commande a été annulée par vous ou par le délai de maintien des stocks de WooCommerce, après que eWAY a confirmé qu'elle n'était pas payée.

Si un second paiement est approuvé pour une commande déjà payée, la commande ne change pas. Une note vous demande de rembourser le doublon dans MyeWAY.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Credit Card (eWAY) (le bouton reprend le titre du moyen de paiement). Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé dans l'environnement où le paiement a été effectué (sandbox ou production), donc la clé et le mot de passe d'API de cet environnement doivent être renseignés. Si eWAY refuse le remboursement, WooCommerce affiche le code eWAY et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant de transaction du remboursement eWAY.

Les remboursements effectués dans MyeWAY ne sont pas synchronisés avec WooCommerce. Si nécessaire, créez un remboursement manuel dans WooCommerce sans utiliser le bouton de remboursement eWAY.

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 > eWAY. 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, eWAY 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. Les gestionnaires de la boutique connectés voient toujours le moyen de paiement, marqué (unlicensed — visible to admins only), afin de pouvoir 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 fonctionnent.

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

eWAY does not appear at checkout : vérifiez que la licence est active, que Enable/Disable est activé, que la clé et le mot de passe d'API du mode actuel sont renseignés (champs sandbox en mode sandbox, champs production en mode production) et que la devise de la boutique est AUD, NZD, SGD, HKD ou MYR. Sur la page Pay for order, la devise de la commande est vérifiée.

The payment went through, but the order stays Pending payment : le client n'est pas revenu depuis eWAY, ou eWAY n'a pas pu être interrogé à ce moment-là. eWAY n'envoie aucune notification pour la Shared Page. Le paiement est vérifié à nouveau à l'ouverture de la page de commande reçue et avant que WooCommerce n'annule la commande non payée. Vérifiez la transaction dans MyeWAY et consultez WooCommerce > Status > Logs, source wcp_eway_payment_gateway.

Le client voit le message This payment method is temporarily unavailable : la clé ou le mot de passe d'API du mode actuel sont absents, ou eWAY les a refusés. Vérifiez les identifiants du mode actuel.

Le client voit le message eWAY could not start the payment : eWAY a renvoyé des codes d'erreur, affichés dans le message. Souvent, les coordonnées de facturation sont invalides.

Le client voit le message We could not match this payment to an order : le lien de retour n'appartient à aucune commande de cette boutique. Si le client a été débité, retrouvez le paiement dans MyeWAY.

Le client voit le message We could not confirm your payment with eWAY : le résultat du paiement n'a pas pu être vérifié. La commande est mise à jour lorsque le résultat est récupéré ; le client ne doit pas payer à nouveau.

Order is On hold after payment : lisez la note de commande. Le montant ou la devise approuvés différaient de la commande, ou le paiement est arrivé après l'annulation de la commande. Finalisez la commande ou remboursez le paiement.

Le remboursement échoue avec un message concernant le mode sandbox ou production : la commande a été payée dans cet environnement, et sa clé et son mot de passe d'API ne sont pas renseignés. Saisissez-les et réessayez.

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

Pour les développeurs, le fichier readme mentionne le filtre eway_p_supported_currencies, si votre compte eWAY est activé pour davantage de devises.

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 ne sont supprimés que si l'option Uninstall (Delete all plugin data on uninstall) était activée. Sinon, ils sont conservés pour une future réinstallation. Les références de paiement enregistrées sur les commandes sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

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