VibeFox Montonio 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: la devise de la boutique ou de la commande doit être EUR ou PLN. Pour toute autre devise, le mode de paiement est masqué au paiement.

Compte Montonio: vous avez besoin de la clé d'accès et de la clé secrète de votre boutique, disponibles dans le Montonio Partner System. Les clés sandbox et production sont différentes : il vous faut une paire pour chaque environnement utilisé. Rien d'autre n'est à configurer dans Montonio : l'adresse de notification est envoyée avec chaque paiement.

Site public : votre site doit être accessible depuis Internet pour recevoir les notifications de Montonio. Sinon, les commandes sont tout de même confirmées lorsque le client revient sur la boutique.

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 transférer le dossier wcp_montonio_payment dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Montonio > 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. Dans le Montonio Partner System, ouvrez Stores > your store > API keys et copiez la clé d'accès sandbox et la clé secrète sandbox. Collez-les dans les réglages et laissez Sandbox mode activé.

6. Activez Enable/Disable et testez un paiement en sandbox. Saisissez ensuite les clés de production et décochez Sandbox mode.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Montonio. Au-dessus des champs, la page vous avertit lorsque les clés de l'environnement actuel sont absentes (le mode de paiement est alors masqué au paiement) et lorsque la devise de la boutique n'est ni EUR ni PLN, et affiche Sandbox mode is on: payments are simulated and no real money is charged. tant que le sandbox est activé. Dans la liste des modes de paiement, Montonio est signalé comme nécessitant une configuration tant que les deux clés de l'environnement actuel ne sont pas renseignées.

Général

Enable/Disable: Enable Montonio bank payments active ou désactive le mode de paiement. Par défaut : désactivé.

Title: le nom du mode de paiement que voit le client au moment du paiement. Par défaut : Bank payment (Montonio).

Description: le texte affiché sous le mode de paiement au moment du paiement. Par défaut : Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

Clés API

Obtenez les clés dans le Montonio Partner System, sous Stores > your store > API keys. Les clés sandbox et production sont différentes. Le sandbox utilise uniquement les clés sandbox, et le mode production uniquement les clés de production. Cette section des réglages affiche également l'URL de notification. Elle ressemble à https://your-site/wc-api/wc_mnt_payment/. Vous n'avez rien à saisir à cet endroit : l'extension la transmet à Montonio avec chaque paiement.

Sandbox mode: Use the Montonio sandbox (test payments, no real money). Ce réglage change à la fois l'adresse de l'API Montonio et la paire de clés. Par défaut : activé. Ne le désactivez qu'après avoir saisi les clés de production.

Sandbox access key: la clé d'accès (UUID) de votre boutique dans le sandbox Montonio.

Sandbox secret key: la clé secrète de votre boutique dans le sandbox Montonio.

Live access key: la clé d'accès (UUID) de votre boutique dans l'environnement de production Montonio.

Live secret key: la clé secrète de votre boutique dans l'environnement de production Montonio.

Avancé

Debug log: Log payment events écrit tous les événements de paiement dans WooCommerce > Status > Logs, source wcp_montonio_payment. Les erreurs sont toujours journalisées, même lorsque cette option est désactivée. Les clés, jetons et données client ne sont jamais journalisés. Par défaut : désactivé.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Désactiver l'extension ne supprime jamais rien. Les données de commande (UUID Montonio, notes) sont toujours conservées. Par défaut : désactivé.

Notifications de paiement

Montonio informe votre boutique de chaque paiement au moyen d'un jeton signé. Le jeton arrive de deux façons : par une notification serveur à serveur vers l'URL de notification, et avec le client lorsqu'il revient sur la boutique. Les deux sont vérifiés : la signature avec votre clé secrète, la date d'expiration, votre clé d'accès, et le fait que le paiement soit bien celui que votre boutique a créé pour cette commande dans le même environnement. Les jetons qui échouent à la vérification sont rejetés. Chaque statut n'est appliqué qu'une fois, de sorte que les notifications répétées n'ajoutent ni notes, ni e-mails, ni modifications de stock.

Paiement

Le client choisit le mode de paiement (par défaut Bank payment (Montonio)) et passe la commande. L'extension crée un paiement Montonio pour le total de la commande dans la devise de la commande, et envoie le client sur la page de paiement Montonio. Il y choisit une banque et paie. Les banques du pays de facturation du client sont affichées en premier (la Pologne pour les commandes en PLN). Le paiement apparaît sous le libellé Order suivi du numéro de commande. La page Montonio s'ouvre dans la langue de la boutique lorsqu'il s'agit de l'allemand, de l'anglais, de l'estonien, du finnois, du lituanien, du letton, du polonais ou du russe ; sinon, elle s'ouvre en anglais. En mode sandbox, le paiement affiche SANDBOX MODE — test payment, no real money is charged. sous la description.

La commande n'est marquée comme payée qu'après confirmation de Montonio avec le statut PAID et le montant et la devise exacts de la commande. Après le paiement, le client revient sur la page de confirmation de commande de votre boutique. Tant que Montonio n'a pas encore confirmé le paiement, cette page affiche Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. Si le paiement a été annulé ou rejeté, le client revient sur la page Pay for order et voit l'un de ces messages : The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. ou Montonio could not complete the payment. Please try again or choose another payment method.

Un client peut payer à nouveau une commande impayée depuis la page Pay for order. Avant de créer un nouveau paiement, l'extension interroge Montonio sur le précédent. S'il est déjà payé, la commande est confirmée et aucun second paiement n'est créé.

Si Montonio ne peut pas démarrer le paiement, le client voit un court message, par exemple Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., et peut choisir un autre mode de paiement. L'erreur de Montonio est ajoutée aux notes de commande et au journal.

Le mode 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).

L'extension ne prend que les paiements bancaires (initiation de paiement). Elle ne gère ni paiements par carte, ni BLIK, ni Apple Pay ou Google Pay, ni Pay Later ou financement, ni expédition Montonio, ni abonnements, ni moyens de paiement enregistrés, ni choix de la banque sur votre propre site.

Commandes et remboursements

Statuts de commande

En attente de paiement: le client a été redirigé vers Montonio et n'a pas encore payé. Une note est ajoutée lorsque Montonio signale le paiement comme en attente.

En cours ou Terminée: Montonio a confirmé le paiement (PAID). La commande suit le statut WooCommerce standard des commandes payées. La note de commande affiche la banque, l'UUID du paiement Montonio, le montant et l'environnement. L'identifiant de transaction est l'UUID du paiement Montonio.

En attente: la banque n'a pas encore confirmé le paiement (AUTHORIZED) ; la commande devient payée lorsque Montonio signale PAID. Une commande est aussi placée En attente lorsque Montonio a signalé un montant ou une devise différents du total de la commande, lorsqu'un paiement sandbox est arrivé alors que la boutique est en mode production, ou lorsque le paiement est arrivé après l'annulation de la commande. La note de commande l'explique. Vérifiez le paiement dans le Montonio Partner System, puis expédiez la commande ou remboursez le paiement.

Échoué: le client n'a pas terminé le paiement ou la banque l'a rejeté. Seul le dernier paiement d'une commande impayée peut faire échouer la commande. Le client peut réessayer depuis la page Pay for order.

Les commandes payées, annulées ou remboursées ne sont jamais rouvertes par des notifications ultérieures. Si un second paiement arrive pour une commande déjà payée, la commande n'est pas modifiée. Une note vous invite à rembourser ce second paiement dans le Montonio Partner System.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Bank payment (Montonio) (le bouton reprend le titre du mode de paiement). Les remboursements totaux et partiels sont pris en charge pour les commandes payées via Montonio. Le remboursement est envoyé à l'environnement dans lequel le paiement a été effectué (sandbox ou production) ; les clés de cet environnement doivent donc être renseignées. Si Montonio n'accepte pas le remboursement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement envoyé est ajouté aux notes de commande avec son statut et l'identifiant de remboursement Montonio.

Montonio confirme ou rejette ensuite chaque remboursement par une notification. Une confirmation est ajoutée aux notes de commande. Si Montonio rejette le remboursement, la note indique que l'argent n'a pas été restitué au client ; vérifiez-le dans le Montonio Partner System et corrigez le remboursement WooCommerce.

Les remboursements effectués dans le Montonio Partner System sont ajoutés aux notes de commande lorsque Montonio les signale. Ils ne sont pas enregistrés automatiquement comme remboursements WooCommerce. Si nécessaire, créez un remboursement manuel dans 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 > Montonio. 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 l'emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, Montonio 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. Les gestionnaires de la boutique connectés voient toujours le mode 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 Plugins 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é automatiquement à nouveau en arrière-plan.

Dépannage

Montonio n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que les deux clés de l'environnement actuel sont renseignées (Sandbox access key et Sandbox secret key en mode sandbox, Live access key et Live secret key en mode production) et que la devise de la boutique ou de la commande est EUR ou PLN. La page des réglages affiche un avertissement lorsque des clés manquent ou que la devise n'est pas prise en charge.

Le paiement est passé, mais la commande reste En attente de paiement : la notification n'a pas atteint votre boutique. Vérifiez que le site est accessible depuis Internet et que les clés des réglages appartiennent à l'environnement du paiement. La commande est aussi confirmée lorsque le client revient sur la boutique après avoir payé, et lorsqu'il tente de payer à nouveau la même commande.

La notification répond Invalid token : la signature du jeton, sa date d'expiration ou la clé d'accès ne correspondent pas. Vérifiez que la clé d'accès et la clé secrète sont correctement copiées, qu'elles appartiennent au bon environnement, et que l'horloge du serveur est à l'heure.

La notification répond Payment does not belong to this order ou Wrong environment : le paiement n'a pas été créé par cette boutique pour cette commande, ou il a été créé dans l'autre environnement (sandbox ou production). Cela arrive lorsque deux boutiques utilisent le même compte Montonio et les mêmes numéros de commande.

La notification répond Gateway not configured : aucune clé Montonio n'est renseignée. Saisissez les clés ; Montonio renouvellera la notification.

Le client voit une erreur lors de la validation de la commande : ouvrez les notes de commande ou activez Debug log et consultez WooCommerce > Status > Logs, source wcp_montonio_payment. This payment method is temporarily unavailable. Please choose another payment method. signale généralement des clés erronées ou manquantes. Montonio could not start the payment. Please check your order details or choose another payment method. signifie que Montonio a refusé les données du paiement ; la note indique le motif.

La commande est En attente après le paiement : lisez la note de commande. La banque n'a pas encore confirmé le paiement, le montant ou la devise payés diffèrent de la commande, un paiement sandbox est arrivé en mode production, ou le paiement est arrivé après l'annulation de la commande. Vérifiez le paiement dans le Montonio Partner System.

Les paiements sandbox ne confirment pas une commande en production : un paiement sandbox ne finalise jamais une commande lorsque la boutique est en mode production ; la commande est alors placée En attente. Basculez Sandbox mode sur l'environnement souhaité et utilisez les clés de cet environnement.

Le remboursement échoue avec un message concernant l'environnement : le paiement a été effectué dans l'environnement sandbox ou production, et les clés de cet environnement ne sont pas renseignées. Saisissez-les 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é sur 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 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.

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