VibeFox ifthenpay for WooCommerce — Aide

Prérequis

WordPress : 6.0 ou ultérieur.

WooCommerce : 7.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur.

Devise : euro (EUR) uniquement. La méthode de paiement est masquée lorsque la devise de la boutique ou de la commande n'est pas EUR. ifthenpay accepte des totaux 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 backoffice 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 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_ifthenpay_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate. L'extension génère sa clé anti-phishing.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > ifthenpay > 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. Choisissez le Payment Method et saisissez sa clé ifthenpay. Enregistrez pour que la Callback URL corresponde à la méthode choisie.

6. 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 backoffice ou via le support ifthenpay).

7. Activez Enable/Disable.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > ifthenpay. Sans la clé de la méthode sélectionnée, la méthode de paiement n'est pas affichée au paiement, et la liste des méthodes de paiement la signale comme nécessitant une action. Lorsque vous enregistrez une passerelle 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.

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

Title: le titre de la méthode de paiement affiché au paiement. Par défaut : ifthenpay.

Description: la description de la méthode de paiement affichée au 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 paiement. Seule la clé de cette méthode est requise.

Clés ifthenpay

Les clés (format ABC-123456) sont affichées dans le backoffice 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 vérifie aussi la signature du retour du client depuis la page de carte.

Callback (notifications de paiement)

Le callback indique à votre boutique qu'un paiement a été effectué. Demandez à ifthenpay d'activer le callback pour chaque clé utilisée, avec la clé anti-phishing et l'URL de callback indiquées ci-dessous. Les commandes Multibanco et MB WAY ne sont confirmées que 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 l'extension, 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 paramètres ifthenpay, affichée pour être copiée. Elle commence par https://your-site/wc-api/ifthenpay_payment_callback/ puis continue avec les paramètres de la méthode. Copiez l'URL entière exactement comme les réglages l'affichent.

La clé anti-phishing de chaque callback est comparée à la vôtre. Une clé absente ou incorrecte reçoit la réponse 403, et la commande n'est pas modifiée. Le callback doit aussi correspondre à une commande de cette passerelle : pour Multibanco, par entité et référence ; pour MB WAY, par la commande et l'une de ses demandes MB WAY ; pour la carte, par la commande et sa demande de 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é.

Avancé

Test Mode: Enable test/sandbox mode. La carte bancaire et Multibanco utilisent les points d'accès 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 d'ifthenpay. Le paiement affiche un badge TEST MODE. Par défaut : désactivé.

Order Status After Payment: le statut de commande défini après un paiement confirmé, avec un seul changement de statut et un seul e-mail au client. Les commandes ne contenant que des produits virtuels téléchargeables sont toujours terminées par WooCommerce.

Debug Log: Enable logging. Les requêtes API et les callbacks sont écrits dans WooCommerce > Status > Logs, source wcp_ifthenpay_gateway. Les erreurs sont toujours journalisées. Les clés, la clé anti-phishing et les numéros de téléphone ne sont jamais journalisés. Par défaut : désactivé.

Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept). Par défaut : désactivé.

Paiement

Multibanco. Au paiement, le client voit You will receive a Multibanco reference to complete the payment. À la validation de la commande, l'extension crée une référence Multibanco dynamique pour le total. La commande passe en « En attente », le stock est réduit et le panier est vidé. La page de confirmation et les e-mails de commande envoyés pendant que la commande est en attente affichent 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. Si le client repasse commande pour le même montant, la même référence est réutilisée. La commande est confirmé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 facturation est renseigné. L'extension envoie une demande de paiement sur le téléphone, la commande passe en « En attente », le stock est réduit et le panier est vidé. La page de confirmation indique A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Toutes les demandes de la commande sont conservées : une demande antérieure approuvée dans l'application reste donc acceptée. La commande est confirmée par le callback.

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. La commande reste « En attente de paiement » jusqu'au paiement, et le stock n'est pas réduit avant. 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é de la commande, un secret de cette tentative et la demande de carte de la commande ; la commande est alors marquée payée. Si le retour ne peut pas être vérifié, la commande ne change pas, et la page de confirmation affiche Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. Un paiement par carte échoué passe la commande en « Échec », et un paiement annulé la laisse en « En attente de paiement ». Dans les deux cas, le client accède à la page Pay for order 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.

La commande n'est marquée payée qu'après confirmation du paiement 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 voit un court 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 méthode de paiement fonctionne sur le paiement classique, sur les blocs Panier et Paiement (avec le champ téléphone MB WAY) et sur la page Pay for order. Elle est compatible avec le stockage des commandes haute performance de WooCommerce (HPOS).

L'extension ne propose qu'une méthode ifthenpay à la fois. Elle ne gère pas 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

On hold (waiting for payment): une référence Multibanco a été émise ou une demande MB WAY a été envoyée. Les références impayées ne sont pas annulées automatiquement ; annulez vous-même ces commandes si nécessaire.

Pending payment: un paiement par carte a été lancé et n'est pas encore confirmé, ou il a été annulé.

Processing or Completed: le paiement a été confirmé. Le statut suit Order Status After Payment. La note de commande affiche l'entité et la référence Multibanco, la transaction MB WAY ou l'identifiant de la demande de carte.

On hold after payment: le montant reçu était différent du total de la commande, ou le paiement est arrivé après l'annulation de la commande. La note de commande l'explique. Vérifiez le paiement dans le backoffice ifthenpay, puis terminez ou remboursez la commande manuellement.

Failed: le client est revenu de la page de carte avec une erreur.

Une seconde notification de paiement pour une commande déjà payée ajoute seulement une note, pour vérifier un éventuel paiement en double dans le backoffice ifthenpay. Les commandes remboursées, et les commandes annulées après paiement, ne sont jamais rouvertes.

Remboursements

Les remboursements depuis WooCommerce ne sont pas pris en charge. Remboursez le paiement dans le backoffice ifthenpay et enregistrez-le manuellement dans WooCommerce. Un callback de remboursement (DEVOLVIDO) ajoute seulement une note de commande. Les autres statuts remontés par ifthenpay ajoutent eux aussi seulement une note.

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 > ifthenpay. 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, ifthenpay 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 la méthode de paiement, marquée (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 Plugins 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 le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

ifthenpay n'apparaît pas au 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 est EUR et que le total est compris entre 0,01 et 99 999,99 EUR. Sur la page Pay for order, c'est la devise de la commande qui compte.

Le client a payé, mais la commande reste On hold ou Pending payment : 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. Le site doit être accessible depuis Internet, pas en localhost ni derrière une connexion. Recherchez les lignes Callback rejected dans WooCommerce > Status > Logs, source wcp_ifthenpay_gateway.

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 la page des réglages ; ifthenpay réessaiera le callback.

Le callback répond Order not found : la référence ou la demande n'appartient à aucune commande de cette passerelle, par exemple parce que la méthode de paiement a été changée après la commande.

Pourquoi une commande payée a-t-elle été mise en On hold ? 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 la note de commande, vérifiez le paiement dans le backoffice ifthenpay et 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 n'a pas de sandbox pour MB WAY ; utilisez une clé de test fournie par ifthenpay.

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

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, la clé anti-phishing et les journaux ne sont supprimés que si Delete Data on Uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes et leurs données ifthenpay (références, identifiants de demande) sont toujours conservées. Les commandes existantes gardent leurs notes de paiement et identifiants de transaction.

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