VibeFox Hubtel for WooCommerce

Présentation

VibeFox Hubtel Pay Gateway ajoute à WooCommerce les paiements Hubtel au Ghana. Après avoir passé la commande, le client est redirigé vers la page sécurisée de Hubtel Online Checkout, règle avec MTN MoMo, Telecel Cash, AirtelTigo Money, une carte Visa ou Mastercard ou GhQR, et revient dans votre boutique.

Elle convient aux boutiques ghanéennes qui vendent en cedis ghanéens (GHS) et disposent d'un compte professionnel Hubtel. Hubtel doit inscrire sur liste blanche l'adresse IP de votre serveur web pour sa Transaction Status API, et Hubtel ne propose aucun environnement de test public, de sorte que tous les paiements sont réels. L'extension ne prend pas en charge les remboursements depuis WooCommerce, ni les abonnements, ni les cartes enregistrées, ni le choix du canal de paiement dans WooCommerce.

Principales fonctionnalités

Page de paiement hébergée par Hubtel : paiements par Mobile Money et par carte sur la page de Hubtel. Le client y choisit directement son canal.

Payée seulement après confirmation de Hubtel : les callbacks de Hubtel ne sont pas signés, l'extension ne leur fait donc jamais confiance. Elle interroge la Transaction Status API authentifiée de Hubtel et ne marque la commande comme payée que lorsque Hubtel la signale comme payée pour le montant total exact de la commande en GHS.

Contrôle du montant : un montant différent place la commande en attente avec une note pour le gestionnaire de la boutique.

Rien à configurer chez Hubtel : l'URL de callback est transmise avec chaque paiement.

Gestion des callbacks perdus : le retour du client vérifie le paiement, des vérifications en arrière-plan le contrôlent à nouveau, et le gestionnaire de la boutique peut exécuter Check Hubtel payment status depuis les actions de commande.

Aucun double traitement : chaque tentative de paiement dispose de sa propre référence. Des callbacks répétés ne complètent jamais une commande deux fois et ne rouvrent pas une commande annulée ou remboursée. Un second paiement pour une commande déjà payée est signalé pour remboursement.

Annulation sur Hubtel : le client revient sur la page Pay for order avec un message d'information et peut faire une nouvelle tentative.

WooCommerce moderne : paiement classique, bloc Paiement, page Pay for order et HPOS. Journal sans clés d'API ni données clients.

Prérequis

WordPress 6.2 ou ultérieur, WooCommerce 8.0 ou ultérieur, PHP 8.0 ou ultérieur. Un compte professionnel Hubtel avec l'API ID, l'API Key et le numéro de compte marchand (POS Sales ID), ainsi que l'adresse IP de votre serveur inscrite sur liste blanche par Hubtel. Devise de la boutique : cedi ghanéen (GHS). Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).