VibeFox Comgate for WooCommerce — Aide

Prérequis

WordPress: 6.0 ou ultérieur.

WooCommerce: 7.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.

PHP: 8.0 ou ultérieur.

HTTPS: votre site doit être accessible depuis Internet en HTTPS, afin que Comgate puisse envoyer la notification en arrière-plan.

Devise : CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK ou SEK. Pour les autres devises, et pour les totaux inférieurs au minimum Comgate, le moyen de paiement est masqué. Les paiements en HUF sont arrondis au forint entier, comme l'exige Comgate.

Compte Comgate : vous avez besoin du Merchant ID et du secret (mot de passe de communication en arrière-plan) de la connexion de votre boutique dans le portail client Comgate, ainsi que de l'URL de notification renseignée à cet endroit (voir Configuration). Comgate utilise le même Merchant ID et le même secret pour les paiements de test et les paiements réels.

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 téléverser le dossier wcp_comgate_gateway dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Comgate > 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 Merchant ID et le Secret du portail client Comgate, et renseignez l'URL de notification à cet endroit (voir Configuration).

6. Activez Enable / Disable. Laissez Test Mode activé pour un paiement d'essai, puis désactivez-le.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Comgate. Au-dessus des champs, la page vous avertit lorsque Comgate est activé mais que le Merchant ID ou le secret manque (le moyen de paiement est alors masqué au paiement tant que les deux ne sont pas renseignés), ainsi que lorsque la devise de la boutique n'est pas prise en charge. Tant que le mode test est activé, elle affiche Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live.

Général

Enable / Disable: Enable Comgate Payment Gateway active ou désactive le moyen de paiement. Par défaut : désactivé.

Title: le nom du moyen de paiement que voit le client au paiement. Par défaut : Comgate.

Description: le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay securely via Comgate — cards, bank transfers, wallets and more. En mode test, TEST MODE: no real money is charged. y est ajouté, ou affiché seul lorsque la description est vide.

Connexion Comgate

Récupérez l'identifiant de boutique (Merchant ID) et le mot de passe (secret) dans le portail client Comgate, Integration > shop connection settings. Au même endroit, renseignez l'URL for passing the payment result (notification en arrière-plan) avec l'URL affichée dans cette section. Elle ressemble à https://your-site/wc-api/comgate_payment_callback/. Comgate l'appelle après chaque paiement ; l'extension vérifie alors à nouveau le paiement via l'API de statut de Comgate avant de modifier la commande. Les URL de retour du client sont transmises avec chaque paiement. Si le portail demande aussi les URL de retour (payé, annulé, en attente), utilisez la seconde URL affichée dans cette section, qui ressemble à https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.

Merchant ID: l'identifiant de la boutique en ligne Comgate (merchant).

Secret: le mot de passe de communication en arrière-plan (secret) de cette connexion de boutique.

Test Mode: Create test payments (no money is charged). Comgate utilise le même Merchant ID et le même secret pour les paiements de test et les paiements réels ; les paiements de test sont marqués test=true. Les remboursements sont toujours envoyés dans le mode du paiement d'origine. Par défaut : activé.

Page de paiement

Payment Methods: les moyens de paiement Comgate parmi lesquels le client peut choisir. Seuls les moyens activés pour votre boutique dans Comgate sont affichés.

Language: la langue de la page de paiement Comgate. Automatic (site language, English as fallback) (par défaut) ou l'une des 26 langues proposées.

Commandes

Order Status After Payment: le statut défini lorsque Comgate confirme le paiement. Le statut est défini immédiatement, sans second changement de statut.

Avancé

Debug Log: Log API requests and notifications écrit dans WooCommerce > Status > Logs, source wcp_comgate_gateway. Le secret et les données personnelles ne sont jamais journalisés. Les erreurs sont toujours journalisées. Par défaut : désactivé.

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Les commandes et leurs identifiants de transaction Comgate sont toujours conservés. Par défaut : désactivé.

Paiement

Le client choisit le moyen de paiement (par défaut Comgate) et passe sa commande. L'extension crée le paiement chez Comgate pour le total de la commande dans la devise de la commande et redirige le client vers la page de paiement Comgate. L'e-mail et le nom de facturation sont transmis à Comgate, et le paiement porte le numéro de commande. Une adresse e-mail de facturation valide est obligatoire. Sur la page Comgate, le client paie avec l'un des moyens que vous avez autorisés.

Après le paiement, le client revient dans votre boutique. La commande n'est marquée payée qu'après confirmation de Comgate : l'extension relit le paiement via l'API de statut de Comgate, à la réception de la notification en arrière-plan comme lorsque le client revient. Si le paiement n'est pas encore confirmé, par exemple un virement bancaire en cours, la page de confirmation de commande affiche Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. Si la commande a été mise en attente, la page affiche Your payment is being reviewed. We will contact you if anything else is needed.

Si le paiement est annulé ou expire, le client revient au paiement (ou au panier) avec The Comgate payment was cancelled or has expired. You can try again or choose another payment method. Un client peut payer à nouveau une commande non payée, par exemple depuis la page Pay for order. La tentative précédente est vérifiée en premier, afin qu'un paiement déjà abouti ne soit pas débité deux fois, et elle est annulée chez Comgate si elle est encore ouverte. Un paiement tardif d'une tentative antérieure paie tout de même une commande non payée.

Si Comgate ne peut pas démarrer le paiement, le client voit un court message, par exemple The Comgate payment could not be started. Please try again or choose another payment method., indiquant que Comgate n'accepte pas ce montant ou cette devise, ou que le moyen de paiement Comgate sélectionné n'est pas disponible. La raison technique est écrite dans le journal.

Le moyen de paiement fonctionne avec le paiement classique, avec 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 des paiements uniques sur la page Comgate. Elle ne gère ni paiements récurrents, ni abonnements, ni cartes enregistrées, ni formulaire de paiement Comgate intégré, ni boutons Apple Pay ou Google Pay sur votre site (ils sont disponibles sur la page Comgate), et ne capture ni n'annule les pré-autorisations depuis WooCommerce. Sans notification, le statut du paiement n'est pas interrogé automatiquement ; il n'est vérifié que lorsque le client revient.

Commandes et remboursements

Statuts de commande

Pending payment: le client a été envoyé vers Comgate et n'a pas encore payé, ou Comgate signale le paiement comme en attente. La note de commande indique le paiement Comgate créé.

Processing or Completed: Comgate a signalé le paiement comme PAID, avec le même montant et la même devise. Le statut suit Order Status After Payment. L'identifiant de transaction de la commande est l'identifiant de transaction Comgate ; toutes les tentatives sont conservées avec la commande. Les paiements de test reçoivent la note Comgate test payment — no money was charged.

On hold: le montant ou la devise payé diffère de la commande, un paiement de test a été confirmé alors que la boutique est en mode production (aucun argent n'a été reçu), ou le paiement n'est qu'autorisé (pré-autorisation sur votre compte Comgate). Un paiement autorisé devient payé automatiquement lorsque vous le capturez dans le portail Comgate. La note de commande explique la raison.

Cancelled: le paiement Comgate en cours a été annulé ou a expiré. Si Comgate confirme le paiement après que WooCommerce a annulé la commande non payée (par exemple un virement bancaire lent), la commande est rouverte comme payée avec une note vous invitant à vérifier le stock avant l'expédition.

Si Comgate signale un autre paiement PAID pour une commande déjà payée, la commande n'est plus modifiée. Une note vous invite à le vérifier dans le portail Comgate et à rembourser le doublon. Une confirmation rejouée ne rouvre jamais une commande remboursée ni une commande annulée après paiement.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Comgate (le bouton affiche le titre du moyen de paiement). Les remboursements totaux et partiels sont pris en charge. Le remboursement porte sur la transaction Comgate payée et est envoyé dans le mode (test ou production) du paiement d'origine. Comgate ne rembourse que les paiements PAID, dans la limite du montant payé ; les remboursements en HUF doivent être des forints entiers. Si Comgate n'accepte pas le remboursement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande, avec le montant, la transaction Comgate et le motif.

Les remboursements effectués dans le portail Comgate ne sont pas signalés à la boutique. Si nécessaire, créez un remboursement manuel dans WooCommerce, sans passer par Refund via du moyen de paiement.

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 > Comgate. 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 son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, Comgate n'est pas affiché aux clients au 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 connectés de la boutique 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 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 l'assistance nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

Comgate n'apparaît pas au paiement : vérifiez que la licence est active, que Enable / Disable est activé, que Merchant ID et Secret sont renseignés, que la devise de la commande est prise en charge et que le total de la commande n'est pas inférieur au minimum Comgate (par exemple 1 CZK, 0,10 EUR ou 100 HUF). La page des réglages affiche un avertissement lorsque les identifiants manquent ou que la devise n'est pas prise en charge.

Le paiement a été effectué, mais la commande reste « En attente de paiement » : Comgate n'a pas remis la notification en arrière-plan. Vérifiez l'URL for passing the payment result dans le portail Comgate, que votre site est accessible depuis Internet en HTTPS (sans mode maintenance ni protection par mot de passe) et le journal (activez Debug Log). Comgate renvoie les notifications non remises ; l'extension répond par une erreur chaque fois qu'elle n'en a pas traité une, afin qu'elle soit renvoyée. La commande est aussi confirmée lorsque le client revient dans la boutique.

La notification répond Invalid merchant or secret : le Merchant ID ou le secret des réglages ne correspond pas à la connexion de boutique du portail Comgate.

La notification répond Gateway not configured : le Merchant ID ou le secret est vide dans les réglages. Comgate réessaie une fois ceux-ci renseignés.

La notification répond Order not found, Unknown transaction ou Reference mismatch : la notification concerne un paiement qui n'a pas été créé par cette boutique pour cette commande. La commande n'est pas modifiée.

La notification répond Status verification failed, Status verification rejected ou Busy, retry later : l'API de statut de Comgate n'a pas pu être jointe, a rejeté la requête, ou la commande était en cours de traitement par une autre requête au même moment. Comgate renvoie la notification.

Le client voit We could not verify the Comgate payment : le lien de retour ne correspondait pas à la commande. Si le montant a été débité, la notification confirme tout de même la commande. Vérifiez le paiement dans le portail Comgate avant que le client ne paie à nouveau.

Le client voit The order total is below the minimum amount accepted by Comgate ou A valid billing e-mail address is required for Comgate payments : la commande ne peut pas être payée avec Comgate en l'état.

Order is On hold after payment: lisez la note de commande. Le montant ou la devise payé était différent, un paiement de test est arrivé en mode production, ou le paiement n'est qu'autorisé. Vérifiez le paiement dans le portail Comgate, puis terminez ou remboursez la commande manuellement.

Le remboursement échoue : lisez le message. Comgate rejected the refund: the amount exceeds the refundable amount. signifie que le montant est supérieur à ce qui reste remboursable ; un paiement dont le statut n'est pas PAID ne peut pas être remboursé. Comgate could not be reached. The refund was not made — please try again later. signifie un problème de connexion.

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 future réinstallation. Les commandes et leurs données Comgate sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

Comgate est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à Comgate ni approuvée par Comgate.