VibeFox Hubtel for PrestaShop

Présentation

VibeFox Hubtel Pay Gateway ajoute à PrestaShop les paiements Hubtel au Ghana. À l'étape de paiement, le client choisit Hubtel, est redirigé vers la page sécurisée Hubtel Online Checkout, règle avec MTN MoMo, Telecel Cash, AirtelTigo Money, une carte Visa ou Mastercard ou GhQR, et revient dans votre boutique. La commande n'est créée qu'après la confirmation du paiement par Hubtel : les paiements abandonnés ne laissent donc aucune commande impayée.

Il 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 : tous les paiements sont donc réels. Le module ne prend pas en charge les remboursements depuis PrestaShop, ni les abonnements, ni les cartes enregistrées, ni le choix du canal de paiement dans la boutique.

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 son canal.

Payée uniquement après confirmation de Hubtel : les callbacks de Hubtel ne sont pas signés, le module ne leur fait donc jamais confiance. Il interroge la Transaction Status API authentifiée de Hubtel et ne marque la commande comme payée que lorsque Hubtel signale le paiement comme « Paid » pour le montant exact du panier en GHS.

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

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

Callbacks perdus gérés : le retour du client vérifie le paiement, une URL cron lance des vérifications en arrière-plan, et le gestionnaire de la boutique peut cliquer sur Check Hubtel payment status sur la page de la commande.

Aucun double traitement : chaque tentative de paiement possède sa propre référence. Les callbacks répétés ne créent jamais une seconde commande et ne rouvrent pas une commande annulée ou remboursée. Un second paiement pour un panier déjà payé est signalé pour remboursement.

Annulation chez Hubtel : le client revient au paiement avec un message et peut réessayer. Le panier est conservé.

Bloc Hubtel sur la page de la commande : toutes les tentatives de paiement de la commande avec leur statut et leur transaction Hubtel, ainsi que les notes Hubtel. Journal facultatif sans clés d'API ni données clients.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur avec l'extension cURL. Un compte professionnel Hubtel avec l'API ID, l'API Key et le numéro de compte marchand (POS Sales ID), et l'adresse IP de votre serveur inscrite sur liste blanche par Hubtel. Devise de la boutique : cedi ghanéen (GHS). Un cron serveur pour les vérifications en arrière-plan est recommandé. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).