VibeFox Moneris for WooCommerce — Aide

Prérequis

WordPress: 6.0 ou ultérieur.

WooCommerce: 8.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: CAD pour un compte Moneris canadien, USD pour un ancien compte Moneris USA. La passerelle n'est affichée que si la devise de la commande correspond à celle du compte.

HTTPS et PCI DSS: les numéros de carte sont saisis sur votre page de paiement et transitent par votre serveur. Les paiements réels exigent HTTPS et la conformité PCI DSS SAQ D. Si vous ne pouvez pas la garantir, utilisez plutôt une solution de page de paiement hébergée.

Compte Moneris: vous avez besoin du Store ID et de l'API Token de votre boutique Moneris Gateway, disponibles dans le Moneris Merchant Resource Center > Admin > Store Settings. Pour les tests, la boutique de test publique de Moneris est renseignée par défaut. Les identifiants de test et les cartes de test se trouvent sur le portail développeurs de Moneris.

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_moneris_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Moneris > 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 pays du compte et saisissez le Live Store ID et le Live API Token. Le mode test est activé par défaut et utilise la boutique de test publique (store5 / yesguy pour le Canada, monusqa002 / qatoken pour les États-Unis).

6. Choisissez Purchase ou Pre-Authorization ainsi que les logos de carte, puis activez Enable / Disable.

7. Passez une commande de test avec une carte de test Moneris, puis décochez Test mode.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Moneris. Au-dessus des champs, la page affiche Moneris gateway is in TEST MODE. No real charges will be made. tant que le mode test est activé. En mode réel, elle vous avertit si les champs réels contiennent des identifiants de test Moneris (la passerelle est alors masquée au paiement) et si le site n'utilise pas HTTPS. Elle vous avertit aussi si la devise de la boutique n'est pas celle du compte Moneris ; la passerelle est alors masquée au paiement.

Général

Enable / Disable: Enable Moneris Gateway active ou désactive le mode de paiement. Par défaut : désactivé.

Title: le nom du mode de paiement affiché au client. Par défaut : Credit card (Moneris). En mode test, (Test Mode) est ajouté au titre au moment du paiement.

Description: le texte affiché au-dessus des champs de carte au moment du paiement. Par défaut : Pay securely with your credit card.

Compte Moneris

Votre Store ID et votre API Token se trouvent dans le Moneris Merchant Resource Center, sous Admin > Store Settings. Les identifiants de test et les cartes de test se trouvent sur le portail développeurs de Moneris. La section contient des liens vers les deux.

Moneris account country: les comptes canadiens débitent en CAD, les comptes américains en USD. La passerelle n'est affichée que si la devise de la commande correspond. Par défaut : Canada (CAD).

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). Les remboursements, captures et annulations sont toujours envoyés à l'environnement dans lequel le paiement a été effectué. Les clients voient TEST MODE: use a Moneris test card, no real charges are made. au-dessus des champs de carte. Par défaut : activé.

Live Store ID: le Store ID de production, par exemple monca01234.

Live API Token: l'API Token de production.

Test Store ID: la boutique de test publique de Moneris : store5 (Canada) ou monusqa002 (États-Unis). Par défaut : store5.

Test API Token: le jeton de test public : yesguy (Canada) ou qatoken (États-Unis). Par défaut : yesguy.

Paiement

Transaction type: la manière dont la carte est débitée. Par défaut : Purchase.

Card logos: les logos des marques de carte affichés à côté du titre du mode de paiement : Visa, Mastercard, Discover, American Express, JCB. Les marques acceptées dépendent de votre compte Moneris. Par défaut : Visa and Mastercard.

Avancé

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked). Les erreurs sont toujours journalisées. Consultez le journal dans WooCommerce > Status > Logs, source wcp_moneris_gateway. Par défaut : désactivé.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Par défaut : désactivé.

Paiement

Le client choisit le mode de paiement (par défaut Credit card (Moneris)) et saisit le numéro de carte, la date d'expiration et le code de sécurité dans le formulaire de carte WooCommerce de votre page de paiement. Lorsque la commande est passée, votre serveur envoie la carte à Moneris pour le total de la commande et obtient le résultat immédiatement. Il n'y a ni redirection ni webhook. Le code de sécurité (CVD) est toujours transmis ; les règles eFraud de votre boutique Moneris s'appliquent donc toujours.

Un paiement approuvé n'est marqué comme payé que lorsque Moneris indique que la transaction est terminée et que le montant traité est égal au total de la commande. Le client accède ensuite à la page de confirmation de commande. Avec Pre-Authorization, la commande reste En attente jusqu'à ce que vous capturiez les fonds.

Si la carte est refusée, le client voit Your card was declined avec le motif indiqué par Moneris, et peut vérifier les données de sa carte ou utiliser une autre carte. Si Moneris ne peut pas traiter la demande (par exemple un Store ID ou un API Token incorrect), le client voit The payment could not be processed. Please try again or use another payment method. Le motif est ajouté aux notes de commande et au journal. Un second clic pendant le traitement d'un paiement affiche A payment for this order is already being processed. Please wait a moment and check your order status before trying again. Une commande payée ou préautorisée n'est jamais débitée à nouveau.

Si Moneris ne répond pas (erreur réseau ou délai dépassé), l'extension envoie une Status Check à Moneris pour savoir si la transaction a abouti. Si ce n'est pas possible non plus, la commande passe En attente avec l'identifiant de commande Moneris, et le client n'est pas invité à payer une seconde fois.

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 en charge ni cartes enregistrées ni Moneris Vault, ni WooCommerce Subscriptions, ni Apple Pay, Google Pay ou Interac Online, ni Moneris Checkout ou Hosted Tokenization, ni 3-D Secure, AVS ou Kount, ni tarification en plusieurs devises.

Commandes et remboursements

Statuts de commande

En attente de paiement: la commande a été créée et la carte n'a pas encore été débitée, par exemple après une tentative refusée. La note de commande affiche le code et le message de Moneris. Le client peut payer à nouveau.

En cours: l'achat a été approuvé. Les commandes ne comportant que des produits virtuels téléchargeables passent à Terminée, la valeur par défaut de WooCommerce. La note de commande affiche le montant, l'identifiant de transaction Moneris et le reçu. L'identifiant de transaction est le numéro de transaction Moneris.

En attente: une préautorisation a été approuvée et attend la capture, le montant traité était différent du total de la commande, ou Moneris n'a pas confirmé le résultat. La note de commande l'explique.

Annulée: pour une commande préautorisée, l'annulation libère les fonds réservés (void).

Capture et annulation

Pour capturer une préautorisation, passez le statut de la commande à En cours ou Terminée, ou choisissez Capture Moneris pre-authorization dans les actions de commande. Le total actuel de la commande, moins les remboursements, est capturé ; il ne peut pas dépasser le montant autorisé. Si Moneris refuse la capture, le statut repasse En attente avec une note, et aucun e-mail de traitement ou de commande terminée n'est envoyé. Les préautorisations Moneris expirent au bout de quelques jours : capturez-les à temps.

Pour libérer les fonds, annulez la commande ou choisissez Void Moneris pre-authorization (cancel order) dans les actions de commande. Passer la commande à Remboursée libère aussi une préautorisation ouverte. Si la libération échoue, une note vous invite à la libérer dans le Merchant Resource Center.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Credit card (Moneris) (le bouton affiche votre Title). Les remboursements totaux et partiels sont pris en charge. Une préautorisation ne peut être remboursée qu'après sa capture ; avant cela, annulez la commande pour libérer les fonds. Le remboursement est envoyé à l'environnement et au compte dans lesquels le paiement a été effectué ; les identifiants de ce mode doivent donc être renseignés. Si Moneris refuse le remboursement, WooCommerce affiche Refund failed avec le motif, et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande avec l'identifiant de transaction Moneris.

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 > Moneris. 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, Moneris 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 : captures, annulations et 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

Moneris n'apparaît pas au paiement: vérifiez que la licence est active, que Enable / Disable est activé et que le mode actuel dispose d'un Store ID et d'un API Token. En mode réel, les champs réels doivent contenir vos identifiants de production, et non des identifiants de test Moneris. Vérifiez que la devise de la boutique (ou la devise de la commande sur la page Pay for order) est la devise du compte : CAD pour le Canada, USD pour un compte américain. La page des réglages affiche un avertissement lorsque la devise ne correspond pas.

Le paiement est passé, mais la commande reste En attente de paiement ou En attente: l'extension n'a pas de webhook ; le résultat provient uniquement de la réponse de Moneris. Si la commande est En attente avec une note indiquant que Moneris n'a pas confirmé le résultat, Moneris n'a pas répondu et la Status Check a également échoué. Recherchez l'identifiant de commande Moneris indiqué dans la note dans le Merchant Resource Center : si la transaction y figure, expédiez la commande (et remboursez-la là-bas si nécessaire) ; sinon, annulez la commande ou demandez au client de payer à nouveau.

Le client voit Payment gateway is misconfigured. Please contact the store administrator.: les identifiants du mode actuel sont absents, ou le mode réel est activé avec des identifiants de test Moneris dans les champs réels. Saisissez votre Store ID et votre API Token de production.

Le client voit This payment method does not support the order currency.: la devise de la commande n'est pas la devise du compte Moneris.

Le client voit une erreur lors du paiement: ouvrez les notes de commande ou activez Debug log et consultez WooCommerce > Status > Logs, source wcp_moneris_gateway.

La capture échoue: la commande n'a pas de préautorisation en attente de capture, son total est nul, ou le montant est supérieur au montant autorisé. Les préautorisations Moneris expirent également au bout de quelques jours.

Le remboursement, la capture ou l'annulation échoue avec un message concernant le mode ou le compte: le paiement a été effectué en mode test ou en mode réel, et les identifiants de ce mode ne sont pas renseignés, ou le paiement a été effectué avec un compte Moneris de l'autre pays. Saisissez les identifiants, ou traitez le paiement dans le Merchant Resource Center.

Attaques de test de cartes: les formulaires de carte directs sont la cible des tests de cartes. Activez la limitation de débit du paiement WooCommerce, une extension CAPTCHA, ainsi que les règles eFraud ou de vélocité dans votre compte Moneris.

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 on uninstall é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.

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