VibeFox Mollie for WooCommerce — Aide
Prérequis
WordPress : 6.0 ou ultérieur.
WooCommerce : 7.0 ou ultérieur, installé et activé. Sans WooCommerce, l'extension refuse de s'activer.
PHP : 8.0 ou ultérieur.
Devise de la boutique : l'une des devises prises en charge par Mollie : AED, AUD, BGN, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TWD, USD, ZAR. Pour les autres devises, le moyen de paiement est masqué sur le paiement. Les moyens de paiement proposés par Mollie dépendent de la devise et de votre compte.
Accès Internet à votre site : Mollie envoie des webhooks à votre boutique, le site doit donc être accessible depuis Internet. Sans webhooks, les commandes sont tout de même mises à jour lorsque le client revient de Mollie.
Compte Mollie : vous avez besoin des clés API de Mollie Dashboard > Developers > API keys. Les clés de test commencent par test_, les clés de production par live_. Les moyens de paiement eux-mêmes s'activent dans votre compte Mollie.
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_mollie_gateway dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > Mollie > Manage, ou cliquez sur Settings sous le nom de l'extension dans la page des extensions.
4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.
5. Saisissez vos clés API de test et de production (voir Configuration). Aucun webhook n'a besoin d'être configuré dans Mollie.
6. Activez Enable/Disable. Laissez Test Mode activé jusqu'à avoir effectué un paiement test, puis décochez-le.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Mollie. Au-dessus des champs, la page vous avertit lorsque Mollie est activé mais que la clé API du mode actuel est vide, et lorsque Mollie ne prend pas en charge la devise de la boutique. Dans les deux cas, le moyen de paiement est masqué sur le paiement. Dans la liste des moyens de paiement, Mollie est signalé comme nécessitant une configuration tant que le mode actuel n'a pas de clé API, et affiche Test mode tant que le mode test est activé.
À l'enregistrement, une clé API qui ne commence pas par test_ ou live_ suivi d'au moins 30 lettres et chiffres n'est pas enregistrée : un message d'erreur s'affiche et la valeur précédente est conservée.
Paiement
Enable/Disable : Enable Mollie Gateway active ou désactive le moyen de paiement. Par défaut : désactivé.
Title : le titre du moyen de paiement affiché au client sur le paiement. Par défaut : Mollie.
Description : la description du moyen de paiement affichée au client sur le paiement. Par défaut : Pay securely via Mollie.
Clés API
Retrouvez vos clés API dans Mollie Dashboard > Developers > API keys. Aucune configuration de webhook n'est nécessaire : l'extension envoie son URL de webhook avec chaque paiement. L'URL est affichée dans cette section et ressemble à https://your-site/?wc-api=molg_mollie_webhook. Elle doit être accessible depuis Internet, sinon les commandes ne sont mises à jour que lorsque le client revient de Mollie.
Test Mode : Enable test mode utilise la clé API de test pour les nouveaux paiements. Aucun paiement réel n'est traité. Sur la page de paiement test de Mollie, vous pouvez choisir le résultat (paid, failed, cancelled, expired). Les clients voient Test mode: no real payment will be made. sur le paiement. Les paiements effectués dans l'autre mode continuent d'utiliser la clé de leur propre mode pour les vérifications de statut et les remboursements. Par défaut : activé.
Test API Key : votre clé API de test Mollie (commence par test_).
Live API Key : votre clé API de production Mollie (commence par live_).
Commandes
Order Status After Payment : le statut de commande à appliquer après un paiement réussi. Le statut est appliqué en une seule étape, sans second changement de statut.
Avancé
Logging : Enable debug logging écrit les appels API et les webhooks dans WooCommerce > Status > Logs, source wcp_mollie_gateway. Les erreurs sont toujours journalisées. Les clés API et les données clients ne sont jamais journalisées. Par défaut : désactivé.
Delete Data on Uninstall : Remove the plugin settings and logs when uninstalling. Si la case est cochée, les réglages de l'extension et ses fichiers journaux sont supprimés à la suppression de l'extension. Les identifiants de paiement Mollie enregistrés sur les commandes sont conservés. Par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut Mollie) et valide la commande. L'extension crée un paiement Mollie pour le total de la commande dans la devise de la commande (JPY et ISK sans décimales), avec la description Order # suivie du numéro de commande, puis envoie le client sur la page de paiement hébergée de Mollie. Il y choisit l'un des moyens de paiement activés dans votre compte Mollie et paie.
Les webhooks Mollie ne comportent pas de signature, seulement l'identifiant du paiement. L'extension ne fait donc jamais confiance à un webhook en tant que tel : elle récupère le paiement auprès de l'API Mollie avec votre propre clé API, vérifie que le paiement appartient à la commande et compare le montant et la devise payés à ceux de la commande. La commande n'est marquée payée qu'après confirmation de Mollie de cette manière. L'extension gère les statuts de paiement Mollie suivants :
Lorsque le client revient, l'extension vérifie le dernier paiement auprès de l'API Mollie de la même façon. Un paiement réussi mène à la page de commande reçue. Si le paiement a été annulé, a échoué, a expiré ou n'est pas terminé, le client est redirigé vers la page Pay for order avec un message, par exemple You cancelled the Mollie payment. You can try again or choose another payment method. ou The Mollie payment has expired. Please try again or choose another payment method.
Lorsque le client paie à nouveau, le paiement Mollie encore ouvert pour le même montant est réutilisé au lieu d'en créer un second payable. Si le total de la commande a changé, l'ancien paiement ouvert est annulé chez Mollie lorsque Mollie le permet. Si l'ancien paiement a entre-temps été réglé, la commande est marquée payée sans nouveau paiement.
Si Mollie ne peut pas démarrer le paiement, le client voit un bref message, par exemple The payment provider could not be reached. Please try again in a moment., This payment method is temporarily unavailable. Please choose another payment method. (clé API incorrecte) ou Mollie cannot accept a payment of this amount or currency. Please choose another payment method. La raison technique est ajoutée aux notes de commande et au journal.
Le moyen de paiement fonctionne sur le paiement classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).
Le client choisit le moyen Mollie sur la page Mollie, et non sur votre paiement. L'extension ne gère ni abonnements ni paiements récurrents, ni cartes enregistrées ou mandats, ni Mollie Components (champs de carte sur votre site), ni boutons express Apple Pay ou PayPal, ni Orders API. Les moyens de paiement qui exigent des lignes de commande (par exemple certaines variantes de Klarna, Billie ou in3) ne sont donc pas proposés par Mollie pour ces paiements. Les paiements autorisés se capturent ou s'annulent dans le Mollie Dashboard, et non depuis WooCommerce.
Commandes et remboursements
Statuts de commande
Pending payment : le client a été envoyé vers Mollie et n'a pas encore payé.
Processing or Completed : le paiement est confirmé. Le statut suit Order Status After Payment. La note de commande indique le paiement Mollie, le moyen et le mode. L'identifiant de transaction est l'identifiant du paiement Mollie (tr_...) qui a réglé la commande.
On hold : un virement attend l'argent, un paiement autorisé attend sa capture, ou Mollie a signalé une rétrofacturation. Le statut En attente est aussi appliqué lorsque le montant ou la devise payés ne correspondent pas à la commande, lorsqu'un paiement test a été réglé alors que la boutique est en mode production (aucun argent n'a été reçu), ou lorsque le paiement arrive après l'annulation de la commande. La note de commande l'explique. Vérifiez le paiement dans le Mollie Dashboard, puis traitez la commande ou remboursez le paiement.
Failed : la dernière tentative de paiement a échoué, expiré ou été annulée. Une commande payée n'est jamais modifiée. Le client peut payer à nouveau.
Si un second paiement de la même commande est réglé, la commande n'est plus modifiée. Une note vous demande de rembourser le paiement en double dans votre Mollie Dashboard.
Remboursements
Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Mollie (le bouton affiche votre Title). Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé pour le paiement qui a réellement réglé la commande, avec la clé API du mode dans lequel il a été effectué ; cette clé doit donc être renseignée. Le bouton n'est disponible que pour les commandes ayant un paiement Mollie réglé. Si Mollie refuse le remboursement, WooCommerce affiche le message d'erreur de Mollie et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant de remboursement Mollie.
Les remboursements et rétrofacturations créés dans le Mollie Dashboard ne sont pas transformés en remboursements WooCommerce. Une rétrofacturation ajoute 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 > Mollie. 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 l'emplacement du domaine. Libérez l'emplacement dans votre compte vibefox.net.
Sans clé active, Mollie n'est pas affiché aux clients sur le 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 l'extension avant d'acheter une clé. Un rappel apparaît sur la page des 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, 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
Mollie n'apparaît pas sur le paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode actuel dispose d'une clé API : Test API Key en mode test, Live API Key en mode production. Vérifiez que la devise de la boutique (ou la devise de la commande sur la page Pay for order) est prise en charge par Mollie. La page des réglages affiche un avertissement pour chacun de ces problèmes.
Le paiement a abouti, mais la commande reste en Pending payment : le webhook ne parvient pas à atteindre votre site. L'URL du webhook affichée dans les réglages doit être accessible depuis Internet (pas de mode maintenance, d'authentification de base ni de pare-feu qui bloque l'accès). La commande est aussi mise à jour lorsque le client revient dans la boutique après avoir payé.
Le webhook répond Unknown payment. : l'identifiant du paiement est inconnu de Mollie pour votre clé API de test ou de production, par exemple un paiement d'un autre compte Mollie.
Le webhook répond Payment ID mismatch. : le paiement n'appartient pas à la commande selon ses données. La commande n'est pas modifiée.
Le webhook répond Failed to fetch payment. : l'API Mollie n'a pas pu être jointe. Mollie réessaiera le webhook plus tard.
Une clé API n'est pas enregistrée : la clé doit commencer par test_ ou live_, suivi d'au moins 30 lettres et chiffres. Copiez-la à nouveau depuis le Mollie Dashboard.
Le paiement n'est pas créé : la note de commande et le journal affichent le code HTTP et le message de Mollie. 401 signifie une clé API incorrecte ; 422 signale un champ de la requête, par exemple un montant ou une devise que Mollie n'accepte pas. Activez Logging et consultez WooCommerce > Status > Logs, source wcp_mollie_gateway.
La commande est On hold : lisez la note de commande. La raison est un écart de montant ou de devise, un paiement test en mode production, un paiement après annulation, un virement, une autorisation sans capture ou une rétrofacturation.
Le remboursement échoue avec un message sur le mode : le paiement a été effectué en mode test ou production, et la clé API de ce mode n'est pas renseignée. Saisissez-la et réessayez.
Autres devises : les développeurs peuvent modifier la liste des devises avec le filtre molg_supported_currencies.
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 sont toujours supprimés. Les réglages de la passerelle et les fichiers 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 existantes conservent leurs notes de paiement, leurs identifiants de paiement Mollie et leurs identifiants de transaction.
Mollie est une marque déposée de son propriétaire respectif. Cette extension n'est ni affiliée à Mollie ni approuvée par Mollie.