VibeFox Autopay 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.
Service Autopay : vous avez besoin du Service ID et de la Shared key (clé de hachage) de votre service Autopay. Ils sont affichés dans le portail marchand Autopay : portal.autopay.eu pour la production, testportal.autopay.eu pour les tests. Les services de test ont leur propre Service ID et Shared key ; demandez à Autopay d'en ouvrir un. La fonction de hachage du service doit être SHA-256.
Devise : la devise de la boutique doit être PLN, EUR, GBP, USD ou CZK et être acceptée par votre service Autopay.
Boutique accessible : Autopay doit pouvoir envoyer des notifications à votre boutique. Elle doit donc être joignable depuis Internet, sans mode maintenance, sans authentification de base et sans pare-feu bloquant les requêtes POST.
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 téléverser le dossier wcp_autopay_payment dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > Autopay > 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 Service ID et la Shared key (test et production), puis choisissez les devises de votre service.
6. Dans le portail Autopay, configurez l'URL ITN, l'URL de retour et la fonction de hachage SHA-256 pour votre service (voir Configuration).
7. Activez Enable/Disable. Passez une commande de test en mode test, puis décochez Test mode pour les paiements réels.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Autopay. Au-dessus des champs, la page vous avertit lorsque le Service ID ou la Shared key de l'environnement sélectionné est vide, et lorsque la devise de la boutique n'est pas sélectionnée dans Currencies. Dans les deux cas, le moyen de paiement est masqué au paiement. Dans la liste des moyens de paiement, Autopay est signalé comme nécessitant une configuration tant que l'environnement sélectionné n'a pas d'identifiants.
Général
Enable/Disable: Enable Autopay payment gateway active ou désactive le moyen de paiement. Par défaut : désactivé.
Title: le nom du moyen de paiement que voit le client au paiement. Par défaut : Autopay.
Description: le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.
Service Autopay
Le Service ID et la Shared key sont affichés dans le portail marchand Autopay (portal.autopay.eu ou testportal.autopay.eu).
Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. Par défaut : activé. Désactivez-le pour accepter de vrais paiements sur pay.autopay.eu avec les identifiants de production.
Service ID (production): l'identifiant numérique du service, depuis portal.autopay.eu.
Shared key (production): la clé de hachage du service de production. Gardez-la secrète.
Service ID (test): l'identifiant numérique du service, depuis testportal.autopay.eu.
Shared key (test): la clé de hachage du service de test.
Currencies: les devises acceptées par votre service Autopay : PLN, EUR, GBP, USD, CZK. Autopay ouvre généralement un service distinct par devise. Le moyen de paiement n'est proposé que si la devise de la commande est sélectionnée ici. Par défaut : PLN.
Notifications de paiement (ITN) et adresse de retour
Saisissez ces adresses dans le portail Autopay pour votre service, en production comme en test. Les adresses exactes sont affichées dans cette section des réglages.
Sans l'URL ITN, les commandes ne sont jamais marquées payées. Chaque ITN est vérifié avec le hachage SHA-256 calculé avec la Shared key du service correspondant. Les notifications sans hachage valide ou pour un Service ID inconnu sont rejetées. Une notification n'est appliquée à une commande que si le paiement de cette commande a été lancé avec le même service Autopay. Les notifications des paiements lancés avant que vous ne changiez Test mode sont toujours vérifiées avec la bonne clé.
L'extension traite ces statuts de paiement dans l'ITN :
Avancé
Logging: Log payment events écrit dans WooCommerce > Status > Logs, source wcp_autopay_payment. Les clés et les données clients ne sont jamais journalisées. Par défaut : désactivé.
Fonctionnement au paiement
Le client choisit le moyen de paiement (par défaut Autopay) et passe sa commande. La page suivante affiche Thank you for your order. You are being redirected to Autopay to complete the payment. et envoie le client vers la page de paiement Autopay. Si le client revient avec le bouton Précédent du navigateur, la page affiche le bouton Pay with Autopay au lieu de le rediriger à nouveau.
L'extension transmet le total de la commande dans la devise de la commande, le numéro de commande comme description (Order suivi du numéro) et l'e-mail de facturation du client. Sur la page Autopay, le client choisit le moyen de paiement et paie.
Après le paiement, le client revient sur la page de confirmation de commande. L'adresse de retour est signée, mais elle ne modifie jamais le statut de la commande. La commande n'est marquée payée qu'après confirmation d'Autopay par une ITN signée, et lorsque le montant et la devise correspondent à la commande.
Si le paiement échoue, la commande passe au statut « Échec » et le client peut payer à nouveau depuis la commande, avec le lien Pay. Si le paiement ne peut pas être lancé, le client voit un court message, par exemple Autopay payments are not configured. Please choose another payment method or contact the store. ou indiquant qu'Autopay ne peut pas accepter de paiement dans cette devise.
Le moyen de paiement fonctionne avec le paiement classique, avec le bloc Paiement et avec la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).
L'extension ne gère ni remboursements depuis WooCommerce, ni abonnements ou paiements récurrents, ni cartes enregistrées (1-Click), ni code BLIK ou formulaire de carte sur la page de paiement, ni choix de banque ou de canal de paiement sur la page de paiement. Elle utilise un seul Service ID par environnement.
Commandes
Statuts de commande
Pending payment: le client a été redirigé vers Autopay et Autopay n'a pas encore confirmé le paiement.
Processing or Completed: Autopay a confirmé le paiement. WooCommerce passe la commande à « En cours », ou à « Terminée » pour les commandes ne contenant que des produits virtuels téléchargeables. La note de commande indique le montant, la transaction Autopay et la date du paiement. L'identifiant de transaction est l'identifiant de transaction Autopay (RemoteID).
On hold: Autopay a signalé un montant ou une devise différent du total de la commande. La commande n'a pas été marquée payée. Vérifiez la transaction dans le portail Autopay, puis finalisez-la ou remboursez-la manuellement.
Failed: le paiement a échoué. Le client peut payer à nouveau depuis la commande.
Une commande payée n'est jamais modifiée par une notification d'échec ultérieure. Si Autopay signale un autre paiement réussi pour une commande payée, une note avertit que le client a peut-être payé deux fois. Une notification concernant un paiement lancé avec un autre service Autopay n'est pas appliquée, et une note l'explique.
Remboursements
Les remboursements depuis WooCommerce ne sont pas pris en charge. Remboursez le paiement dans le portail Autopay, puis enregistrez-le dans WooCommerce avec un remboursement manuel.
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 > Autopay. 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-le dans votre compte vibefox.net.
Sans clé active, Autopay n'est pas affiché 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 connectés de la boutique 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.
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
Autopay n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que l'environnement sélectionné dispose d'un Service ID et d'une Shared key, et que la devise de la boutique est sélectionnée dans Currencies. La page des réglages affiche un avertissement lorsqu'un de ces éléments manque.
Le paiement a été effectué, mais la commande reste « En attente de paiement » : Autopay n'a pas envoyé l'ITN, ou la boutique l'a rejetée. Vérifiez que l'URL ITN affichée dans les réglages est configurée pour le service dans le portail Autopay (production ou test), que la fonction de hachage est SHA-256 et que la Shared key de l'extension correspond au service. Vérifiez que la boutique est joignable depuis Internet. Activez Logging et consultez WooCommerce > Status > Logs, source wcp_autopay_payment.
Le journal affiche « ITN rejected: invalid hash » : la Shared key ne correspond pas au service, ou la fonction de hachage du service n'est pas SHA-256.
Le journal indique que le Service ID n'est pas configuré : la notification provient d'un service dont le Service ID n'est pas saisi dans l'extension.
La commande a été mise en attente avec une note d'écart : Autopay a signalé un montant ou une devise différent du total de la commande. Vérifiez la transaction dans le portail Autopay, puis finalisez ou remboursez la commande manuellement.
Une note indique que la notification n'a PAS été appliquée : le paiement de cette commande n'a pas été lancé avec ce service Autopay, par exemple une notification de test pour une commande réelle. Vérifiez la transaction dans le portail Autopay.
Après le paiement, le client arrive sur la page d'accueil : l'adresse de retour n'a pas pu être vérifiée, par exemple parce que le Service ID n'est pas saisi dans l'extension. Le statut de la commande n'est pas affecté ; il suit l'ITN.
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.
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, ainsi que les réglages de la passerelle, sont supprimés. L'extension ne propose pas d'option pour conserver les réglages. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
Autopay est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à Autopay ni approuvée par Autopay.