VibeFox MultiSafepay for WooCommerce — Aide
Prérequis
WordPress : 6.0 ou ultérieur.
WooCommerce : 7.0 ou ultérieur, installé et activé. Le plugin refuse de s'activer sans lui.
PHP : 8.0 ou ultérieur.
Devise : la devise de la boutique ou de la commande doit être une devise acceptée par MultiSafepay, par exemple EUR, USD, GBP, PLN, CHF, SEK, DKK ou NOK. Pour les autres devises, le moyen de paiement est masqué lors du paiement.
Compte MultiSafepay : vous avez besoin de la clé API de votre site dans MultiSafepay Control. Les comptes test et production ont des clés différentes. Rien d'autre n'est à configurer dans MultiSafepay : l'adresse de notification est transmise avec chaque paiement.
Site public : MultiSafepay doit pouvoir atteindre votre site pour envoyer les notifications. Sinon, les commandes sont tout de même mises à jour lorsque le client revient depuis MultiSafepay.
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 du plugin et cliquez sur Install Now. Vous pouvez aussi transférer le dossier wcp_multisafepay_gateway dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > MultiSafepay > Manage, ou cliquez sur Settings sous le nom du plugin 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. Collez la clé API de test et/ou de production issue de MultiSafepay Control (voir Configuration).
6. Activez Enable/Disable et enregistrez. Testez un paiement avec Test mode activé, puis décochez-le pour accepter de vrais paiements.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > MultiSafepay. Le titre de la page affiche un badge Test mode tant que le mode test est activé. Au-dessus des champs, la page vous avertit lorsque le mode actuel n'a pas de clé API (le moyen de paiement n'est alors pas affiché lors du paiement) ou lorsque MultiSafepay n'accepte pas la devise de la boutique. Dans la liste des moyens de paiement, MultiSafepay est signalé comme nécessitant une configuration tant que le mode actuel n'a pas de clé API.
Paiement
Enable/Disable : Enable MultiSafepay active ou désactive le moyen de paiement. Par défaut : désactivé.
Title : le nom du moyen de paiement que voit le client lors du paiement. Par défaut : MultiSafepay.
Description : le texte affiché sous le moyen de paiement lors du paiement. Par défaut : Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.
Clés API
Retrouvez la clé API dans MultiSafepay Control > Manage settings > Website settings. Le compte de test (testmerchant.multisafepay.com) et le compte de production (merchant.multisafepay.com) ont des clés différentes. Le mode test n'utilise que la clé de test, et le mode production uniquement la clé de production.
Test mode : Use the MultiSafepay test environment (no real payments). Ce réglage modifie à la fois l'adresse de l'API et la clé API. Les paiements déjà effectués conservent l'environnement dans lequel ils ont été faits pour les vérifications de statut et les remboursements. Par défaut : activé.
Test API key : la clé API de votre compte de test MultiSafepay.
Live API key : la clé API de votre compte de production MultiSafepay.
Notifications
Rien à configurer. Cette section affiche l'URL de notification, transmise à MultiSafepay avec chaque paiement. Elle ressemble à https://your-site/?wc-api=mspg_webhook. MultiSafepay doit pouvoir atteindre votre site. Une notification indique seulement au plugin quel paiement a changé : le statut, le montant et la devise sont toujours lus auprès de l'API MultiSafepay avec votre clé API avant qu'une commande ne soit modifiée. Les notifications concernant des paiements qui n'appartiennent à aucune commande de votre boutique sont ignorées.
Commandes
Order status after payment : le statut d'une commande payée. Le statut est appliqué immédiatement, avec un seul changement de statut et un seul e-mail au client.
Avancé
Debug log : Log API calls and notifications enregistre les détails dans WooCommerce > Status > Logs, source wcp_multisafepay_gateway. Les erreurs sont toujours journalisées. Les clés API et les données client ne sont pas journalisées. Par défaut : désactivé.
Delete data on uninstall : Remove settings, logs and MultiSafepay order data when the plugin is deleted. Désactiver le plugin ne supprime jamais rien. Par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut MultiSafepay) et passe sa commande. Le plugin crée un paiement MultiSafepay pour le total de la commande dans la devise de la commande et envoie le client sur la page de paiement MultiSafepay. Là, le client choisit n'importe quel moyen de paiement activé sur votre compte MultiSafepay et paie. Les coordonnées de facturation du client et la langue de la boutique sont transmises à MultiSafepay, et le paiement apparaît sous Order #, le numéro de commande et le nom de votre site. En mode test, le paiement affiche Test mode: no real payment will be made.
Le stock est réservé pendant que le client paie, et le panier est conservé jusqu'à la page de confirmation de commande. Après le paiement, le client revient sur la page de confirmation de commande de votre boutique. La commande n'est marquée comme payée qu'après confirmation de MultiSafepay : par la notification ou par une vérification auprès de l'API MultiSafepay lorsque le client arrive sur cette page.
Si le client annule sur la page de MultiSafepay pendant le paiement, la commande est annulée de la manière standard de WooCommerce, le stock est libéré et les produits restent dans le panier. Si le client payait depuis la page Pay for order, il revient sur cette page, qui explique ce qui s'est passé : The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. ou The payment session has expired. Please try again.
Un client peut payer à nouveau une commande non payée. Avant de créer un nouveau paiement, le plugin vérifie le précédent auprès de MultiSafepay. S'il est déjà payé, la commande est confirmée. S'il est toujours ouvert avec le même montant, la même page de paiement est réutilisée. Si le montant a changé, l'ancien paiement est annulé chez MultiSafepay, de sorte qu'il ne peut plus être payé.
Si MultiSafepay ne peut pas démarrer le paiement, le client voit un court message, par exemple Could not connect to MultiSafepay. Please try again in a moment. ou MultiSafepay cannot accept this order amount or currency. Please choose another payment method., et peut choisir un autre moyen de paiement. L'erreur MultiSafepay est ajoutée aux notes de commande.
Le moyen de paiement fonctionne avec le paiement classique, le bloc Paiement et la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).
Le plugin propose un moyen de paiement unique qui mène à la page MultiSafepay. Il n'y a pas de moyens de paiement WooCommerce distincts pour chaque moyen MultiSafepay, ni de champs de carte intégrés, ni de boutons express Apple Pay ou Google Pay, ni d'abonnements, de paiements récurrents ou de cartes enregistrées, et pas de capture ni d'annulation depuis WooCommerce. Aucune donnée de panier n'est transmise ; MultiSafepay ne propose donc pas, pour ces commandes, les moyens de paiement différé qui en ont besoin (par exemple Klarna, in3 ou Riverty).
Commandes et remboursements
Statuts de commande
Pending payment : vous avez été redirigé vers MultiSafepay et vous n'avez pas encore payé.
Processing ou Completed : MultiSafepay a confirmé le paiement (terminé ou expédié). Le statut suit Order status after payment. La note de commande affiche l'identifiant de paiement MultiSafepay, le moyen de paiement et l'environnement. L'identifiant de transaction est l'identifiant de commande MultiSafepay du paiement.
On hold before payment : le paiement est non réglé (en cours d'examen par MultiSafepay) ou réservé (autorisé). Capturez un paiement réservé dans MultiSafepay Control pour recevoir l'argent. La commande est terminée automatiquement lorsque MultiSafepay la signale comme payée.
On hold after payment : MultiSafepay a confirmé un montant ou une devise différent du total de la commande, un paiement test a été effectué alors que la boutique est en mode production (aucun argent réel n'a été reçu), ou le paiement a été effectué après l'annulation de la commande. La note de commande l'explique. Vérifiez la transaction dans MultiSafepay Control et traitez ou remboursez la commande manuellement.
On hold after a chargeback : MultiSafepay a signalé une rétrofacturation sur une commande payée : l'argent a été repris sur votre compte.
Failed : le dernier paiement d'une commande non payée a été refusé, annulé, expiré ou invalidé (void). Le stock réservé est libéré. Le client peut réessayer.
Une commande payée, remboursée ou annulée n'est jamais rouverte par une notification tardive. Si un second paiement est effectué pour une commande déjà payée, la commande n'est pas modifiée à nouveau. Une note vous invite à rembourser le doublon dans MultiSafepay Control.
Remboursements
Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via MultiSafepay. Les remboursements totaux et partiels sont pris en charge pour les commandes payées via MultiSafepay. Le remboursement est envoyé à l'environnement dans lequel le paiement a été effectué (test ou production), la clé API de cet environnement doit donc être renseignée. Si MultiSafepay n'accepte pas le remboursement, WooCommerce affiche l'erreur de MultiSafepay et aucun remboursement n'est enregistré. Une demande réussie est ajoutée aux notes de commande avec l'identifiant de remboursement MultiSafepay.
Les remboursements effectués dans MultiSafepay Control sont ajoutés aux notes de commande lorsque MultiSafepay les signale. Ils ne sont pas enregistrés automatiquement comme remboursements WooCommerce. Si nécessaire, créez un remboursement manuel dans WooCommerce sans utiliser Refund via MultiSafepay.
Clé de licence
Le plugin fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > MultiSafepay. 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, ainsi que 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 cet emplacement dans votre compte vibefox.net.
Sans clé active, MultiSafepay n'est pas affiché aux clients lors 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 que vous puissiez configurer et tester le plugin 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, et les remboursements fonctionnent.
Lorsqu'une licence expire, le plugin 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
MultiSafepay n'apparaît pas lors du paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le mode actuel dispose d'une clé API (Test API key en mode test, Live API key en mode production) et que la devise de la boutique ou de la commande est acceptée par MultiSafepay. La page de réglages affiche un avertissement lorsque la clé est manquante ou que la devise n'est pas acceptée.
Le paiement a été effectué, mais la commande reste en Pending payment : la notification n'a pas atteint votre boutique. Vérifiez que le site est accessible depuis Internet et que la clé API de l'environnement du paiement est renseignée, car le plugin lit le statut via l'API MultiSafepay. Si l'API est injoignable, la notification répond ERROR et MultiSafepay la renvoie. La commande est aussi mise à jour lorsque le client revient sur la page de confirmation de commande et lorsqu'il tente de payer à nouveau la même commande.
Le client voit une erreur lors de la commande : ouvrez les notes de commande ou activez Debug log et consultez WooCommerce > Status > Logs, source wcp_multisafepay_gateway. This payment method is temporarily unavailable. Please choose another payment method. signale généralement une clé API incorrecte ou absente. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. signifie que MultiSafepay a refusé le montant ou la devise.
La commande est On hold after payment : lisez la note de commande. Le paiement peut être non réglé ou réservé, le montant ou la devise payés peuvent différer de la commande, un paiement test peut être arrivé en mode production, le paiement peut avoir été effectué après l'annulation de la commande, ou il peut y avoir une rétrofacturation. Vérifiez la transaction dans MultiSafepay Control.
Les paiements test ne confirment pas une commande réelle : un paiement test ne règle jamais une commande tant que la boutique est en mode production ; la commande est alors mise en attente. Les anciens paiements test continuent d'être vérifiés et remboursés avec la clé de test après le passage en production.
Le remboursement échoue avec un message concernant l'environnement : le paiement a été effectué dans l'environnement de test ou de production, et la clé API de cet environnement n'est pas renseignée. Saisissez-la 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, le plugin continue de fonctionner avec le dernier statut connu.
Désinstallation
Désactiver le plugin conserve toutes les données. Pour le supprimer, désactivez-le puis supprimez-le sur la page Plugins. La clé de licence et le statut de licence de ce plugin sont toujours supprimés. Les réglages de la passerelle, les données MultiSafepay enregistrées sur les commandes et les journaux ne sont supprimés que si Delete data on uninstall était activé. Sinon, ils sont conservés pour une future réinstallation. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
MultiSafepay est une marque commerciale de son propriétaire respectif. Ce plugin n'est ni affilié à MultiSafepay ni approuvé par MultiSafepay.