VibeFox Ozow 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.

Währung: Südafrikanischer Rand (ZAR). Der Shop muss die Währung ZAR haben (System > Localisation > Currencies), und die Zahlungsart wird nur angezeigt, wenn der Kunde in ZAR bezahlt. Ozow berechnet ganze Cent, daher sollte die Währung 2 Dezimalstellen haben.

Ozow-Konto: ein Ozow-Händlerkonto mit der Site Code und dem Private Key Ihrer Ozow-Site, zu finden im Ozow-Händler-Dashboard. Der API Key ist optional, wird aber empfohlen. Ozow verwendet für Test- und Live-Zahlungen denselben Site Code und dieselben Schlüssel.

Erreichbare Website: Ihr Shop muss aus dem Internet erreichbar sein, ohne Passwortschutz oder Firewall, die Ozow blockiert, damit die Benachrichtigungen von Ozow ankommen. Die Benachrichtigung funktioniert auch, wenn der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und unter OpenCart 4 fügt die Erweiterung eine Startaktion hinzu, die die Benachrichtigung und die Rückkehr des Kunden von Ozow durchlässt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine 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_ozow_pay-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_ozow_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_ozow_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 Ozow Pay 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 License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Tragen Sie die Site Code und den Private Key sowie vorzugsweise den API Key aus Ihrem Ozow-Händler-Dashboard ein. Die Benachrichtigungs- und Rück-URLs werden bei jeder Zahlung an Ozow übermittelt, daher muss im Ozow-Dashboard nichts eingerichtet werden.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Führen Sie eine Testzahlung mit eingeschaltetem Test mode durch und schalten Sie dann den Testmodus aus, um echte Zahlungen anzunehmen.

OpenCart 4

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

2. Das Paket erscheint in der Liste der installierten Erweiterungen auf derselben Seite. 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 Ozow Pay, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Ozow-Schlüssel ein und testen Sie die Zahlung wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs- und Rück-URLs unterscheiden sich (siehe Zahlungsbenachrichtigungen); auch sie werden bei jeder Zahlung an Ozow übermittelt.

Eine neue Installation startet mit ausgeschalteter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Ozow Pay > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn Site Code oder Private Key fehlen (Ozow wird dann an der Kasse ausgeblendet), wenn die Standardwährung des Shops nicht ZAR ist, wenn die Währung mehr als 2 Dezimalstellen hat (stellen Sie sie in System > Localisation > Currencies auf 2 ein), und zeigt Test mode is on: no real payments are accepted. Do not ship orders paid in test mode. an, solange der Testmodus eingeschaltet ist. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Die Ozow-Felder verhindern das Speichern nie, außer ein Title ist länger als 128 Zeichen (The title must be no longer than 128 characters.). Die OpenCart-Felder werden geprüft: Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total eine Zahl von 0 oder mehr, und die Geozone sowie die Bestellstatus müssen existieren. Ist einer davon falsch, nennt eine Fehlermeldung das Feld, und nichts wird gespeichert.

Ozow

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

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart im Bestellvorgang gespeichert. Bis zu 128 Zeichen; bleibt das Feld leer, wird Instant EFT (Ozow) angezeigt. Standard: Instant EFT (Ozow).

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay instantly and securely from your South African bank account. You will be redirected to Ozow to choose your bank and approve the payment. Im Testmodus wird darunter die Zeile TEST MODE: no money will be charged. ergänzt (nur wenn die Beschreibung nicht leer ist).

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

Geo Zone: bietet Ozow nur für Zahlungsadressen in der gewählten Geozone an. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet. In OpenCart 4 wird die Lieferadresse verwendet, wenn der Shop keine Zahlungsadresse abfragt.

Total: die Warenkorbsumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Ozow angeboten wird. Lassen Sie das Feld leer, um Ozow bei jeder Summe anzubieten.

Ozow-Zugangsdaten

Kopieren Sie Site Code, Private Key und API Key aus Ihrem Ozow-Händler-Dashboard (Merchant details / Sites). Der Abschnitt verlinkt auf die Ozow-Integrationsdokumentation unter hub.ozow.com.

Site Code: der Site Code der Ozow-Site, die die Zahlungen erhält. Antworten für einen anderen Site Code werden abgelehnt.

Private Key: signiert jede Zahlungsanfrage und prüft jede Antwort von Ozow. Halten Sie ihn geheim. Er wird genau so gespeichert, wie Sie ihn eingeben. Ohne ihn wird die Zahlungsart ausgeblendet, und keine Antwort von Ozow wird akzeptiert.

API Key (recommended): optional. Mit einem API Key wird jede erfolgreiche Zahlung zusätzlich über die Ozow-GetTransaction-API bestätigt, bevor die Bestellung als bezahlt markiert wird. Die API muss die Zahlung als abgeschlossen melden, mit demselben Betrag, derselben Währung und demselben Site Code.

Gespeicherte Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, setzen Sie unter dem Feld ein Häkchen bei Clear the saved Private Key on save bzw. Clear the saved API Key on save und klicken Sie auf Save.

Test mode: Ozow verwendet für Tests denselben Site Code und dieselben Schlüssel: Zahlungen werden mit IsTest=true angelegt, und es wird kein Geld bewegt. Bestellungen, die im Testmodus bezahlt wurden, erhalten eine Notiz; liefern Sie sie nicht aus. Schalten Sie den Testmodus aus, um echte Zahlungen anzunehmen. Eine Testzahlung bezahlt im Livebetrieb nie eine Bestellung. Standard: an.

Zahlungsbenachrichtigungen

Der Abschnitt zeigt die vier URLs, die die Erweiterung bei jeder Zahlung an Ozow sendet: Notification URL (Ozow sendet dorthin die Zahlungsbenachrichtigung), Success URL, Cancel URL und Error URL (Ozow leitet den Kunden dorthin zurück). Sie sehen etwa so aus: https://your-store/index.php?route=extension/payment/wcp_ozow_pay/notify und https://your-store/index.php?route=extension/payment/wcp_ozow_pay/back&ozow_return=success, unter OpenCart 4 lauten sie https://your-store/index.php?route=extension/wcp_ozow_pay/payment/wcp_ozow_pay.notify und https://your-store/index.php?route=extension/wcp_ozow_pay/payment/wcp_ozow_pay.back&ozow_return=success, und werden aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Im Ozow-Dashboard muss nichts eingestellt werden. Wenn Ihre Ozow-Site auf feste URLs eingestellt ist, kopieren Sie sie genau so, wie die Einstellungen sie anzeigen.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Ozow eine korrekt signierte Antwort gesendet hat. Eine abgebrochene oder fehlgeschlagene Zahlung lässt die Bestellung ohne Status, und der Kunde kehrt mit erhaltenem Warenkorb zur Kasse zurück. Jedes der folgenden Felder listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: Ozow hat die Zahlung als Complete mit dem erwarteten Betrag und der erwarteten Währung gemeldet (bestätigt durch GetTransaction, wenn ein API Key gesetzt ist). Standard: In Bearbeitung.

Awaiting Ozow Payment Status: Ozow oder die Bank prüft die Zahlung (Ozow-Status PendingInvestigation). Meldet Ozow Complete, erhält die Bestellung den Status nach Zahlungseingang. Standard: Ausstehend.

On Hold (Review) Status: die Zahlung muss von Ihnen geprüft werden (siehe Bestellstatus). Die Bestellung wird nicht als bezahlt markiert. 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.

Failed Payment Status: eine geprüfte Zahlung, die Ozow danach als Cancelled, Error oder Abandoned gemeldet hat. Standard: Fehlgeschlagen.

Cancelled Order Status: der Status, den Ihr Shop für stornierte Bestellungen verwendet. Eine für eine solche Bestellung eingegangene Zahlung setzt sie in den Prüfstatus statt sie als bezahlt zu markieren. Die Erweiterung setzt diesen Status nie. Standard: Storniert.

Refunded Order Status: der Status, den Ihr Shop für erstattete Bestellungen verwendet. Eine für eine solche Bestellung eingegangene Zahlung fügt nur eine Notiz hinzu. Die Erweiterung setzt diesen Status nie. Standard: Erstattet.

Erweitert

Debug log: schreibt Zahlungsanfragen und Antworten von Ozow in ozow_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie nach ozow_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert. Schlüssel, Hashes, Tokens und Kundendaten werden nie protokolliert. Standard: aus.

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

Delete data on uninstall: wenn eingeschaltet, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Die Ozow-Daten der Bestellungen bleiben immer erhalten. Standard: aus.

Importieren / Exportieren

Export: Download JSON speichert die Einstellungen als JSON-Datei. Private Key und API Key werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Instant EFT (Ozow)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to Ozow to choose your bank and approve the payment. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Unter 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. Wenn der Kunde auf Confirm Order klickt, leitet die Erweiterung ihn mit einer signierten Anfrage über die Bestellsumme in ZAR auf die gehostete Zahlungsseite von Ozow weiter. Die Verwendungszweck-Referenz im Kontoauszug ist Order und die Bestellnummer (bis zu 20 lateinische Buchstaben, Ziffern, Leerzeichen und Bindestriche). Der Name des Kunden wird an Ozow übergeben. Auf der Ozow-Seite wählt der Kunde eine südafrikanische Bank und bestätigt die Zahlung in der Banking-App.

Ozow benachrichtigt danach den Shop und sendet den Kunden zurück. Beide enthalten dieselbe signierte Antwort und werden gleich verarbeitet, sodass die Bestellung ihren Status auch dann erhält, wenn eine davon verloren geht. Die Bestellung wird erst als bezahlt markiert, wenn Ozow die Zahlung bestätigt: Der Hash muss mit Ihrem Private Key geprüft werden, der Site Code muss Ihrer sein, die Antwort muss zu diesem Zahlungsversuch der Bestellung gehören, und Betrag und Währung müssen zur Bestellung passen. Mit einem API Key wird die Zahlung zusätzlich über die GetTransaction-API geprüft. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung.

Nach einer erfolgreichen Zahlung sieht der Kunde die Erfolgsseite der OpenCart-Bestellung. Wenn Ozow oder die Bank die Zahlung noch prüft, enthält die Seite außerdem We are waiting for Ozow to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Befindet sich die Bestellung im Prüfstatus, heißt es Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed. Ist eine geprüfte Zahlung später fehlgeschlagen oder wurde die unbezahlte Bestellung storniert, heißt es Your Ozow payment was not completed. Please contact us about this order. (unter OpenCart 4 wird der Kunde stattdessen zur Kasse zurückgeschickt, siehe unten). Hat Ozow die Zahlung beim Zurückkehren des Kunden noch nicht bestätigt, zeigt eine Seite Payment confirmation den Wartetext mit den Schaltflächen Check again und Back to checkout.

Bricht der Kunde auf der Ozow-Seite ab oder schlägt die Zahlung fehl, bleibt die Bestellung ohne Status. Der Kunde kehrt mit demselben Warenkorb zur Kasse zurück und sieht The Ozow payment was cancelled. You can try again or choose another payment method. oder The Ozow payment was not completed. You can try again or choose another payment method. Unter OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird. OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie, sodass der Kunde nach einer abgebrochenen oder fehlgeschlagenen Zahlung dieselbe Bestellung mit einem neuen Versuch bezahlt. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder wartet auf Ozow, wird der Kunde direkt zur Erfolgsseite geleitet, und eine verspätete Zahlung für die zweite Bestellung wird nicht angerechnet: Eine Notiz an der bezahlten Bestellung bittet Sie, das Duplikat in Ihrem Ozow-Dashboard zu erstatten.

Wurde eine Bestellung des Warenkorbs bezahlt und danach von Ihnen storniert oder erstattet, wird der Kunde zur Kasse zurückgeschickt und bezahlt den Warenkorb mit einer neuen Bestellung. In OpenCart 3 lautet die Meldung This order was cancelled or refunded by the store. Please confirm the order again to pay with a new order.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Klickt der Kunde erneut auf Confirm Order oder kehrt er von Ozow zurück und ist diese Bestellung abgeschlossen, wird der Kunde mit einer Meldung zur Kasse zurückgeschickt, und das nächste Confirm Order bezahlt eine neue Bestellung: Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. (zum Beispiel, wenn eine geprüfte Zahlung fehlgeschlagen ist oder Sie die unbezahlte Bestellung storniert haben) oder Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. (die Bestellung wurde bezahlt und danach storniert oder erstattet). Ist diese Bestellung bereits bezahlt und enthält der Warenkorb jetzt andere Produkte oder Mengen, zeigt Confirm Order Your previous order has already been paid. Your cart has changed since — please confirm the order again to pay for the current cart.

Ist die Kasse nicht in ZAR, sieht der Kunde Ozow accepts payments in South African rand (ZAR) only. Please choose another payment method.

Die Erweiterung nimmt nur einmalige Zahlungen in ZAR an. Sie bietet keine Erstattungen aus OpenCart, keine Abonnements, keine gespeicherten Bankkonten oder Tokenisierung und keine aus dem Admin-Bereich versendeten Zahlungslinks.

Bestellungen und Erstattungen

Bestellstatus

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

Eine unbezahlte Bestellung aus der Kasse kann bei OpenCart 4 den Status Voided erhalten, den OpenCart 4 setzt, wenn der Kunde zum Schritt Confirm Order zurückkehrt. Die Erweiterung behandelt eine solche Bestellung als Bestellung ohne Status, und eine spätere Zahlung bestätigt sie trotzdem.

Order Status After Payment (default Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt den Betrag und die Ozow-Transaktions-ID sowie, ob die Zahlung durch die GetTransaction-API bestätigt wurde. Eine Testzahlung erhält die Notiz TEST MODE — no money was received, do not ship this order.

Awaiting Ozow Payment Status (default Pending): Ozow oder die Bank prüft die Zahlung. Die Bestellung wird aktualisiert, wenn Ozow den endgültigen Status sendet: Order Status After Payment bei Erfolg, Failed Payment Status bei Misserfolg.

On Hold (Review) Status (default Pending): die Notiz nennt den Grund: Der gezahlte Betrag oder die Währung weicht von der Bestellung ab; eine Zahlung ist für eine bereits stornierte Bestellung eingegangen; oder, mit einem API Key, konnte die GetTransaction-API die Zahlung noch nicht bestätigen oder widerspricht ihr. Prüfen Sie die Zahlung in Ihrem Ozow-Dashboard und ändern Sie den Bestellstatus. Konnte die API nicht antworten, schließt die nächste Ozow-Benachrichtigung die Bestellung ab.

Failed Payment Status (default Failed): eine Zahlung, die geprüft wurde, wurde storniert, abgebrochen oder ist fehlgeschlagen. Eine spätere erfolgreiche Antwort von Ozow dafür markiert die Bestellung trotzdem als bezahlt.

Eine bereits bezahlte Bestellung wird nie zurückgesetzt, und eine stornierte oder erstattete Bestellung wird nie wieder geöffnet. Geht für eine bereits bezahlte Bestellung eine zweite Zahlung ein, bittet eine Notiz Sie, das Duplikat in Ihrem Ozow-Dashboard zu erstatten. Eine Testzahlung bezahlt eine Bestellung nie, während die Erweiterung im Livebetrieb ist; eine Notiz weist darauf hin.

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

Tab „VibeFox Ozow Pay“

Öffnen Sie unter Sales > Orders eine mit Ozow bezahlte Bestellung. Unten auf der Bestellseite zeigt der Tab VibeFox Ozow Pay neben History und Additional die Transaction reference (die Bestellnummer) und den Versuch, die Ozow transaction ID, den Status, den angeforderten Betrag (Requested), den von Ozow gemeldeten Betrag (Amount reported by Ozow), die Ozow message, eine Kennzeichnung TEST MODE für Testzahlungen und die Ozow notes der Bestellung. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus OpenCart werden nicht unterstützt. Erstatten Sie die Zahlung in Ihrem Ozow-Händler-Dashboard und erfassen Sie die Erstattung anschließend manuell in OpenCart. Produktrücksendungen unter Sales > Returns erstatten kein Geld über Ozow.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Ozow Pay ist der erste Block unter Extensions > Extensions > Payments > VibeFox Ozow Pay > 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, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-ozow und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks richten sich nach der Admin-Sprache (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 für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne einen aktiven Schlüssel wird Ozow Kunden an 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 Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher wird ohne einen aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint eine Erinnerung auf dem Dashboard des Admin-Bereichs. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt.

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

Fehlerbehebung

Ozow erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Site Code und Private Key ausgefüllt sind und der Kunde in ZAR bezahlt. 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 etwas fehlt.

Die Zahlung ging durch, aber die Bestellung bleibt ohne Status: Die Ozow-Benachrichtigung hat den Shop nicht erreicht, und der Kunde ist nicht zurückgekehrt. Prüfen Sie, ob Ihr Shop aus dem Internet erreichbar ist (kein Passwortschutz und keine Firewall, die Ozow blockiert). Ist Ihre Ozow-Site auf feste URLs eingestellt, prüfen Sie, ob die URLs genau denen unter Payment notifications entsprechen. Aktivieren Sie Debug log und lesen Sie das Feld Log auf der Erweiterungsseite.

Die Benachrichtigung antwortet Invalid hash: der Private Key in den Einstellungen gehört nicht zur Ozow-Site, die die Antwort gesendet hat. Kopieren Sie ihn erneut aus dem Ozow-Händler-Dashboard. Es wird nichts verändert.

Die Benachrichtigung antwortet Unknown site: die Antwort kam von einer anderen Ozow-Site. Prüfen Sie den Site Code.

Die Benachrichtigung antwortet Order mismatch oder Order not found: die Antwort gehört zu keiner in diesem Shop gestarteten Zahlung. Es wird nichts verändert.

Die Benachrichtigung antwortet Gateway not configured: der Site Code oder der Private Key fehlt. Tragen Sie ihn ein; Ozow kann es erneut versuchen.

Die Benachrichtigung antwortet Payment not confirmed yet: die Antwort konnte noch nicht verarbeitet werden. Mit einem API Key konnte die GetTransaction-API die Zahlung nicht bestätigen (die Bestellung befindet sich im Prüfstatus, und die nächste Benachrichtigung schließt sie ab; bleibt sie dort, prüfen Sie den API Key und die Zahlung in Ihrem Ozow-Dashboard). Diese Antwort erscheint auch, wenn die Rückkehr des Kunden für denselben Warenkorb im selben Moment verarbeitet wurde; siehe das Protokoll.

Der Kunde sieht This payment method is not available. Please reload the checkout page.: die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen ausgeschaltet. Der Kunde lädt die Kasse neu.

Eine Testzahlung hat die Bestellung nicht bezahlt: die Erweiterung ist im Livebetrieb. Testzahlungen bezahlen im Livebetrieb nie eine Bestellung; die Bestellnotiz oder das Protokoll weist darauf hin.

Die Bestellung ist nach der Zahlung im Prüfstatus: lesen Sie die Notizen im Tab VibeFox Ozow Pay, prüfen Sie die Zahlung in Ihrem Ozow-Dashboard und setzen Sie dann den Bestellstatus oder erstatten Sie die Zahlung in Ozow.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Ozow Pay 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 im Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (unter OpenCart 4 auch dessen Ereignisse und Startaktion, die die Benachrichtigung und die Rückkehr im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Site Code, Schlüssel, Testmodus, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungsdatensätze von Ozow bleiben immer erhalten, sodass verspätete Benachrichtigungen zu alten Bestellungen nach einer Neuinstallation weiterhin erkannt werden. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Bei OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox Ozow Pay auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Ozow ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Ozow verbunden und wird von Ozow weder unterstützt noch empfohlen.