VibeFox Paysera for WooCommerce — Aide
Prérequis
WordPress : 6.0 ou ultérieur.
WooCommerce : 7.0 ou ultérieur, installé et activé. Le plugin refuse de s'activer sans lui.
PHP : 8.0 ou ultérieur.
Projet Paysera : vous avez besoin de l'identifiant de projet et du mot de passe de projet (clé de signature) de votre projet Paysera. Les moyens de paiement que voit le client sont ceux activés dans ce projet. Rien n'est à configurer dans Paysera pour le callback : son URL est envoyée avec chaque requête de paiement.
Site accessible : les commandes sont payées par le callback Paysera, donc votre site doit être accessible depuis Internet, sans être protégé par une connexion, un mode maintenance ou un pare-feu.
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 du plugin et cliquez sur Install Now. Vous pouvez aussi transférer le dossier wcp_paysera_payment dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Payments > Paysera > Manage, ou cliquez sur Settings sous le nom du plugin sur la page des 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 Project ID et le Project password de votre compte Paysera (voir Configuration).
6. Facultatif : activez Allow test payments dans le projet Paysera et Test payments dans le plugin pour tester le parcours sans débit d'argent. Désactivez-les avant de commencer à vendre.
7. Activez Enable/Disable et enregistrez.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Paysera. Au-dessus des champs, la page affiche Paysera est masqué au paiement tant que l'identifiant de projet et le mot de passe de projet ne sont pas saisis. lorsque l'un des deux manque, ainsi qu'un avertissement indiquant que les clients ne sont pas débités tant que les paiements de test ou le bac à sable sont activés. Dans la liste des moyens de paiement, Paysera est signalé comme nécessitant une configuration tant que le projet n'est pas configuré, et un badge de mode test s'affiche lorsque les paiements de test ou le bac à sable sont activés.
Général
Enable/Disable: Enable Paysera Payment active ou désactive le moyen de paiement. Par défaut : désactivé.
Title: le nom du moyen de paiement affiché au moment du paiement. Par défaut : Paysera.
Description: le texte affiché sous le moyen de paiement au moment du paiement. Par défaut : Pay securely via Paysera.
Projet Paysera
Vous trouverez l'identifiant de projet et le mot de passe de projet dans votre compte Paysera, sous Projects and activities, votre projet, General project settings. La section affiche l'URL du callback, qui ressemble à https://your-site/wc-api/wc_psr_payment/. Elle est envoyée automatiquement avec chaque paiement ; rien n'est à configurer dans Paysera.
Project ID: l'identifiant numérique de votre projet Paysera.
Project password: le mot de passe du projet (clé de signature). Il signe les requêtes de paiement et vérifie les callbacks Paysera.
Tests
Test payments: Send payments in test mode (no money is charged). Paysera renvoie un paiement de test réussi sans débiter le client. Activez d'abord Allow test payments dans les réglages du projet Paysera. Tant que cette option est active, les paiements de test marquent les commandes comme payées ; lorsqu'elle est désactivée, un paiement de test ne règle jamais une commande. Par défaut : désactivé.
Environment: l'endroit où le client est envoyé. Conservez Production pour un projet Paysera normal, y compris pour les paiements de test. Par défaut : Production.
Avancé
Debug log: Log payment events. Les erreurs sont toujours journalisées. Les journaux se trouvent dans WooCommerce > Status > Logs, source wcp_paysera_payment. Les mots de passe et les données clients ne sont jamais écrits. Par défaut : désactivé.
Delete data: Delete the plugin settings and logs when the plugin is deleted. La désactivation du plugin ne supprime jamais rien. Les données de commande sont toujours conservées. Par défaut : désactivé.
Paiement
Le client choisit le moyen de paiement (par défaut Paysera) et passe la commande. Lorsque les paiements de test sont activés, la page de paiement affiche MODE TEST : aucun montant ne sera débité. Le plugin crée une requête de paiement signée avec le total de la commande dans l'unité minimale de la devise de la commande, le nom, l'adresse e-mail et l'adresse de facturation du client, ainsi qu'une langue choisie selon la langue de votre site (lituanien, letton, estonien, russe, allemand, polonais, sinon anglais). Le client est redirigé vers la fenêtre de paiement Paysera, où il choisit une banque, une carte ou un autre moyen.
Après le paiement, le client revient sur la page de commande reçue. La commande n'est marquée comme payée que lorsque le callback Paysera signé arrive ; le retour lui-même ne règle jamais une commande.
Si le client annule dans la fenêtre Paysera, la commande est annulée de la manière standard de WooCommerce, et le client peut repasser commande. Si le paiement ne peut pas être lancé, le client voit Les paiements Paysera sont temporairement indisponibles. Veuillez choisir un autre moyen de paiement. La raison est écrite dans le journal.
Le moyen de paiement fonctionne avec le paiement classique, le bloc Paiement et la page Pay for order. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).
Le plugin ne gère pas les remboursements depuis WooCommerce, ne propose pas de choix de banque ou de moyen de paiement sur la page de paiement, ni abonnements, ni cartes enregistrées, ni services de livraison ou de coursier Paysera.
Commandes
Statuts de commande
Pending payment: le client a été redirigé vers Paysera et le callback n'est pas encore arrivé.
Processing: Paysera a confirmé le paiement (statut 1). 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 la requête Paysera et le moyen de paiement. L'identifiant de transaction est l'identifiant de la requête Paysera.
On hold: Paysera a accepté l'ordre de paiement mais ne l'a pas encore exécuté (statut 2), et la commande est terminée lorsque Paysera confirme le paiement ; ou le montant ou la devise payés diffèrent de la commande (note amount/currency mismatch) ; ou un paiement de TEST a été reçu alors que les paiements de test étaient désactivés, donc aucun argent n'a été débité. La note de commande l'explique.
Cancelled: le client a annulé dans la fenêtre Paysera, ou la commande a été annulée par vous ou par le délai d'expiration de la réservation de stock. Un paiement confirmé plus tard pour une commande annulée ne modifie pas son statut : une note vous invite à rétablir la commande (la passer en Processing) ou à rembourser le paiement dans Paysera.
Les autres statuts Paysera (paiement non exécuté, informations complémentaires) ajoutent seulement une note. Si un autre paiement réussi arrive pour une commande déjà payée, la commande n'est pas modifiée, et une note vous invite à rembourser le doublon dans votre compte Paysera.
Remboursements
Les remboursements depuis WooCommerce ne sont pas pris en charge : le protocole de la fenêtre de paiement Paysera ne dispose d'aucune API de remboursement. Effectuez les remboursements dans votre compte Paysera. Lorsque Paysera signale un remboursement, une note indiquant le montant remboursé est ajoutée à la commande, et son statut ne change pas. Enregistrez le remboursement manuellement dans WooCommerce si nécessaire.
Clé de licence
Le plugin fonctionne avec une clé de licence VibeFox achetée sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Payments > Paysera. 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 sa place de domaine. Libérez-la dans votre compte vibefox.net.
Sans clé active, Paysera n'est pas affiché 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 moyen de paiement, marqué (unlicensed — visible to admins only), afin de pouvoir configurer et tester le plugin avant d'acheter une clé. Un rappel s'affiche sur la page des 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, le plugin 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
Paysera n'apparaît pas au moment du paiement : vérifiez que la licence est active, que Enable/Disable est activé et que Project ID et Project password sont saisis. La page des réglages affiche un avertissement tant que l'un des deux manque.
Le paiement a été effectué, mais la commande reste en Pending payment : la commande est payée par le callback Paysera, et non par le retour du client. Vérifiez que votre site est accessible depuis Internet à l'URL de callback affichée dans les réglages (pas derrière une connexion, un mode maintenance ou un pare-feu), puis consultez WooCommerce > Status > Logs, source wcp_paysera_payment.
Le callback répond Invalid signature : le Project password ne correspond pas au projet, ou le callback ne vient pas de Paysera. Copiez à nouveau le mot de passe du projet.
Le callback répond Project ID mismatch : le Project ID des réglages diffère du projet qui a effectué le paiement.
Le callback répond Gateway not configured ou Busy : l'identifiant ou le mot de passe du projet est vide, ou un autre callback pour la même commande est encore en cours. Paysera renouvelle le callback.
Paysera refuse la fenêtre de paiement ou indique que le projet n'existe pas : vérifiez Environment. Un projet Paysera normal ne fonctionne qu'avec Production ; Sandbox nécessite un projet créé dans l'environnement bac à sable de Paysera.
Le paiement de test ne règle pas la commande : un paiement de TEST ne règle une commande que tant que Test payments est activé. Sinon, la commande passe en attente avec une note indiquant qu'aucun argent n'a été débité. Activez aussi Allow test payments dans le projet Paysera.
Aucune icône au moment du paiement : le plugin n'affiche aucune icône par défaut. Les développeurs peuvent en définir une avec le filtre wc_psr_gateway_icon.
Une commande est On hold avec une note indiquant un écart de montant ou de devise : Paysera a confirmé un paiement dont le montant ou la devise diffère du total de la commande, par exemple parce que la commande a été modifiée après que le client a commencé à payer. Comparez le paiement dans votre compte Paysera, puis terminez ou remboursez la commande manuellement.
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 une place 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, le plugin continue de fonctionner avec le dernier statut connu.
Désinstallation
La désactivation du plugin conserve toutes les données. Pour le supprimer, désactivez-le puis supprimez-le sur la page Plugins. La clé de licence et le statut de licence de ce plugin 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.
Paysera est une marque commerciale de son titulaire respectif. Ce plugin n'est ni affilié à Paysera ni approuvé par Paysera.