VibeFox ifthenpay for PrestaShop — Aide

Prérequis

PrestaShop: 8.0 à 9.x.

PHP: 8.0 ou ultérieur. Le module refuse de s'installer sur les anciennes versions de PHP.

Devise: euro (EUR) uniquement. La méthode de paiement est masquée lorsque la devise du panier n'est pas EUR. ifthenpay accepte des montants de 0,01 à 99 999,99 EUR.

Compte ifthenpay: inscrivez-vous sur ifthenpay.com. Vous avez besoin de la clé de la méthode que vous proposez : Multibanco, MB WAY ou Credit Card (format ABC-123456). Les clés sont affichées dans le back office d'ifthenpay (backoffice.ifthenpay.com) ou envoyées par ifthenpay lorsque la méthode est activée pour votre compte. ifthenpay doit également activer le callback pour votre clé (voir Configuration), et votre boutique doit être accessible depuis Internet.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul 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 ifthenpay Gateway dans la liste des modules et cliquez sur Configure. Le module génère sa clé anti-phishing lors de l'installation.

3. Saisissez votre clé de licence VibeFox dans le champ License key du bloc de licence en haut de la page Configure, puis cliquez sur Activate (voir Clé de licence).

4. Choisissez le Payment Method, saisissez sa clé ifthenpay et cliquez sur Save, afin que la Callback URL corresponde à la méthode choisie.

5. Copiez la Anti-phishing Key et la Callback URL affichées dans les réglages, puis demandez à ifthenpay d'activer le callback pour votre clé (dans le back office ou via le support d'ifthenpay).

6. Activez Enable/Disable et cliquez sur Save.

À l'installation, le module crée deux statuts de commande : Awaiting ifthenpay payment et ifthenpay payment on hold. PrestaShop propose un nouveau module de paiement pour toutes les devises, tous les pays et tous les groupes de clients. Vous pouvez les limiter dans Payment > Preferences ; EUR doit rester autorisé.

Configuration

Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox ifthenpay Gateway > Configure. Chaque section avec un bouton Save enregistre la page entière. Sans la clé de la méthode sélectionnée, la méthode de paiement n'est pas affichée au moment du paiement. Tant que la passerelle est activée sans cette clé, la page affiche ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout.

ifthenpay

Enable/Disable: Enable ifthenpay Payment active ou désactive la méthode de paiement. Par défaut : off.

Title: le titre de la méthode de paiement affiché au moment du paiement. C'est aussi le nom de la méthode de paiement enregistré dans la commande. Par défaut : ifthenpay.

Description: la description de la méthode de paiement affichée au moment du paiement. Par défaut : Pay via Multibanco, MB WAY or Credit Card. Modifiez-la pour correspondre à la méthode que vous proposez.

Payment Method: la méthode proposée au moment du paiement. Seule la clé de cette méthode est obligatoire.

Clés ifthenpay

Les clés (format ABC-123456) sont affichées dans le back office d'ifthenpay ou envoyées par ifthenpay lorsque la méthode de paiement est activée pour votre compte.

Multibanco Key: votre clé ifthenpay Multibanco (MB) pour les références dynamiques.

MB WAY Key: votre clé ifthenpay MB WAY.

Credit Card Key: votre clé ifthenpay Credit Card. Elle sert aussi à vérifier la signature du retour du client depuis la page de carte.

Les clés enregistrées ne sont jamais réaffichées. Le champ reste vide et affiche Saved — leave empty to keep it. Ne saisissez une nouvelle valeur que si vous voulez la modifier.

Clear saved keys: cochez une clé et cliquez sur Save pour la supprimer. Un champ vide conserve la valeur enregistrée.

Callback (notifications de paiement)

Le callback indique à votre boutique qu'un paiement a été effectué. Demandez à ifthenpay d'activer le callback pour chaque clé que vous utilisez, avec la clé anti-phishing et l'URL de callback ci-dessous. Les commandes Multibanco et MB WAY sont confirmées uniquement par le callback ; les paiements par carte sont aussi confirmés par le retour signé depuis la page de carte.

Anti-phishing Key: générée par le module, affichée pour être copiée. ifthenpay la renvoie dans chaque callback ; les callbacks sans elle sont rejetés.

Callback URL: l'URL de callback de la méthode de paiement sélectionnée, avec les espaces réservés d'ifthenpay, affichée pour être copiée. Avec les URL conviviales, elle commence par https://your-shop/module/wcp_ifthenpay_gateway/callback, éventuellement suivie d'un code de langue comme /en/, puis des paramètres de la méthode. Copiez l'URL complète exactement telle qu'elle est affichée dans les réglages.

La clé anti-phishing de chaque callback est comparée à la vôtre. Une clé absente ou incorrecte reçoit une réponse 403, et la commande n'est pas modifiée. Le callback doit aussi correspondre à un paiement de ce module : pour Multibanco, par entité et référence ; pour MB WAY, par le panier et l'une de ses demandes MB WAY ; pour Credit Card, par le panier et l'une de ses demandes par carte. Sans callback fonctionnel, les commandes Multibanco et MB WAY ne sont jamais confirmées, et les paiements par carte ne sont confirmés que par le retour signé. Le callback fonctionne pendant que la boutique est en mode maintenance et n'est pas bloqué par la restriction géographique de votre boutique.

Avancé

Test Mode: Credit Card et Multibanco utilisent les points de terminaison sandbox d'ifthenpay ; aucun argent réel n'est prélevé, et vous utilisez les clés de test fournies par ifthenpay. MB WAY n'a pas de sandbox : testez-le avec une clé de test fournie par ifthenpay. Le paiement affiche un badge TEST MODE. Par défaut : off.

Order Status After Payment: le statut de commande attribué après un paiement confirmé, avec un seul changement de statut.

Debug Log: les requêtes API et les callbacks sont écrits dans logs/ifthenpay_p_debug.log.php dans le dossier du module. Le fichier ne peut pas être ouvert depuis le web. Les erreurs sont toujours journalisées. Les clés, la clé anti-phishing et les numéros de téléphone complets ne sont jamais journalisés. Par défaut : off.

Log: affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Delete Data on Uninstall: lorsqu'elle est activée, la désinstallation du module supprime ses réglages, la clé anti-phishing et le journal. Les commandes et les enregistrements de paiement ifthenpay sont toujours conservés. Par défaut : off.

Paiement

Multibanco. Au moment du paiement, le client voit You will receive a Multibanco reference to complete the payment. Lorsque le client confirme, le module crée une référence Multibanco dynamique pour le total du panier, et la commande est créée dans Awaiting ifthenpay payment. La page de confirmation de commande affiche Multibanco Payment Details : entité, référence et montant, avec Please use these details to pay at any Multibanco ATM or through your online banking. Les mêmes informations sont ajoutées à l'e-mail de confirmation de commande. La commande est payée lorsque ifthenpay envoie le callback de paiement.

MB WAY. Le client saisit le MB WAY phone number (912 345 678, +351 912 345 678 ou 351#912345678 pour les autres pays) ; le téléphone de l'adresse de facturation est pré-rempli. Le module envoie une demande de paiement sur ce téléphone, et la commande est créée dans Awaiting ifthenpay payment. La page de confirmation de commande indique A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. La commande est payée lorsque ifthenpay envoie le callback. Seul un numéro de téléphone masqué est enregistré.

Carte bancaire. Le client voit You will be redirected to a secure page to enter your card details. et est redirigé vers la page de carte d'ifthenpay. Aucune commande n'existe encore, et le panier est conservé. Après un paiement réussi, le client revient dans votre boutique. Le retour n'est accepté qu'avec une signature ifthenpay valide, la clé sécurisée du panier, un secret de cette tentative et la demande de carte du panier ; la commande est alors créée comme payée et le client voit la page standard de confirmation de commande. Si le retour ne peut pas être vérifié, rien ne change, et une page Payment confirmation affiche Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. avec un bouton Check again ; le callback crée la commande dès son arrivée. Si le paiement par carte échoue ou est annulé, le client revient au paiement avec The card payment was not completed. You can try again or choose another payment method. ou The card payment was cancelled. You can try again or choose another payment method. Chaque tentative de paiement par carte du panier est conservée ; un paiement effectué dans un onglet plus ancien reste donc accepté.

La commande n'est marquée payée qu'après confirmation par ifthenpay, et le montant est vérifié au centime près par rapport au total de la commande. Si le paiement ne peut pas être lancé, le client reste au moment du paiement avec un bref message, par exemple The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. ou The payment service is temporarily unavailable. Please try again in a few minutes. La raison technique est écrite dans le journal.

Le module ne propose qu'une méthode ifthenpay à la fois. Il ne prend pas en charge Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX ou Pay-by-Link, ni les abonnements ou cartes enregistrées, ni l'expiration ou l'annulation automatique des références Multibanco impayées, ni l'interrogation du statut de paiement.

Commandes

Statuts de commande

No order yet: un paiement par carte a été lancé et n'est pas encore confirmé, ou il a échoué ou a été annulé. Seul le panier existe.

Awaiting ifthenpay payment: une référence Multibanco a été émise ou une demande MB WAY a été envoyée. PrestaShop réduit le stock lorsque la commande est créée. Les références impayées et les demandes MB WAY refusées n'annulent pas la commande automatiquement ; annulez vous-même ces commandes si nécessaire.

Payment accepted or Delivered: le paiement est confirmé. Le statut suit Order Status After Payment. Le paiement est enregistré avec la référence Multibanco, l'identifiant de la demande MB WAY ou l'identifiant de la demande de carte comme identifiant de transaction, et une note indique comment il a été confirmé.

ifthenpay payment on hold: le montant reçu était différent du total de la commande (par exemple, le panier a été modifié après le lancement d'un paiement par carte), ou le paiement est arrivé après l'annulation de la commande. La note l'explique, et le client n'est pas invité à payer à nouveau. Vérifiez le paiement dans le back office d'ifthenpay, puis terminez ou remboursez la commande manuellement. Un paiement ultérieur correct pour une telle commande ne la modifie pas.

Un deuxième paiement pour une commande déjà payée ajoute seulement une note, afin de vérifier s'il s'agit d'un doublon dans le back office d'ifthenpay. Les commandes remboursées et les commandes annulées après paiement ne sont jamais rouvertes.

Bloc de paiement ifthenpay

La page de commande affiche un bloc ifthenpay payment avec les tentatives de paiement de la commande (date, méthode, un badge Sandbox pour les paiements de test, montant, entité et référence Multibanco ou numéro MB WAY masqué, identifiant de demande ifthenpay et statut), un avertissement Manual review tant que la commande est en ifthenpay payment on hold, et les ifthenpay notes de la commande.

Remboursements

Les remboursements depuis PrestaShop ne sont pas pris en charge. Remboursez le paiement dans le back office d'ifthenpay et enregistrez-le manuellement dans PrestaShop. Un callback de remboursement (DEVOLVIDO) ajoute seulement une note. Les autres statuts signalés par ifthenpay ajoutent aussi uniquement une note.

Clé de licence

Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox ifthenpay Gateway est le premier bloc de Modules > Module Manager > VibeFox ifthenpay Gateway > 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) et 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. Plus bas se trouvent la ligne Product: presta-payment-ifthenpay 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 seul domaine : celui 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 l'emplacement dans votre compte vibefox.net.

Sans clé active, ifthenpay n'est pas proposé 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. La boutique PrestaShop ne sait pas que vous êtes connecté au back office : le moyen de paiement est donc masqué pour vous aussi. Vous pouvez configurer le module avant d'acheter une clé, mais pas le tester au moment du 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

ifthenpay n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que la clé du Payment Method sélectionné est renseignée, que la devise du panier est EUR et que le total est compris entre 0,01 et 99 999,99 EUR. Dans Payment > Preferences, vérifiez que le module est autorisé pour EUR, pour le pays du client et pour son groupe.

Le client a payé, mais la commande reste en Awaiting ifthenpay payment ou aucune commande n'a été créée : le callback n'atteint pas votre boutique. Vérifiez qu'ifthenpay a activé l'URL de callback et la clé anti-phishing pour la clé que vous utilisez, et que l'URL est celle de la méthode sélectionnée. La boutique doit être accessible depuis Internet, pas sur localhost ni derrière une connexion. Recherchez les lignes Callback rejected dans le champ Log de la page du module.

Le callback répond 403 Forbidden : la clé anti-phishing du callback est absente ou diffère de celle des réglages. Renvoyez à ifthenpay la clé affichée dans les réglages.

Le callback répond 503 Not configured : la clé anti-phishing n'a pas encore été générée. Ouvrez une fois les réglages du module ; ifthenpay réessaiera le callback.

Le callback répond 503 Busy : le même panier était en cours de traitement par une autre requête à ce moment-là. ifthenpay réessaiera le callback.

Le callback répond Order not found : la référence ou la demande n'appartient pas à un paiement de ce module, ou le panier a été commandé avec une autre méthode de paiement.

Pourquoi une commande payée a-t-elle été mise en attente ? Le montant reçu était différent du total de la commande, ou le paiement est arrivé après l'annulation de la commande. Lisez les notes du bloc ifthenpay payment, vérifiez le paiement dans le back office d'ifthenpay, puis terminez ou remboursez la commande manuellement.

La demande MB WAY n'a pas pu être envoyée : le numéro de téléphone n'est pas lié à MB WAY ou son format est incorrect. Utilisez 912 345 678, ou 351#912345678 pour les numéros d'autres pays.

Mode test et MB WAY : ifthenpay ne dispose pas de sandbox MB WAY ; utilisez une clé de test fournie par ifthenpay.

Désinstallation

Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox ifthenpay Gateway et choisissez Uninstall. La clé de licence et le statut de la licence de ce module sont toujours supprimés. Si Delete Data on Uninstall est activé, les réglages du module, la clé anti-phishing et le journal sont supprimés ; après une réinstallation, une nouvelle clé anti-phishing est générée et doit être à nouveau envoyée à ifthenpay. Si l'option est désactivée, tous les réglages sont conservés pour une réinstallation ultérieure. Les enregistrements de paiement ifthenpay (références et identifiants de demande) ainsi que les statuts de commande Awaiting ifthenpay payment et ifthenpay payment on hold sont toujours conservés, afin que les callbacks des références émises auparavant retrouvent leurs commandes après une réinstallation. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

ifthenpay est une marque de son titulaire respectif. Ce module n'est ni affilié à ifthenpay ni approuvé par ifthenpay.