VibeFox Autopay for PrestaShop — Aide
Prérequis
PrestaShop : 8.0 à 9.x.
PHP : 8.0 ou ultérieur. Le module refuse de s'installer sur les versions antérieures de PHP.
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 du panier 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 accessible depuis Internet, sans authentification de base ni pare-feu bloquant les requêtes POST. Le mode maintenance et la restriction par pays de votre boutique ne bloquent pas les notifications.
Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un domaine.
Installation
1. Dans le back-office, allez dans Modules > Module Manager et cliquez sur Upload a module. Choisissez le fichier ZIP du module.
2. Une fois le téléversement terminé, cliquez sur Configure, ou retrouvez plus tard VibeFox Autopay Payment dans la liste des modules et cliquez sur Configure.
3. Saisissez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page Configure, puis cliquez sur Activate (voir Clé de licence).
4. Saisissez le Service ID et la Shared key (test et production) et choisissez les devises de votre service.
5. Dans le portail Autopay, définissez l'URL ITN, l'URL de retour et la fonction de hachage SHA-256 pour votre service (voir Configuration).
6. Activez Enable/Disable et cliquez sur Save. Passez une commande test en mode test, puis désactivez Test mode pour les paiements réels.
À l'installation, le module crée le statut de commande Autopay payment on hold. PrestaShop active le nouveau module de paiement pour toutes les devises, tous les pays et tous les groupes de clients. Vous pouvez les limiter dans Payment > Preferences.
Configuration
Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox Autopay Payment > Configure. Chaque section a son propre bouton Save, qui enregistre toute la page. Au-dessus des champs, la page vous avertit si le Service ID ou la Shared key de l'environnement sélectionné est vide, et si la devise par défaut de la boutique n'est pas sélectionnée dans Currencies. Dans les deux cas, le moyen de paiement est masqué sur la page de paiement (pour la devise non sélectionnée).
Autopay
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 voient les clients sur la page de paiement. C'est aussi le nom du moyen de paiement enregistré dans la commande. Par défaut : Autopay. Obligatoire.
Description : le texte affiché sous le moyen de paiement sur la page de 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, liés dans cette section).
Test mode : utilise l'environnement de test Autopay (testpay.autopay.eu) et les identifiants de test ci-dessous. Par défaut : activé. Désactivez-le pour accepter des paiements réels sur pay.autopay.eu avec les identifiants de production.
Service ID (production) : l'identifiant numérique du service sur 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 sur testportal.autopay.eu.
Shared key (test) : la clé de hachage du service de test.
À l'enregistrement, un Service ID contenant d'autres caractères que des lettres, des chiffres, des tirets ou des tirets bas est refusé avec une erreur, et rien n'est enregistré. Les Shared keys enregistrées ne sont jamais réaffichées. Le champ reste vide et affiche Saved — leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier.
Clear saved keys : cochez une clé et cliquez sur Save pour la supprimer. Un champ vide conserve la valeur enregistrée.
Currencies : les devises qu'accepte votre service Autopay : PLN, EUR, GBP, USD, CZK. Autopay ouvre en général un service distinct par devise. Le moyen de paiement n'est proposé que si la devise du panier 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 le champ Addresses de cette section. Avec des URL conviviales, elles ressemblent à ceci, éventuellement avec un code de langue comme /en/ :
Copiez les adresses exactement comme les réglages les affichent. Sans l'URL ITN, aucune commande n'est créée, car PrestaShop ne crée la commande que lorsque Autopay confirme le paiement. Chaque ITN est vérifiée avec le hachage SHA-256 calculé avec la Shared key du service indiqué dans la notification. Les notifications sans hachage valide ou pour un Service ID inconnu sont rejetées. Une notification n'est appliquée à un panier que si son paiement a été lancé avec le même service Autopay : une notification de test ne confirme donc jamais un paiement de production. Les notifications concernant des paiements lancés avant que vous ne basculiez Test mode sont toujours vérifiées avec la bonne clé, tant que les deux jeux d'identifiants restent enregistrés.
Le module gère ces statuts de paiement dans l'ITN :
Avancé
Logging : écrit les événements de paiement dans logs/wc_ap_debug.log.php dans le dossier du module. Le fichier ne peut pas être ouvert depuis le web. Les clés et les données clients ne sont jamais journalisées. Par défaut : désactivé. Tant qu'il est désactivé, rien n'est écrit, erreurs comprises.
Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.
Paiement
À l'étape de paiement, le client choisit le moyen de paiement (par défaut Autopay) avec sa description et confirme. La page suivante affiche Thank you. You are being redirected to Autopay to complete the payment. Your order is created as soon as Autopay confirms it. 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. Aucune commande n'existe encore à ce stade.
Le module transmet le total du panier dans la devise du panier, le numéro du panier comme référence de commande, la description (Cart et le numéro) et l'adresse e-mail du client. Sur la page Autopay, le client choisit le moyen de paiement et paie.
La commande n'est marquée payée qu'après qu'Autopay l'a confirmée par une ITN signée et que le montant et la devise correspondent au panier. La commande est alors créée et le client reçoit les e-mails de commande standard de PrestaShop. Après le paiement, le client revient dans votre boutique. L'adresse de retour est signée, mais elle ne crée ni ne modifie jamais une commande. Si la commande existe déjà, le client voit la page de confirmation de commande standard. Si l'ITN n'est pas encore arrivée, une page Payment confirmation affiche Thank you. Your payment is being confirmed by Autopay — your order will be created as soon as Autopay confirms it, and you will receive an e-mail. avec les boutons Check again et Back to checkout.
Si Autopay a signalé un paiement échoué, le client revient à la page de paiement avec The payment was not completed. You can try again or choose another payment method. Le panier est conservé. Si le paiement ne peut pas être lancé, le client reste sur la page de paiement avec 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 les paiements dans cette devise.
Le module ne gère pas les remboursements depuis PrestaShop, ni les abonnements ou paiements récurrents, ni les cartes enregistrées, ni de code BLIK ou de formulaire de carte sur la page de paiement, ni le choix de la banque ou du canal de paiement sur cette même page, et il utilise un seul Service ID par environnement.
Commandes
Statuts de commande
No order yet : le client a été envoyé vers Autopay et n'a pas payé, le paiement a échoué, ou Autopay n'a pas encore confirmé le paiement. Seul le panier existe.
Payment accepted : Autopay a confirmé le paiement, et le montant et la devise correspondent. Le paiement est enregistré avec l'identifiant de transaction Autopay (remoteID) comme ID de transaction, et une note indique le montant, la transaction Autopay et la date du paiement.
Autopay payment on hold : Autopay a signalé un montant ou une devise différent du total du panier (par exemple, le panier a été modifié après le lancement du paiement). La commande n'est pas marquée payée. Vérifiez la transaction dans le portail Autopay, puis finalisez-la ou remboursez-la manuellement. Une notification ultérieure correcte pour cette commande la marque payée. Le même statut est utilisé lorsqu'un paiement arrive pour une commande annulée : le paiement est enregistré et une note vous invite à vérifier le stock et à traiter la commande, ou à rembourser le paiement.
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. Les notes ne sont visibles que par l'équipe, dans le bloc Autopay payment de la page de commande.
Bloc Autopay payment
La page de commande affiche un bloc Autopay payment avec l'OrderID Autopay, le Service ID et l'environnement, le montant et la devise, le statut du paiement, l'identifiant de transaction Autopay, un badge Test mode pour les paiements de test et les Autopay notes de la commande. Le bloc est en lecture seule.
Remboursements
Les remboursements via Autopay ne sont pas pris en charge. Remboursez le paiement dans le portail Autopay, puis enregistrez-le dans PrestaShop avec les outils standard de commande.
Clé de licence
Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Autopay Payment est le premier bloc de Modules > Module Manager > VibeFox Autopay Payment > Configure, au-dessus des réglages. Saisissez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active, et votre domaine) ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: presta-payment-autopay et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les employés disposant de l'autorisation Configure pour le module peuvent modifier la clé. Les textes du bloc suivent la langue du back-office (l'anglais et le russe sont inclus).
Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, le module continue de fonctionner avec le dernier statut connu.
Une clé fonctionne sur un domaine : le domaine de la boutique principale, y compris dans une configuration multiboutique. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.
Sans clé de licence active, Autopay n'est pas affiché aux clients sur la page de paiement. Si un paiement est lancé malgré tout, le client voit This payment method is not available. Please choose another one. La boutique ne sait pas que vous êtes connecté au back-office : le mode de paiement est donc masqué pour vous aussi. Vous pouvez configurer le module avant d'acheter une clé, mais pas le tester sur la page de paiement. Un rappel apparaît dans Modules > Module Manager, sous l'onglet Alerts. Les commandes existantes ne sont pas affectées : les paiements déjà lancés sont toujours confirmés.
Lorsqu'une licence expire, le module continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié automatiquement pendant votre travail dans le back-office : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation ou la réinitialisation du module supprime toujours la clé de licence et le statut de licence.
Dépannage
Autopay n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que l'environnement sélectionné a un Service ID et une Shared key, et que la devise du panier est sélectionnée dans Currencies. La page de configuration affiche un avertissement si l'un de ces éléments manque. Dans Payment > Preferences, vérifiez que le module est autorisé pour la devise du panier, le pays du client et le groupe du client.
Le paiement a été effectué, mais aucune commande n'a été créée : Autopay n'a pas livré l'ITN, ou la boutique l'a rejetée. Vérifiez que l'URL ITN affichée dans les réglages est bien 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 du module correspond au service. Vérifiez que la boutique est accessible depuis Internet. Activez Logging et consultez le champ Log sur la page du module.
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 le module, ou dont la Shared key est vide.
Le journal affiche could not lock the cart, Autopay will retry : le panier était en cours de traitement par une autre notification au même moment. La boutique répond afin qu'Autopay renvoie la notification. Il en va de même lorsque la commande n'a pas pu être créée, par exemple parce que le module est désactivé.
La commande est Autopay payment on hold avec une note d'écart : Autopay a signalé un montant ou une devise différent du total du panier. 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 le module. La commande n'est pas affectée ; elle suit l'ITN.
Le client voit This payment method is not available. : le moyen de paiement n'est pas proposé pour ce panier (désactivé, identifiants manquants, devise non sélectionnée ou non autorisé dans Payment > Preferences).
Désinstallation
Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox Autopay Payment et choisissez Uninstall. La clé de licence et le statut de licence de ce module sont toujours supprimés. Les réglages du module, y compris les clés, et le journal sont supprimés. Le module n'offre aucune option pour conserver les réglages. Les données de paiement Autopay et le statut de commande Autopay payment on hold sont toujours conservés. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
Autopay est une marque appartenant à son propriétaire respectif. Ce module n'est ni affilié à Autopay ni approuvé par Autopay.