VibeFox ePayco for WooCommerce — Aide
Prérequis
WordPress : 5.8 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.
Devise de la boutique : peso colombien (COP) ou dollar américain (USD). Pour les autres devises, le moyen de paiement est masqué sur la page de paiement.
Compte ePayco : vous avez besoin des quatre clés de votre compte ePayco : P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY et PRIVATE_KEY. Elles se trouvent dans le tableau de bord ePayco, sous Integrations, API keys. Les mêmes clés fonctionnent en mode test et en mode production. Les moyens de paiement proposés au client (cartes, PSE, réseaux de paiement en espèces, portefeuilles) sont ceux activés sur votre compte ePayco.
Site public : l'URL de confirmation de votre boutique doit être accessible depuis Internet, sans être bloquée par le mode maintenance, un pare-feu ou une authentification HTTP de base.
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_epayco_payment dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > ePayco > 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, puis cliquez sur Activate.
5. Saisissez les quatre clés ePayco et choisissez le type de paiement (voir Configuration).
6. Activez Enable/Disable. Testez un paiement en Test Mode avec les cartes de test ePayco, puis décochez Test Mode.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > ePayco. Au-dessus des champs, la page vous avertit lorsque les quatre clés ne sont pas toutes saisies (le moyen de paiement est alors masqué sur la page de paiement), lorsque la devise de la boutique n'est ni COP ni USD, et affiche Test mode is on: customers pay with ePayco test cards and no real money is charged. tant que le mode test est activé. Dans la liste des moyens de paiement, ePayco est signalé comme nécessitant une configuration tant que les quatre clés ne sont pas saisies.
Général
Enable/Disable : Enable ePayco Payment active ou désactive le moyen de paiement. Par défaut : désactivé.
Title : le nom du moyen de paiement que voit le client sur la page de paiement. Par défaut : ePayco.
Description : le texte affiché sous le moyen de paiement sur la page de paiement. Par défaut : Pay securely with ePayco.
Clés du compte ePayco
Retrouvez les quatre clés dans le tableau de bord ePayco, sous Integrations, API keys. P_CUST_ID_CLIENTE et P_KEY vérifient les confirmations de paiement ; PUBLIC_KEY et PRIVATE_KEY créent les sessions de paiement. Les mêmes clés fonctionnent en mode test et en mode production.
Customer ID (P_CUST_ID_CLIENTE) : votre identifiant client ePayco (numérique).
Secret Key (P_KEY) : sert à vérifier la signature des confirmations de paiement ePayco. Gardez-la secrète.
Public Key (PUBLIC_KEY) : votre clé publique d'API ePayco.
Private Key (PRIVATE_KEY) : votre clé privée d'API ePayco. Gardez-la secrète.
Test Mode : Enable test mode crée les sessions de paiement sous forme de transactions de test. Les clients paient avec les cartes de test ePayco, et aucun argent réel n'est débité. Les transactions de test ne règlent jamais les commandes créées en mode production. Par défaut : désactivé.
Paiement
Checkout Type : la manière dont s'ouvre la page de paiement ePayco.
URL de confirmation
L'URL de confirmation indique à votre boutique le résultat d'un paiement. Elle est transmise automatiquement à ePayco avec chaque paiement : rien n'est à configurer dans le tableau de bord ePayco. La section affiche l'URL, qui ressemble à https://your-site/wc-api/epc_p/. Elle doit être accessible depuis Internet, sans être bloquée par le mode maintenance, un pare-feu ou une authentification HTTP de base.
Chaque confirmation doit porter une signature valide, créée avec votre P_CUST_ID_CLIENTE et votre P_KEY. Les confirmations sans signature valide sont rejetées et ne modifient pas la commande. Sans la confirmation, une commande n'est mise à jour que lorsque le client revient sur la boutique après avoir payé.
Avancé
Logging : Enable logging écrit les erreurs de l'API et les confirmations de paiement dans WooCommerce > Status > Logs, source wcp_epayco_payment. Les clés et les données clients ne sont pas journalisées. Par défaut : désactivé.
Delete Data on Uninstall : Remove the gateway settings and logs when the plugin is deleted. La désactivation de l'extension ne supprime jamais rien. Les données ePayco enregistrées sur les commandes sont conservées. Par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut ePayco) et valide la commande. L'extension crée une session de paiement ePayco pour le total de la commande dans la devise de la commande, avec les taxes de la commande, le numéro de commande ainsi que le nom, l'adresse, l'e-mail et le téléphone de facturation. La langue de la page de paiement est l'espagnol ou l'anglais, selon la langue du site. Le client arrive ensuite sur la page de paiement de la commande, qui affiche Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. La page de paiement ePayco s'ouvre dans une fenêtre contextuelle ou par redirection, selon Checkout Type. La page comporte aussi le bouton Pay with ePayco et le lien Choose another payment method. En mode test, la page et la page de paiement ePayco affichent TEST MODE — use ePayco test cards, no real money is charged.
Sur la page de paiement ePayco, le client règle avec l'un des moyens de paiement activés sur votre compte ePayco. Ensuite, ePayco envoie la confirmation à votre boutique et renvoie le client. La commande n'est marquée payée qu'après confirmation d'ePayco : par la confirmation signée, ou par une requête côté serveur vers ePayco lorsque le client revient. Le simple retour du client ne règle jamais une commande.
Si le paiement n'est pas encore confirmé, la page « Commande reçue » affiche We are waiting for ePayco to confirm your payment. This page does not need to stay open. Pour un paiement en attente (par exemple PSE ou espèces), elle affiche Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved.
Si le paiement a été refusé, le client revient sur la page Pay for order avec le message Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. Si le client revient sans avoir payé, le message est The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again.
Si ePayco ne peut pas lancer le paiement, le client voit un court message, par exemple We could not connect to ePayco. Please try again in a moment or choose another payment method. Le motif est ajouté aux notes de la 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 le stockage haute performance des commandes de WooCommerce (HPOS). Les textes destinés aux clients sont traduits en espagnol.
L'extension ne gère que les paiements uniques. Elle ne propose ni remboursements depuis WooCommerce, ni cartes enregistrées, ni abonnements ou paiements fractionnés, et elle n'interroge pas ePayco sur les transactions en attente : les commandes sont mises à jour par la confirmation d'ePayco et par le retour du client.
Commandes
Statuts de commande
Pending payment: le client a été envoyé vers ePayco et n'a pas encore payé, ou ePayco n'a pas encore confirmé le paiement.
Processing: le paiement a été accepté (les commandes ne contenant que des produits virtuels téléchargeables passent à Terminée, la valeur par défaut de WooCommerce). La note de commande affiche la référence ePayco, l'état, le montant, le moyen de paiement et le code d'approbation. L'ID de transaction de la commande est la référence ePayco (ref_payco).
On hold, payment pending: ePayco a signalé le paiement comme en attente ou retenu, par exemple un virement PSE ou un paiement en espèces. La commande change automatiquement lorsqu'ePayco le confirme ou le rejette.
On hold, amount/currency mismatch: ePayco a approuvé un paiement dont le montant ou la devise diffère de la commande. N'expédiez pas la commande avant d'avoir vérifié la transaction dans le tableau de bord ePayco.
On hold, payment for a cancelled order: ePayco a approuvé un paiement après l'annulation de la commande. Rétablissez la commande ou remboursez le paiement dans ePayco.
Failed: le paiement a été refusé, a échoué, a expiré, a été abandonné, annulé ou arrêté par l'antifraude. La note affiche le motif donné par ePayco. Le client peut réessayer. Un échec tardif ne modifie jamais une commande payée.
Refunded: ePayco a remboursé le paiement de cette commande.
Si ePayco signale un autre paiement approuvé pour une commande déjà payée, le statut ne change pas. Une note vous invite à vérifier s'il s'agit d'un double débit et à le rembourser dans ePayco si nécessaire. Une transaction de test pour une commande passée en mode production, et une transaction qui appartient déjà à une autre commande, sont ignorées avec une note.
Remboursements : les remboursements depuis WooCommerce ne sont pas pris en charge. Remboursez le paiement dans le tableau de bord ePayco, puis enregistrez le remboursement dans WooCommerce avec Refund manually.
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 > ePayco. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche l'état de la licence, par exemple la date jusqu'à laquelle elle est active, ainsi que votre domaine. Utilisez Check now pour vérifier à nouveau l'état, 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 correspondant. Libérez-le dans votre compte vibefox.net.
Sans clé active, ePayco n'est pas affiché aux clients sur la page de 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, signalé par (unlicensed — visible to admins only), afin de pouvoir 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.
Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. L'état est vérifié à nouveau automatiquement en arrière-plan.
Dépannage
ePayco n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que les quatre clés sont saisies et que la devise de la boutique est COP ou USD. Sur la page Pay for order, la devise de la commande est vérifiée. La page des réglages affiche un avertissement lorsqu'un élément manque.
Le paiement a abouti, mais la commande reste en Pending payment : la confirmation ePayco n'atteint pas votre boutique. Vérifiez que l'URL de confirmation affichée dans les réglages est accessible depuis Internet et n'est pas bloquée par le mode maintenance, un pare-feu, une extension de sécurité ou une authentification HTTP de base. Activez Logging et consultez WooCommerce > Status > Logs, source wcp_epayco_payment. La commande est aussi mise à jour lorsque le client revient sur la boutique après avoir payé.
La confirmation répond Invalid signature : Customer ID (P_CUST_ID_CLIENTE) ou Secret Key (P_KEY) ne correspond pas au compte ePayco qui a reçu le paiement. Copiez de nouveau les deux valeurs depuis le tableau de bord ePayco.
La confirmation répond Gateway not configured : P_CUST_ID_CLIENTE ou P_KEY est vide. Saisissez-les dans les réglages.
La confirmation répond Busy, retry later : la commande était en cours de mise à jour par une autre requête au même moment. ePayco renvoie la confirmation.
Le client voit We could not connect to ePayco : ePayco a refusé PUBLIC_KEY et PRIVATE_KEY. La note de commande affiche la réponse d'ePayco. Copiez de nouveau les deux clés.
Le client voit ePayco could not start the payment : ePayco n'a pas créé la session de paiement. Consultez la note de commande pour l'erreur ePayco.
La page de paiement ePayco ne s'ouvre pas : le client voit The ePayco checkout could not be loaded. Please reload the page or choose another payment method. Le script de paiement ePayco n'a pas pu être chargé sur la page de paiement de la commande. Le client peut recharger la page ou utiliser Choose another payment method.
Un paiement de test n'a pas réglé la commande : les transactions de test ne règlent jamais les commandes passées en mode production. Passez la commande de test lorsque Test Mode est activé.
La commande est On hold : lisez la note de commande. ePayco a signalé le paiement comme en attente, le montant ou la devise approuvé différait de la commande, ou le paiement est arrivé après l'annulation de la commande. Vérifiez la transaction dans le tableau de bord ePayco avant l'expédition.
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 état connu.
Pour les développeurs, la documentation de l'extension répertorie les filtres epc_p_supported_currencies (devises pour lesquelles le moyen de paiement est proposé), epc_p_session_payload (données envoyées à ePayco) et epc_p_icon (icône de la page de paiement).
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 l'état de licence de cette extension sont toujours supprimés. Les réglages de la passerelle et les journaux ne sont supprimés que si l'option Delete Data on Uninstall était activée. Sinon, ils sont conservés pour une future réinstallation. Les données ePayco enregistrées sur les commandes sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.
ePayco est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à ePayco ni approuvée par ePayco.