VibeFox Hubtel for OpenCart

Présentation

VibeFox Hubtel Pay Gateway ajoute à OpenCart 3 et OpenCart 4 les paiements Hubtel au Ghana. À la dernière étape de la commande, le client clique sur Confirm Order, est redirigé vers la page sécurisée Hubtel Online Checkout, paie avec MTN MoMo, Telecel Cash, AirtelTigo Money, une carte Visa ou Mastercard ou GhQR, puis revient dans votre boutique. OpenCart crée la commande avant le paiement, mais la commande ne reçoit un statut qu'une fois Hubtel le paiement confirmé ; les tentatives non payées restent donc des commandes manquantes.

Elle convient aux boutiques ghanéennes qui vendent en cedis ghanéens (GHS) et disposent d'un compte professionnel Hubtel. Hubtel doit ajouter à sa liste blanche l'adresse IP de votre serveur web pour son API de statut des transactions, et Hubtel ne dispose pas d'environnement de test public : tous les paiements sont donc réels. L'extension ne propose ni remboursements depuis OpenCart, ni abonnements, ni cartes enregistrées, ni choix du canal de paiement dans la boutique.

Principales fonctionnalités

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

Payée seulement après confirmation de Hubtel : les callbacks Hubtel ne sont pas signés, l'extension ne leur fait donc jamais confiance. Elle interroge l'API authentifiée de statut des transactions de Hubtel et ne marque la commande comme payée que si Hubtel indique le paiement comme Paid pour le montant exact de la commande en GHS. OpenCart envoie ensuite ses e-mails de commande habituels.

Contrôle du montant : un montant différent place la commande dans un statut de vérification de votre choix, avec une note.

Aucune configuration chez Hubtel : l'URL de callback est transmise avec chaque paiement.

Callbacks perdus pris en charge : le retour du client vérifie le paiement, une URL de cron lance des vérifications en arrière-plan, et vous pouvez cliquer sur Check Hubtel payment status dans la page de la commande.

Aucun traitement en double : chaque tentative de paiement a sa propre référence. Les callbacks répétés n'appliquent jamais un paiement deux fois et ne rouvrent jamais une commande annulée. Avant une nouvelle tentative, les tentatives précédentes non confirmées du même panier sont vérifiées auprès de Hubtel, et un second paiement d'une commande déjà payée est signalé pour remboursement.

Onglet 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.

Conditions OpenCart : zone géographique, montant minimum de commande, ordre de tri et vos propres statuts de commande. Journal facultatif sans clés API ni données clients.

Prérequis

OpenCart 3.0.x (testé avec 3.0.5.0) ou OpenCart 4.0.2 et ultérieur (testé avec 4.1.0.3), PHP 8.0 ou ultérieur avec l'extension cURL. Un seul téléchargement contient les paquets des deux versions. Un compte professionnel Hubtel avec API ID, API Key et numéro de compte marchand (POS Sales ID), et l'adresse IP de votre serveur ajoutée à la liste blanche par Hubtel. Devise de la commande : cedi ghanéen (GHS). Un cron serveur est recommandé pour les vérifications en arrière-plan. Une clé de licence VibeFox obtenue sur vibefox.net (une clé par domaine).