VibeFox MakeCommerce for WooCommerce — Aide
Prérequis
WordPress: 6.0 ou ultérieur.
WooCommerce: 7.0 ou ultérieur, installé et actif. Sans WooCommerce, l'extension refuse de s'activer.
PHP: 8.0 ou ultérieur.
Accès Internet à votre site : MakeCommerce envoie des notifications de paiement à votre boutique, le site doit donc être accessible depuis Internet (HTTPS recommandé). Un pare-feu, un mode de maintenance ou une authentification de base peuvent les bloquer.
Compte MakeCommerce : vous avez besoin du Shop ID et de la Secret key disponibles dans le Merchant Portal de MakeCommerce (Settings > API). Les environnements de test et de production disposent de comptes et de clés distincts. Les modes de paiement et devises disponibles sont définis par votre contrat MakeCommerce (les liens bancaires sont en EUR). Les devises à trois décimales, telles que KWD ou BHD, ne sont pas proposées.
Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un domaine.
Installation
1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, sélectionnez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez également téléverser le dossier wcp_makecommerce_payment dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > MakeCommerce > Manage, ou cliquez sur Settings sous le nom de l'extension sur la page Extensions.
4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.
5. Saisissez le Shop ID et la Secret key de l'environnement de test et, pour les paiements réels, les clés de production (voir Configuration). Rien n'a besoin d'être configuré dans le Merchant Portal.
6. Activez Enable/Disable. Testez un paiement avec Test mode activé, puis décochez-le pour accepter de vrais paiements.
Configuration
Tous les réglages sont sur une seule page : WooCommerce > Settings > Payments > MakeCommerce. Au-dessus des champs, la page affiche Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. pendant que le mode test est activé. Elle vous avertit lorsque le mode de paiement est activé mais que le Shop ID ou la Secret key de l'environnement actuel est vide, ainsi que lorsque la devise de la boutique ne peut pas être débitée par MakeCommerce. Dans les deux cas, le mode de paiement est masqué sur la page de commande. Dans la liste des modes de paiement, MakeCommerce est signalé comme nécessitant une configuration jusqu'à ce que l'environnement actuel dispose de ses clés. Les espaces sont supprimés des clés lors de l'enregistrement.
General
Enable/Disable: Enable MakeCommerce payments active ou désactive le mode de paiement. Par défaut : désactivé.
Title: le nom du mode de paiement que les clients voient sur la page de commande. Par défaut : Bank link or card (MakeCommerce).
Description: le texte affiché sous le mode de paiement sur la page de commande. Par défaut : Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.
MakeCommerce account
Le Shop ID et la Secret key se trouvent dans le Merchant Portal de MakeCommerce sous Settings > API. Le portail de test et le portail de production ont des comptes et des clés distincts. La section propose des liens vers les deux portails et vers la page d'inscription de MakeCommerce.
Test mode: Use the MakeCommerce test environment (no real money is charged). Les nouveaux paiements sont créés dans l'environnement sélectionné avec ses clés. Chaque commande mémorise l'environnement dans lequel elle a été payée : les vérifications de statut et les remboursements s'y effectuent toujours. Une ligne TEST MODE — MakeCommerce test environment, no real money is charged. est affichée lors de la commande. Par défaut : activé.
Test Shop ID: le Shop ID de votre compte de test, au format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Test Secret key: la Secret key de votre compte de test.
Live Shop ID: le Shop ID de votre compte de production.
Live Secret key: la Secret key de votre compte de production.
Payment notifications
Rien n'a besoin d'être configuré dans le Merchant Portal. Chaque transaction transporte ses propres URL de retour, d'annulation et de notification, basées sur l'adresse affichée dans cette section (de la forme https://your-site/wc-api/wc_mkc_payment/) à laquelle s'ajoutent le numéro de commande et la clé de commande. MakeCommerce envoie un message signé à l'URL de notification (de serveur à serveur) et, via le navigateur du client, à l'URL de retour ou d'annulation. La signature est vérifiée avec la Secret key de l'environnement dans lequel la transaction a été créée. Les messages dépourvus de signature valide sont rejetés.
L'extension gère les statuts de transaction MakeCommerce suivants :
Le paiement est également confirmé lorsque le client revient sur la boutique. Si le client revient sans message signé, l'extension demande le statut à l'API MakeCommerce.
Advanced
Debug log: Log API calls and payment notifications consigne les détails dans WooCommerce > Status > Logs, source wcp_makecommerce_payment. Les erreurs sont toujours journalisées. Les clés et les données clients ne sont jamais journalisées. Par défaut : désactivé.
Delete data: Delete the gateway settings and logs when the plugin is deleted. Les commandes et leurs notes de paiement sont toujours conservées. La désactivation de l'extension ne supprime jamais rien. Par défaut : désactivé.
Validation de commande
Le client choisit le mode de paiement (par défaut Bank link or card (MakeCommerce)) et passe commande. L'extension crée une transaction MakeCommerce pour le montant total de la commande dans la devise de la commande et redirige le client vers la page de paiement MakeCommerce. Sur cette page, le client choisit un lien bancaire ou une carte. L'e-mail de facturation et le pays sont transmis à MakeCommerce, et la page s'ouvre dans la langue de la boutique lorsque MakeCommerce la prend en charge (estonien, anglais, letton, lituanien, finnois, russe, allemand, polonais), sinon en anglais.
Après paiement, le client retourne sur la page de commande reçue de votre boutique. La commande n'est marquée payée qu'après confirmation par MakeCommerce : par la notification signée ou par le retour signé du client, avec une vérification de la transaction via l'API MakeCommerce.
Si le client annule sur la page MakeCommerce ou si le paiement expire, le client revient sur la page de commande (ou sur la page Pay for order) avec un message, par exemple The payment was cancelled. You can try again or choose another payment method. ou The payment session expired. Please try again. Si le paiement ne peut pas encore être confirmé, le message est We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. Le client peut payer à nouveau. Un lien de paiement plus ancien de la même commande fonctionne toujours, et la commande ne peut pas être payée deux fois.
Si MakeCommerce ne peut pas lancer le paiement, le client voit MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. ou MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. La raison technique est ajoutée aux notes de commande et au journal.
Le mode de paiement fonctionne sur la validation de commande classique, sur le bloc Paiement et sur la page Pay for order. Il est compatible avec le stockage haute performance des commandes (HPOS) de WooCommerce.
La banque ou la carte est choisie sur la page MakeCommerce, pas sur votre page de commande. L'extension ne prend en charge ni cartes enregistrées, ni paiements récurrents ou WooCommerce Subscriptions, et n'inclut pas les services d'expédition MakeCommerce (consignes automatiques, étiquettes).
Commandes et remboursements
Statuts de commande
Pending payment: le client a été redirigé vers MakeCommerce et n'a pas encore payé, ou MakeCommerce n'a pas encore confirmé le paiement. La note de commande indique la transaction MakeCommerce, le montant et l'environnement.
Processing: le paiement a été confirmé. Les commandes contenant uniquement des produits virtuels téléchargeables passent à l'état Terminé, valeur par défaut de WooCommerce. La note de commande indique le montant, la transaction, l'environnement et le mode de vérification (API MakeCommerce ou notification signée). L'identifiant de transaction correspond à l'identifiant de transaction MakeCommerce.
On hold: le montant payé ou la devise différait de la commande, le montant était manquant, le statut de la transaction sur MakeCommerce n'était pas encore définitif, ou le paiement est parvenu pour une commande annulée. La note de commande en donne l'explication. Une telle transaction ne paiera jamais la commande ultérieurement. Vérifiez la transaction dans le Merchant Portal et complétez ou remboursez la commande manuellement.
Failed: le dernier paiement de la commande a été annulé, a expiré ou a échoué. Le client peut payer à nouveau.
Si un second paiement arrive pour une commande déjà payée, la commande n'est pas modifiée à nouveau. Une note vous invite à rembourser le doublon dans le Merchant Portal de MakeCommerce.
Check MakeCommerce payment status
Sur l'écran de commande, choisissez Check MakeCommerce payment status dans les actions de commande. L'extension demande à l'API MakeCommerce le statut des transactions de la commande (la plus récente d'abord), l'applique et ajoute une note avec le résultat. Utilisez cette action lorsqu'une commande reste En attente de paiement alors que le client a payé.
Remboursements
Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Bank link or card (MakeCommerce) (le bouton affiche votre Title). Les remboursements totaux et partiels sont pris en charge. Le remboursement est envoyé vers l'environnement dans lequel la commande a été payée (test ou production), les clés de cet environnement doivent donc être configurées. Si MakeCommerce n'accepte pas le remboursement, WooCommerce affiche l'erreur, une note est ajoutée et aucun remboursement n'est enregistré. Si MakeCommerce traite encore le paiement, le message est MakeCommerce is still processing this payment — try the refund again later. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant de remboursement MakeCommerce.
Les remboursements effectués dans le Merchant Portal arrivent avec le statut de transaction et sont ajoutés aux notes de commande. Ils ne sont pas enregistrés automatiquement comme remboursements WooCommerce.
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 > MakeCommerce. Collez la clé dans License key et cliquez sur Activate. Le bloc indique le statut, par exemple la date d'expiration de la licence 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 domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.
Sans clé active, MakeCommerce n'est pas présenté aux clients lors de la commande. Si un paiement est tout de même initié, le client voit This payment method is not available. Please choose another one. Les gestionnaires de boutique connectés voient toujours le mode de paiement, avec la mention (unlicensed — visible to admins only), ce qui vous permet de configurer et de tester l'extension avant d'acheter une clé. Un rappel s'affiche sur la page Extensions et sur les pages de WooCommerce. Les commandes existantes ne sont pas affectées : les paiements déjà commencés restent 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 à nouveau vérifié automatiquement en arrière-plan.
Dépannage
MakeCommerce n'apparaît pas sur la page de commande : vérifiez que la licence est active, que Enable/Disable est activé et que l'environnement actuel dispose de ses clés : Test Shop ID et Test Secret key en mode test, Live Shop ID et Live Secret key en production. Vérifiez que la devise de la boutique (ou la devise de commande sur la page Pay for order) comporte au maximum deux décimales. La page des réglages affiche un avertissement pour chacun de ces problèmes.
Le paiement a abouti, mais la commande reste En attente de paiement : les notifications n'ont pas pu atteindre le site, par exemple à cause d'un pare-feu, d'un mode de maintenance ou d'une authentification de base. Ouvrez la commande et exécutez l'action de commande Check MakeCommerce payment status. Vérifiez que les clés de l'environnement où le paiement a été effectué sont définies : la notification est contrôlée avec la Secret key de cet environnement, sans quoi MakeCommerce reçoit une erreur et réessaie.
La commande est En attente avec une note MakeCommerce : le paiement ne correspondait pas à la commande (montant, devise, statut) ou est parvenu pour une commande annulée. Vérifiez la transaction dans le Merchant Portal et terminez ou remboursez la commande manuellement.
Les notifications sont rejetées : un message dont la signature est incorrecte, concernant une autre commande, une autre boutique ou une transaction non créée pour la commande est rejeté et la commande n'est pas modifiée. Vérifiez que le Shop ID et la Secret key appartiennent au même compte et au même environnement MakeCommerce.
Le client voit une erreur au moment de passer commande : ouvrez les notes de commande ou activez Debug log et consultez WooCommerce > Status > Logs, source wcp_makecommerce_payment. Une devise que MakeCommerce ne peut pas débiter renvoie MakeCommerce cannot process payments in et le code de devise.
Le remboursement échoue avec un message sur l'environnement : la commande a été payée dans l'environnement de test ou de production, et les clés de cet environnement ne sont pas configurées. Saisissez-les et réessayez.
Le remboursement échoue avec No MakeCommerce transaction ID found for this order : la commande n'a aucune transaction MakeCommerce. Effectuez le remboursement dans le Merchant Portal.
Le bloc de licence affiche une erreur : suivez les indications données 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 inaccessible, l'extension continue de fonctionner selon le dernier état connu.
Désinstallation
Désactiver l'extension conserve toutes les données. Pour la supprimer, désactivez-la et supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension sont toujours retirés. Les réglages de la passerelle et les journaux ne sont supprimés que si Delete data était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
MakeCommerce est une marque commerciale de son propriétaire respectif. Cette extension n'est pas affiliée à MakeCommerce ni approuvée par cette entreprise.