VibeFox Hubtel for OpenCart

Übersicht

VibeFox Hubtel Pay Gateway ergänzt OpenCart 3 und OpenCart 4 um Hubtel-Zahlungen in Ghana. Im letzten Schritt des Kaufs klickt der Kunde auf Confirm Order, wird zur sicheren Hubtel Online Checkout-Seite weitergeleitet, bezahlt mit MTN MoMo, Telecel Cash, AirtelTigo Money, einer Visa- oder Mastercard-Karte oder GhQR und kehrt in Ihren Shop zurück. OpenCart legt die Bestellung vor der Zahlung an, aber die Bestellung erhält erst dann einen Status, wenn Hubtel die Zahlung bestätigt. Nicht bezahlte Versuche bleiben daher fehlende Bestellungen.

Sie eignet sich für ghanaische Shops, die in Ghana-Cedi (GHS) verkaufen und ein Hubtel-Geschäftskonto haben. Hubtel muss die IP-Adresse Ihres Webservers für seine Transaction Status API auf die Whitelist setzen. Da Hubtel keine öffentliche Testumgebung hat, sind alle Zahlungen echt. Die Erweiterung bietet keine Erstattungen aus OpenCart, keine Abonnements, keine gespeicherten Karten und keine Auswahl des Zahlungskanals im Shop.

Hauptfunktionen

Gehostete Hubtel-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 die Erweiterung ihnen nie. Sie fragt die authentifizierte Transaction Status API von Hubtel ab und markiert die Bestellung nur dann als bezahlt, wenn Hubtel sie für den genauen Bestellbetrag in GHS als Paid meldet. Danach sendet OpenCart seine üblichen Bestell-E-Mails.

Betragsprüfung: Ein abweichender Betrag setzt die Bestellung in einen Prüfstatus Ihrer Wahl, mit einer Notiz.

Bei Hubtel ist nichts einzurichten: Die Callback-URL wird bei jeder Zahlung übermittelt.

Verlorene Callbacks abgedeckt: Die Rückkehr des Kunden prüft die Zahlung, eine Cron-URL führt Hintergrundprüfungen aus, und auf der Bestellseite können Sie auf Check Hubtel payment status klicken.

Keine doppelte Verarbeitung: Jeder Zahlungsversuch hat seine eigene Referenz. Wiederholte Callbacks wenden eine Zahlung nie zweimal an und öffnen keine stornierte Bestellung erneut. Vor einem neuen Versuch werden frühere unbestätigte Versuche desselben Warenkorbs bei Hubtel geprüft, und eine zweite Zahlung für eine bereits bezahlte Bestellung wird zur Erstattung markiert.

Hubtel-Reiter auf der Bestellseite: alle Zahlungsversuche der Bestellung mit ihrem Hubtel-Status und ihrer Transaktion sowie die Hubtel-Notizen.

OpenCart-Bedingungen: Geozone, minimaler Bestellbetrag, Sortierreihenfolge und Ihre eigenen Bestellstatus. Optionales Protokoll ohne API-Schlüssel oder Kundendaten.

Anforderungen

OpenCart 3.0.x (getestet mit 3.0.5.0) oder OpenCart 4.0.2 und neuer (getestet mit 4.1.0.3), PHP 8.0 oder neuer mit der cURL-Erweiterung. Ein Download enthält die Pakete für beide Versionen. Ein Hubtel-Geschäftskonto mit API ID, API Key und Händlerkontonummer (POS Sales ID), und die IP-Adresse Ihres Servers ist bei Hubtel auf der Whitelist. Bestellwährung Ghana-Cedi (GHS). Für die Hintergrundprüfungen wird ein Server-Cron empfohlen. Ein VibeFox-Lizenzschlüssel von vibefox.net (ein Schlüssel pro Domain).