VibeFox Barion for WooCommerce — Aide

Prérequis

WordPress: 6.0 ou ultérieur.

WooCommerce: 7.0 ou ultérieur, installé et activé. Sans WooCommerce, l'extension affiche un avertissement dans l'administration et le moyen de paiement n'est pas chargé.

PHP: 8.0 ou ultérieur.

Boutique Barion : vous avez besoin de la POSKey (clé secrète) de votre boutique et de l'adresse e-mail du portefeuille Barion qui reçoit les paiements. Les deux se trouvent dans le portail Barion : secure.barion.com pour la production, secure.test.barion.com pour le test, sous My stores puis votre boutique. Le test et la production ont des identifiants différents.

Devise : la devise de la boutique doit être HUF, EUR, USD ou CZK. Pour les autres devises, le moyen de paiement est masqué au paiement.

Boutique accessible : Barion appelle votre boutique après chaque paiement. Le site doit donc être joignable depuis Internet, sans mode maintenance, pare-feu ni authentification de base devant /wc-api/.

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

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Payments > Barion > 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 la POSKey de test et l'e-mail du portefeuille de test, gardez Test Mode activé et activez Enable/Disable. Passez une commande de test.

6. Lorsque tout fonctionne, saisissez les identifiants de production et décochez Test Mode.

L'URL de callback est envoyée automatiquement à Barion à chaque paiement. Rien n'a besoin d'être configuré dans le portail Barion.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Payments > Barion. Si la devise de la boutique n'est pas prise en charge, la page le signale en rouge dans la section Barion shop credentials et affiche la liste des devises prises en charge ; le moyen de paiement est alors masqué au paiement.

Général

Enable/Disable: Enable Barion 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 au paiement. Par défaut : Barion.

Description: le texte affiché sous le moyen de paiement au paiement. Par défaut : Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.

Identifiants de la boutique Barion

Récupérez votre POSKey et l'e-mail de votre portefeuille dans le portail Barion : secure.barion.com (production) ou secure.test.barion.com (test), My stores, puis votre boutique. Cette section affiche aussi l'URL de callback, par exemple https://your-site/wc-api/barion_payment_callback/. Elle est envoyée à Barion à chaque paiement ; elle doit seulement être joignable depuis Internet.

Test Mode: Enable Barion test/sandbox mode. Le mode test utilise les identifiants de test ci-dessous et le sandbox Barion (api.test.barion.com) ; aucun argent réel n'est débité. Par défaut : activé. Décochez-le pour recevoir de vrais paiements.

Test POSKey: la clé secrète (POSKey) de votre boutique dans le système de test Barion (secure.test.barion.com, My stores).

Test Payee Email: l'adresse e-mail de votre portefeuille Barion de test qui reçoit les paiements de test.

Live POSKey: la clé secrète (POSKey) de votre boutique dans le système de production Barion (secure.barion.com, My stores).

Live Payee Email: l'adresse e-mail de votre portefeuille Barion qui reçoit les paiements.

Commandes

Order Status After Payment: le statut de commande défini après un paiement réussi et vérifié.

Avancé

Logging: Enable debug logging. Les journaux sont enregistrés dans WooCommerce > Status > Logs, source wcp_barion_gateway. Les POSKey ne sont jamais journalisées. Par défaut : désactivé.

Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted. Les commandes et leurs données de paiement Barion sont toujours conservées. Par défaut : désactivé.

Fonctionnement au paiement

Le client choisit le moyen de paiement (par défaut Barion) et passe sa commande. L'extension lance un paiement Barion pour le total de la commande, dans la devise de la commande, et envoie le client vers la page de paiement Barion. Les articles, la livraison, les frais et la taxe sont listés sur le paiement ; l'e-mail de facturation du client est transmis à titre indicatif, et la langue de la page suit celle de la boutique lorsque Barion la prend en charge.

Après le paiement, le client revient dans votre boutique. Barion appelle aussi l'URL de callback. Aucune de ces deux requêtes ne marque la commande comme payée à elle seule : l'extension demande à Barion l'état du paiement avec votre POSKey, et la commande n'est marquée payée qu'une fois que Barion le confirme et que le montant et la devise correspondent à la commande. Le lien de retour contient la clé de commande, et seuls les paiements lancés pour cette commande sont vérifiés.

Si le paiement a réussi ou est toujours en cours chez Barion, le client arrive sur la page de confirmation de commande. Sinon, il revient au paiement et voit Payment was not completed. Please try again. Le client peut réessayer ; chaque tentative est mémorisée, de sorte qu'un paiement tardif d'une tentative antérieure finalise tout de même la commande.

Si le paiement ne peut pas être lancé, le client voit The Barion payment could not be started. Please try again or choose another payment method. Les gestionnaires connectés de la boutique voient aussi la raison technique. Les détails sont enregistrés dans le journal.

Le moyen de paiement fonctionne avec le paiement classique et avec le bloc Paiement. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

L'extension ne gère que les paiements immédiats. Elle ne prend pas en charge les paiements avec réservation ou capture différée, ni WooCommerce Subscriptions ou les paiements récurrents, ni les cartes enregistrées, ni Barion Pixel, ni de données 3-D Secure supplémentaires : Barion gère le 3-D Secure sur sa page de paiement.

Commandes et remboursements

Statuts de commande

Pending payment: le paiement Barion a été lancé et Barion ne l'a pas encore confirmé. La note de commande indique le PaymentId Barion, le montant et, en mode test, (test mode).

Processing or Completed: Barion a confirmé le paiement. Le statut suit Order Status After Payment. La note de commande indique le montant, le PaymentId et la transaction. L'identifiant de transaction est l'identifiant de transaction Barion.

On hold: Barion a signalé un montant ou une devise différent du total de la commande, par exemple parce que la commande a été modifiée après le lancement du paiement. Vérifiez le paiement dans le portail Barion, puis finalisez ou remboursez la commande manuellement.

Cancelled: la dernière tentative de paiement a été annulée ou a expiré chez Barion.

Failed: la dernière tentative de paiement a échoué.

Une commande payée ou remboursée n'est jamais modifiée par un callback ultérieur. Si un autre paiement réussit pour une commande payée, une note vous invite à le vérifier dans le portail Barion et à le rembourser s'il s'agit d'un doublon.

Remboursements

Ouvrez la commande, cliquez sur Refund, saisissez le montant et cliquez sur Refund via Barion. Les remboursements totaux et partiels sont pris en charge. Le motif du remboursement est envoyé à Barion sous forme de commentaire. Les remboursements en HUF doivent être des montants entiers. Le remboursement est envoyé dans le mode (test ou production) dans lequel la commande a été payée ; la POSKey de ce mode doit donc être renseignée. Si Barion n'accepte pas ou ne confirme pas le remboursement, WooCommerce affiche l'erreur et aucun remboursement n'est enregistré. Un remboursement réussi est ajouté aux notes de commande, avec la transaction et le statut Barion.

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 > Barion. 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, Barion 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

Barion n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le mode en cours dispose d'une POSKey et d'un e-mail de bénéficiaire, et que la devise de la boutique est HUF, EUR, USD ou CZK.

Le paiement a été effectué, mais la commande reste « En attente de paiement » : la commande est finalisée lorsque Barion appelle l'URL de callback ou lorsque le client revient dans votre boutique. Assurez-vous que le site est joignable depuis Internet (pas de mode maintenance, de pare-feu ni d'authentification de base devant /wc-api/). Vérifiez que la POSKey du mode dans lequel la commande a été payée est correcte, car l'extension l'utilise pour demander l'état du paiement à Barion. Activez Logging pour voir le callback.

Le callback répond « Busy, retry » : la commande était déjà en cours de traitement au moment du retour du client. Barion rappelle l'URL.

Le callback répond « API error » : la boutique n'a pas pu lire l'état du paiement chez Barion. Vérifiez la POSKey du mode dans lequel la commande a été payée.

Une commande est « On hold » avec une note d'écart : le montant ou la devise indiqués par Barion diffèrent du total de la commande. Vérifiez le paiement dans le portail Barion, puis finalisez-le ou remboursez-le manuellement.

Pourquoi ne puis-je pas rembourser 10,50 HUF ? Barion traite le HUF sans décimales. Saisissez un montant entier.

Le remboursement indique que la POSKey du mode de cette commande n'est pas configurée : la commande a été payée en mode test ou production, et la POSKey de ce mode est vide. Saisissez-la, puis 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é 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 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 de paiement Barion sont toujours conservées. Les commandes existantes conservent leurs notes de paiement et leurs identifiants de transaction.

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