VibeFox Hubtel for PrestaShop

Übersicht

VibeFox Hubtel Pay Gateway ergänzt PrestaShop um Hubtel-Zahlungen in Ghana. Im Zahlungsschritt wählt der Kunde Hubtel, wird auf die sichere Hubtel Online Checkout-Seite weitergeleitet, zahlt mit MTN MoMo, Telecel Cash, AirtelTigo Money, einer Visa- oder Mastercard-Karte oder GhQR und kehrt in Ihren Shop zurück. Die Bestellung wird erst angelegt, nachdem Hubtel die Zahlung bestätigt hat, sodass abgebrochene Zahlungen keine unbezahlten Bestellungen hinterlassen.

Das Modul eignet sich für ghanaische Shops, die in Ghana-Cedi (GHS) verkaufen und über ein Hubtel-Geschäftskonto verfügen. Hubtel muss die IP-Adresse Ihres Webservers für seine Transaction Status API freischalten, und Hubtel bietet keine öffentliche Testumgebung, sodass alle Zahlungen echt sind. Das Modul unterstützt keine Erstattungen aus PrestaShop, keine Abonnements, keine gespeicherten Karten und keine Auswahl des Zahlungskanals innerhalb des Shops.

Hauptfunktionen

Von Hubtel gehostete Kasse: Mobile-Money- und Kartenzahlungen auf der Hubtel-Seite. Der Kunde wählt dort den Kanal.

Nur bezahlt, wenn Hubtel bestätigt: Hubtel-Callbacks sind nicht signiert, daher vertraut das Modul ihnen nie. Es fragt die authentifizierte Hubtel Transaction Status API ab und legt die Bestellung nur dann als bezahlt an, wenn Hubtel die Zahlung als Paid mit genau dem Warenkorbbetrag in GHS meldet.

Betragsprüfung: Ein abweichender Betrag setzt die Bestellung auf Hubtel payment on hold mit einer Notiz für den Shop-Manager.

Keine Einrichtung bei Hubtel nötig: Die Callback-URL wird mit jeder Zahlung übermittelt.

Verlorene Callbacks abgesichert: Die Rückkehr des Kunden prüft die Zahlung, eine Cron-URL führt Hintergrundprüfungen aus, und der Shop-Manager kann auf der Bestellseite auf Check Hubtel payment status klicken.

Keine doppelte Verarbeitung: Jeder Zahlungsversuch hat eine eigene Referenz. Wiederholte Callbacks erzeugen nie eine zweite Bestellung und öffnen keine stornierte oder erstattete Bestellung erneut. Eine zweite Zahlung für einen bereits bezahlten Warenkorb wird zur Erstattung markiert.

Abbruch bei Hubtel: Der Kunde kehrt mit einer Meldung zur Kasse zurück und kann es erneut versuchen. Der Warenkorb bleibt erhalten.

Hubtel-Block auf der Bestellseite: alle Zahlungsversuche der Bestellung mit ihrem Hubtel-Status und ihrer Transaktion sowie die Hubtel-Notizen. Optionales Protokoll ohne API-Schlüssel oder Kundendaten.

Anforderungen

PrestaShop 8.0 bis 9.x, PHP 8.0 oder neuer mit der cURL-Erweiterung. Ein Hubtel-Geschäftskonto mit API ID, API Key und Händlerkontonummer (POS Sales ID) sowie eine von Hubtel freigeschaltete Server-IP. Shopwährung Ghana-Cedi (GHS). Ein Cron auf dem Server für die Hintergrundprüfungen wird empfohlen. Ein VibeFox-Lizenzschlüssel von vibefox.net (ein Schlüssel pro Domain).