VibeFox Hubtel for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer mit der cURL-Erweiterung.

Währung: nur Ghana-Cedi (GHS). Die Zahlungsart wird auf der Kasse ausgeblendet, wenn die Bestellwährung nicht GHS ist. Behalten Sie für die Währung GHS 2 Nachkommastellen bei, weil Hubtel ganze Pesewa belastet.

Hubtel-Konto: ein Hubtel-Geschäftskonto mit API-Schlüsseln (API ID und API Key) und der Händlerkontonummer (POS Sales ID). Die Schlüssel finden Sie im Hubtel-Geschäftsdashboard unter bo.hubtel.com unter Programmable keys.

IP-Whitelist: Hubtel beantwortet seine Transaction Status API nur von auf der Whitelist stehenden Server-IP-Adressen. Bitten Sie Hubtel (Ihren Kundenbetreuer oder support@hubtel.com), die öffentliche IP-Adresse Ihres Webservers auf die Whitelist zu setzen. Bis dahin können Zahlungen nicht bestätigt werden, und Bestellungen bleiben ohne Status.

Keine Testumgebung: Hubtel hat keine öffentliche Sandbox. Alle Zahlungen sind echt.

Cron: Für die Hintergrundprüfung der Zahlungen wird ein Cron-Job auf Ihrem Server empfohlen, der die Cron-URL der Erweiterung alle 5 Minuten aufruft (siehe Configuration).

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_hubtel_pay-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_hubtel_pay.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_hubtel_pay-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Hubtel Pay Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe License key).

4. Geben Sie die API ID, den API Key und die Händlerkontonummer (POS Sales ID) ein.

5. Bitten Sie den Hubtel-Support, Ihre Server-IP für die Transaction Status API auf die Whitelist zu setzen.

6. Fügen Sie die im Abschnitt Payment confirmation angezeigte Cron-URL dem Cron-Job Ihres Servers hinzu.

7. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Die Callback-URL wird bei jeder Zahlung an Hubtel übermittelt, daher muss im Hubtel-Dashboard nichts eingerichtet werden.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_hubtel_pay.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Hubtel Pay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Hubtel-Zugangsdaten und den Cron wie in den Schritten 3 bis 7 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Callback-URL und die Cron-URL unterscheiden sich (siehe Payment confirmation).

Eine Neuinstallation startet mit deaktivierter Zahlungsart.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Hubtel Pay Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn API ID, API Key oder Händlerkontonummer fehlen, und wenn die Standardwährung des Shops nicht GHS ist. In beiden Fällen wird Hubtel auf der Kasse ausgeblendet. Außerdem warnt die Seite, wenn die Währung GHS mehr als 2 Nachkommastellen verwendet (stellen Sie dies unter System > Localisation > Currencies ein). Ohne das Recht zum Ändern der Erweiterung zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und höchstens 128 Zeichen lang sein (Enter a title for the payment method (1 to 128 characters).), Sort Order muss eine ganze Zahl sein, Total eine Zahl größer oder gleich 0, und die Geo Zone sowie die Bestellstatus müssen existieren; andernfalls wird nichts gespeichert. Wird die Zahlungsart ohne Zugangsdaten eingeschaltet, werden die Einstellungen mit einer Warnung gespeichert.

Hubtel

Enable/Disable: Enable Hubtel payments schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den der Kunde auf der Kasse sieht. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Mobile Money or card (Hubtel). Pflichtfeld.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche neben dem Symbol für Mobile Money und Karten sieht. Standard: Pay with MTN MoMo, Telecel Cash, AirtelTigo Money or a Visa/Mastercard card. You will be redirected to Hubtel to complete the payment.

Sort Order: die Position von Hubtel unter den Zahlungsarten auf der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: Hubtel nur für Zahlungsadressen in der gewählten Geo Zone anbieten. Standard: All zones. Geo Zones richten Sie unter System > Localisation > Geo Zones ein.

Total: der Kassenbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Hubtel angeboten wird. Lassen Sie das Feld leer, wenn es kein Minimum geben soll.

Hubtel-API-Zugangsdaten

Kopieren Sie API ID und API Key aus Ihrem Hubtel-Geschäftsdashboard: bo.hubtel.com > Programmable keys (der Abschnitt verlinkt dorthin). Die Händlerkontonummer ist die POS Sales ID Ihres Hubtel-Kontos. Der Abschnitt wiederholt außerdem den Hinweis zur IP-Whitelist.

API ID (Client ID): die API ID Ihrer Hubtel Programmable keys.

API Key (Client Secret): der API Key Ihrer Hubtel Programmable keys. Halten Sie ihn geheim. Der gespeicherte Schlüssel wird nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten. Um den gespeicherten Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear saved API Key und klicken Sie auf Save.

Händlerkontonummer (POS Sales ID): Zahlungen werden auf dieses Hubtel-Konto eingezogen und damit abgeglichen.

Zahlungsbestätigung

Callback URL: der Callback teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Diese URL wird bei jeder Zahlung an Hubtel übermittelt, daher muss im Hubtel-Dashboard nichts eingerichtet werden. In OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_hubtel_pay/callback, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_hubtel_pay/payment/wcp_hubtel_pay.callback. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Sie muss aus dem Internet erreichbar sein: kein Passwortschutz und keine Firewall, die Hubtel blockiert. Der Callback funktioniert auch, während sich der Shop im Wartungsmodus befindet: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und in OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die den Callback, die Cron-URL und die Rückkehr des Kunden von Hubtel durchlässt.

Hubtel-Callbacks sind nicht signiert. Die Erweiterung übernimmt aus einem Callback nur die Zahlungsreferenz; die Referenz muss zu einer Zahlung Ihres Shops gehören. Status, Betrag und Transaktions-ID stammen immer aus der Transaction Status API von Hubtel. Die Bestellung wird erst als bezahlt markiert, nachdem diese API die Zahlung und ihren Betrag bestätigt hat.

Hintergrundprüfung der Zahlungen (Cron): die Cron-URL mit einem geheimen Token, die bei der Installation der Erweiterung erzeugt wird. Rufen Sie sie alle 5 Minuten über den Cron-Job Ihres Servers auf, zum Beispiel mit curl. Zahlungen ohne Bestätigung werden dann automatisch erneut bei Hubtel geprüft: 20 Minuten nachdem der Kunde zu Hubtel weitergeleitet wurde, noch einmal nach einer Stunde, falls die Zahlung weiterhin offen ist, und bis zu 5 Mal mit wachsenden Abständen, wenn Hubtel nicht erreichbar war. In OpenCart 4 hat die Cron-URL die Route extension/wcp_hubtel_pay/payment/wcp_hubtel_pay.cron statt extension/payment/wcp_hubtel_pay/cron; kopieren Sie sie genau so, wie die Einstellungen sie anzeigen. Halten Sie die URL geheim. Die URL antwortet mit einer kurzen Zeile wie OK checked=0.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Hubtel die Zahlung bestätigt hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order status after payment: der Status, der gesetzt wird, nachdem Hubtel die Zahlung des exakten Bestellbetrags in GHS bestätigt hat. Standard: In Bearbeitung.

Hubtel payment on hold status: der Status, der gesetzt wird, wenn Hubtel einen bezahlten Betrag meldet, der vom Bestellbetrag abweicht, oder wenn die Bestellung nicht in GHS erfolgt. Eine Notiz im Bestellverlauf erklärt dies. Standard: Ausstehend, weil OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Erweitert

Debug log: protokolliert API-Aufrufe und Callbacks in hubtel_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Browser öffnen; bei 5 MB wird sie nach hubtel_p_debug.old.log.php verschoben. Schlüssel und Kundendaten werden nicht protokolliert. Fehler und Warnungen werden immer protokolliert, auch wenn diese Option aus ist. Standard: aus.

Log: zeigt die aktuelle Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete data on uninstall: wenn an, entfernt das Deinstallieren der Erweiterung deren Einstellungen und Protokoll. Die für Bestellungen gespeicherten Hubtel-Zahlungsversuche bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Der API Key wird nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Der gespeicherte API Key bleibt erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Mobile Money or card (Hubtel)). Im Schritt Confirm Order sieht der Kunde das Symbol und Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung einen Hubtel-Checkout für den Bestellbetrag in GHS und leitet den Kunden auf die Zahlungsseite von Hubtel weiter. Dort erscheint die Zahlung als Order #, mit der Bestellnummer und dem Namen Ihres Shops. Auf der Hubtel-Seite zahlt der Kunde mit MTN MoMo, Telecel Cash, AirtelTigo Money, einer Visa- oder Mastercard oder mit GhQR. Jeder Klick auf Confirm Order erzeugt einen neuen Zahlungsversuch mit eigener Referenz, und ältere Hubtel-Seiten bleiben zahlbar.

In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Hubtel sie über die Transaction Status API bestätigt: durch den Callback, durch die Prüfung bei der Rückkehr des Kunden, durch eine Hintergrundprüfung oder durch die Schaltfläche auf der Bestellseite. Ein Callback und eine Rückkehr, die im selben Moment eintreffen, werden nacheinander verarbeitet, sodass die Zahlung niemals doppelt verbucht wird. Die Bestellung erhält dann ihren Status auf die übliche OpenCart-Art, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Wurde die Bestellung in die Prüfung gestellt, zeigt die Seite Your Hubtel payment was received and is being reviewed by the store. We will contact you if anything is needed.

Hat Hubtel die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, zeigt eine Seite Payment confirmation den Text We are waiting for Hubtel to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. mit den Schaltflächen Check again und Back to checkout. Die Bestellung erhält ihren Status, sobald Hubtel die Zahlung bestätigt. Hat Hubtel diesen Zahlungsversuch bereits als fehlgeschlagen gemeldet, kehrt der Kunde mit The Hubtel payment was not completed. You can try again or choose another payment method. zur Kasse zurück. Der Warenkorb bleibt erhalten, und die Bestellung bleibt ohne Status.

Drückt der Kunde auf der Hubtel-Seite auf Cancel, prüft die Erweiterung zuerst, ob die Zahlung trotzdem erfolgt ist. Falls nicht, kehrt der Kunde mit The Hubtel payment was cancelled. You can try again or choose another payment method. zur Kasse zurück. Der Warenkorb bleibt erhalten. Eine spätere Zahlung über die abgebrochene Hubtel-Seite wird trotzdem akzeptiert.

In OpenCart 4 werden Meldungen über eine abgebrochene oder fehlgeschlagene Zahlung über der Kassenseite angezeigt. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse, sodass der Kunde nach einem Abbruch oder einer fehlgeschlagenen Zahlung dieselbe Bestellung mit einem neuen Zahlungsversuch bezahlt. Vor einem neuen Versuch fragt die Erweiterung bei Hubtel die unbestätigten Versuche dieser Bestellung und früherer Bestellungen desselben Warenkorbs ab (letzte 24 Stunden). Stellt sich heraus, dass einer davon bezahlt wurde, wird diese Zahlung übernommen, und der Kunde gelangt zur Erfolgsseite, statt doppelt zu zahlen. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel haben Sie sie storniert), kehrt der Kunde mit The Hubtel payment was not completed. You can try again or choose another payment method. zur Kasse zurück, und das nächste Confirm Order bezahlt eine neue Bestellung. Ist die Bestellung bereits bezahlt und der Warenkorb enthält nun einen neuen Einkauf, lädt Confirm Order die Kassenseite neu, und das nächste Confirm Order bezahlt eine neue Bestellung. Eine bezahlte Bestellung wird für einen anderen Warenkorb nie als bezahlt angezeigt.

Kann Hubtel die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel Could not connect to Hubtel. Please try again in a moment., Hubtel could not start the payment. Please try again or choose another payment method. oder bei falschen Zugangsdaten Hubtel payments are not available at the moment. Please choose another payment method. Die Details gehen in das Protokoll.

Die Erweiterung bietet keine Erstattungen aus OpenCart, keine Abonnements, keine gespeicherten Karten und keine Auswahl des Zahlungskanals innerhalb des Shops.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): der Kunde wurde zu Hubtel weitergeleitet und hat nicht bezahlt, oder Hubtel hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order status after payment (Standard In Bearbeitung): die Zahlung wurde für den exakten Bestellbetrag in GHS bestätigt. Eine Notiz zeigt den Betrag, die Hubtel-Transaktion, die Zahlungsart und die Referenz.

Hubtel payment on hold status (Standard Ausstehend): Hubtel hat einen bezahlten Betrag gemeldet, der vom Bestellbetrag abweicht, oder die Bestellung ist nicht in GHS. Die Bestellung wurde nicht als bezahlt markiert, und eine Notiz erklärt die Abweichung. Prüfen Sie die Zahlung im Hubtel-Dashboard und führen Sie die Bestellung aus oder erstatten Sie sie manuell. Wird später ein weiterer Versuch derselben Bestellung in der richtigen Höhe bezahlt, wechselt die Bestellung in den Status Order status after payment.

Wird ein weiterer Versuch einer bereits bezahlten Bestellung ebenfalls bezahlt oder eine andere Bestellung eines bereits bezahlten Warenkorbs, bleibt die bezahlte Bestellung unverändert. Eine Notiz fordert Sie auf, das Duplikat im Hubtel-Dashboard zu erstatten. Eine Zahlung zu einer Bestellung, die Sie in einen anderen Status (zum Beispiel storniert) versetzt haben, fügt eine Notiz hinzu; die Bestellung wird niemals automatisch wieder geöffnet. Meldet Hubtel eine Zahlung als erstattet, wird der Bestellung eine Notiz hinzugefügt.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Reiter VibeFox Hubtel Pay Gateway

Öffnen Sie unter Sales > Orders eine mit Hubtel bezahlte Bestellung. Am unteren Ende der Bestellseite, neben History und Additional, listet der Reiter VibeFox Hubtel Pay Gateway die Hubtel payment attempts der Bestellung auf: Datum, Referenz und Hubtel-Checkout, Betrag, Hubtel-Status, Transaktion und Ergebnis. Darunter werden die Hubtel notes der Bestellung aufgelistet, die neuesten zuerst. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Die Schaltfläche Check Hubtel payment status prüft die neuesten Versuche der Bestellung (bis zu 5, die neuesten zuerst, und stoppt, sobald die Bestellung bezahlt ist), übernimmt das Ergebnis und fügt eine Notiz mit dem Status jedes Versuchs hinzu. Das Ergebnis wird im Reiter angezeigt. Sie benötigen das Recht, Bestellungen zu ändern (Sales > Orders, eingestellt unter System > Users > User Groups). Die Schaltfläche funktioniert auch bei einer Bestellung ohne Status. Ein über diese Schaltfläche gesetzter Status wird direkt geschrieben, ohne Bestell-E-Mails oder Bestandsaktualisierung; Callback, Rückkehr des Kunden und Cron setzen ihn auf die übliche Weise.

Erstattungen

Erstattungen aus OpenCart werden nicht unterstützt. Erstatten Sie die Zahlung im Hubtel-Dashboard und erfassen Sie die Erstattung anschließend in OpenCart. Produktrücksendungen unter Sales > Returns zahlen über Hubtel kein Geld zurück.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Hubtel Pay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Hubtel Pay Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-hubtel und der Link Manage licenses and domains in your account, der Ihr Konto auf vibefox.net öffnet. Nur Admin-Benutzer mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Admin-Bereichs (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Hubtel Kunden auf der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im selben Browser im Admin-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, gekennzeichnet mit (unlicensed — visible to admins only), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen bleiben unberührt: bereits begonnene Zahlungen werden weiterhin bestätigt, auch durch die Hintergrundprüfungen.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern aber eine Verlängerung. Der Status wird beim Öffnen des Dashboard oder der Seite Edit im Admin-Bereich automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Für die Lizenzprüfung ist kein Cron-Job nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Hubtel erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, API ID, API Key und Händlerkontonummer ausgefüllt sind und die Bestellwährung GHS ist. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht. Die Einstellungsseite zeigt eine Warnung, wenn die Zugangsdaten oder die Währung falsch sind.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: die Zahlung konnte nicht bestätigt werden. Schalten Sie das Debug log ein und sehen Sie sich das Feld Log auf der Seite der Erweiterung an. HTTP 401 oder 403 bei der Statusprüfung bedeutet, dass die API-Schlüssel falsch sind oder die Server-IP von Hubtel nicht auf die Whitelist gesetzt wurde. Prüfen Sie außerdem, ob die Callback-URL aus dem Internet erreichbar ist und ob die Cron-URL aufgerufen wird. Sobald Hubtel antwortet, setzt der nächste Callback, die Hintergrundprüfung, die Rückkehr des Kunden oder Check Hubtel payment status den Bestellstatus.

Der Callback antwortet Unknown reference: die Zahlungsreferenz gehört nicht zu einer Zahlung dieses Shops.

Der Callback antwortet Payment status unavailable: die Transaction Status API war nicht erreichbar oder hat die Anfrage abgelehnt, oder der Warenkorb wurde im selben Moment durch eine andere Anfrage bestätigt. Die Zahlung wird nach 5 Minuten im Hintergrund erneut geprüft.

Der Callback antwortet Gateway not configured: API ID, API Key oder Händlerkontonummer fehlen. Ergänzen Sie sie; die Zahlung wird im Hintergrund erneut geprüft.

Der Callback antwortet Invalid request oder Invalid ClientReference: die Anfrage enthielt keinen gültigen Hubtel-Callback.

Die Callback-URL zeigt im Browser Method not allowed: das ist normal. Die URL akzeptiert nur Anfragen von Hubtel.

Die Cron-URL antwortet Forbidden: das Token in der URL ist falsch. Kopieren Sie die Cron-URL genau so, wie die Einstellungen sie anzeigen. Nach einer Neuinstallation bei eingeschaltetem Delete data on uninstall ist das Token neu.

Bestellung ist im Status „on hold“: lesen Sie die Notizen im Reiter VibeFox Hubtel Pay Gateway (siehe Bestellstatus), prüfen Sie die Zahlung im Hubtel-Dashboard und führen Sie die Bestellung aus oder erstatten Sie sie manuell.

Der Kunde sieht nach Confirm Order einen Fehler: schalten Sie das Debug log ein und sehen Sie sich das Protokoll an. Falsche API-Schlüssel führen zu Hubtel payments are not available at the moment. Ein Verbindungsproblem führt zu Could not connect to Hubtel. Eine Bestellung in einer anderen Währung führt zu Hubtel accepts payments in Ghana cedis (GHS) only. Please choose another payment method. This payment method is not available. Please reload the checkout page. bedeutet, dass die Kasse nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen ausgeschaltet wurde.

Für Entwickler: Das OpenCart-Event wcp_hubtel_pay_icon ändert das Symbol der Zahlungsart, und wcp_hubtel_pay_payment_description ändert die Beschreibung der Zahlung auf der Hubtel-Seite.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Hubtel Pay Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus aus dem Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Event der Erweiterung wird ebenfalls entfernt (in OpenCart 4 zusammen mit seiner Startup-Aktion, die den Callback, die Cron-URL und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Einstellungen (Titel, Beschreibung, API-Zugangsdaten, Cron-Token, Schalter für das Debug-Protokoll) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Hubtel-Zahlungsversuche der Bestellungen bleiben immer erhalten, sodass verspätete Callbacks und Prüfungen auch nach einer Neuinstallation weiter funktionieren. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auch die Dateien der Erweiterung zu entfernen, gehen Sie in OpenCart 4 nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Hubtel Pay Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Mülleimer-Schaltfläche), um das hochgeladene Paket zu entfernen.

Hubtel ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist weder mit Hubtel verbunden noch von Hubtel unterstützt oder empfohlen.