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

Paymob-Konto: ein Händlerkonto in einem der unterstützten Länder: Ägypten, Vereinigte Arabische Emirate, Saudi-Arabien, Oman oder Pakistan. Sie benötigen vier Werte aus dem Paymob-Dashboard: den API-Schlüssel, die Integrations-ID einer Online-Zahlungsintegration, die iFrame-ID der Zahlungsseite und das HMAC-Secret.

Währung: die Kassenwährung muss die Währung Ihres Paymob-Landes sein: EGP für Ägypten, AED für die VAE, SAR für Saudi-Arabien, OMR für Oman, PKR für Pakistan. Fügen Sie sie unter System > Localisation > Currencies hinzu, falls Ihr Shop sie noch nicht hat. Bei einer anderen Währung wird das Zahlungsverfahren an der Kasse ausgeblendet. Mehrwährungs-Konten bei Paymob werden nicht unterstützt.

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

Installation

Die Datei ist ein einziges ZIP-Archiv mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_paymob_pay-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_paymob_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 zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_paymob_pay-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Paymob Pay und klicken Sie auf Install (die grüne +-Schaltfläche).

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. Wählen Sie das Paymob country und geben Sie API-Schlüssel, Integrations-ID, iFrame-ID und HMAC-Secret ein (siehe Konfiguration).

5. Setzen Sie im Paymob-Dashboard die Callback-URLs Ihrer Integration auf die URL, die im Abschnitt Callbacks angezeigt wird (siehe Callbacks).

6. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Testen Sie eine Zahlung mit der ID einer Paymob-Testintegration und geben Sie danach die ID Ihrer Live-Integration ein.

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_paymob_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 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, wählen Sie den Typ Payments, suchen Sie VibeFox Paymob Pay, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Paymob-Schlüssel und -IDs sowie die Callback-URLs wie in den Schritten 3 bis 6 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Callback-URL ist anders (siehe Callbacks).

Eine neue Installation startet mit ausgeschaltetem Zahlungsverfahren.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Paymob Pay > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn einer der vier Paymob-Werte fehlt (bis dahin wird Paymob an der Kasse ausgeblendet), und wenn die Standardwährung des Shops vom gewählten Paymob-Land nicht akzeptiert wird.

Beim Speichern darf Title nicht länger als 128 Zeichen sein, Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl größer oder gleich 0 sein, und die gewählte Geo-Zone und die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert und die Seite nennt das Feld.

Paymob

Enable/Disable: Enable Paymob schaltet das Zahlungsverfahren ein oder aus. Standard: aus.

Title: der Name des Zahlungsverfahrens, den Kunden an der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert, bis zu 128 Zeichen. Ist er leer, sehen Kunden Paymob. Standard: Paymob.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely by card or mobile wallet on the Paymob payment page. Leer lassen, damit kein Text angezeigt wird.

Sort Order: die Position von Paymob unter den Zahlungsverfahren an der Kasse. Leer lassen oder eine ganze Zahl eingeben.

Geo Zone: bietet Paymob nur für Zahlungsadressen in der gewählten Geo-Zone an. Standard: All zones. Geo-Zonen richten Sie unter System > Localisation > Geo Zones ein. Auf OpenCart 4 wird, wenn der Shop keine Zahlungsadresse verlangt, die Lieferadresse verwendet.

Total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Paymob angeboten wird. Leer lassen, um Paymob bei jeder Summe anzubieten.

Paymob-Konto

Alle Werte finden Sie in Ihrem Paymob-Händler-Dashboard. Es gibt keinen separaten Testmodus: Für Testzahlungen geben Sie die Integrations-ID einer Integration im Testmodus ein. Keine andere Einstellung ändert sich.

Paymob country: das Land Ihres Paymob-Kontos. Es wählt den API- und den Zahlungsseiten-Server, und die Kassenwährung muss die Währung dieses Landes sein. Standard: Egypt.

API key: im Paymob-Dashboard unter Settings > Account info > API Key.

Integration ID: im Paymob-Dashboard unter Developers > Payment Integrations: die numerische ID der Online-Integration für Karten oder Wallets. Die Zahlungsverfahren, die auf der Paymob-Seite angeboten werden, sind die dieser Integration.

iFrame ID: im Paymob-Dashboard unter Developers > iframes: die numerische ID des Zahlungs-iFrames.

HMAC secret: im Paymob-Dashboard unter Settings > Account info > HMAC. Pflichtfeld: Bestellungen werden nur durch Callbacks als bezahlt markiert, die mit diesem Secret signiert sind.

Integration ID und iFrame ID dürfen nur Ziffern enthalten. Leerzeichen werden entfernt. Jeder andere Wert wird beim Speichern mit der Meldung abgelehnt, dass das Feld must contain digits only — the previous value was kept enthalten muss. Die übrigen Felder werden gespeichert.

Gespeicherter API-Schlüssel und HMAC-Secret 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 Wert zu entfernen, aktivieren Sie unter dem Feld Clear the saved API key on save oder Clear the saved HMAC secret on save und klicken Sie auf Save.

Callbacks

Paymob meldet jede Transaktion an Ihren Shop. Öffnen Sie im Paymob-Dashboard Developers > Payment Integrations, wählen Sie Ihre Integration, klicken Sie auf Edit und setzen Sie sowohl Transaction processed callback als auch Transaction response callback auf die Callback URL, die in diesem Abschnitt angezeigt wird. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_paymob_pay/callback, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_paymob_pay/payment/wcp_paymob_pay.callback. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie sie mit der Schaltfläche Copy. Der Abschnitt verlinkt außerdem auf das Paymob-Dashboard des gewählten Landes. Setzen Sie die URLs in jeder Integration, die Sie nutzen, auch in der Testintegration.

Der Transaction processed callback wird vom Paymob-Server gesendet. Der Transaction response callback bringt den Kunden zurück in Ihren Shop. Beide sind mit Ihrem HMAC-Secret signiert und werden von der Erweiterung geprüft. Callbacks ohne gültige Signatur werden abgelehnt und ändern nichts. Kommt der Server-Callback verspätet oder geht verloren, bestätigt auch eine signierte Rückkehr des Kunden die Zahlung. Die Callback-URL funktioniert auch, wenn der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 fügt die Erweiterung einen Startup-Action hinzu, der die Callbacks und die Rückkehr des Kunden durchlässt.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Sie erhält einen Status erst, nachdem Paymob eine korrekt signierte Transaktion gemeldet hat. Eine abgelehnte Zahlung lässt die Bestellung ohne Status; der Kunde kehrt mit erhaltenem Warenkorb zur Kasse zurück. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: die Paymob-Transaktion ist mit dem erwarteten Betrag und der erwarteten Währung bezahlt. Standard: Verarbeitung.

Awaiting Paymob Payment Status: die Transaktion ist ausstehend, zum Beispiel eine Barzahlung oder Zahlung am Kiosk. Die Bestellung erhält den Status nach der Zahlung, wenn Paymob sie bestätigt. Standard: Ausstehend.

Paymob Payment On Hold Status: Paymob hat den Betrag nur autorisiert (erfassen Sie ihn im Paymob-Dashboard), der bezahlte Betrag oder die Währung weicht von der Bestellung ab, oder die Zahlung ist für eine stornierte Bestellung eingegangen. Eine Notiz erklärt den Grund. 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.

Die nächsten drei Felder teilen der Erweiterung mit, welche Status Ihr Shop verwendet. Die Erweiterung setzt sie nie selbst.

Payment Error Status: der Status, den Ihr Shop für Bestellungen mit einem Zahlungsfehler verwendet. Eine ausstehende Transaktion kann eine solche Bestellung in den Status Ausstehend überführen. Standard: Fehlgeschlagen.

Cancelled Order Status: der Status, den Ihr Shop für stornierte Bestellungen verwendet. Eine Zahlung für eine solche Bestellung setzt sie auf On hold oder fügt nur eine Notiz hinzu, wenn sie zuvor bezahlt war. Standard: Storniert.

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

Erweitert

Debug log: schreibt die Zahlungsschritte und Callbacks in paymob_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen. Fehler und abgelehnte Callbacks werden immer protokolliert, auch wenn der Schalter aus ist. Schlüssel, Token und Kundendaten werden nie geschrieben. Standard: aus.

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

Clean uninstall: wenn eingeschaltet, werden beim Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll gelöscht. Die für Bestellungen gespeicherten Paymob-IDs (Zahlungsversuche) bleiben immer erhalten. Standard: aus.

Importieren / Exportieren

Export: Download JSON speichert die Einstellungen als JSON-Datei. API-Schlüssel und HMAC-Secret werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Secrets bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde das Zahlungsverfahren (standardmäßig Paymob). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure Paymob payment page to pay by card or mobile wallet. OpenCart erstellt die Bestellung in diesem Schritt, noch ohne Status. Auf OpenCart 4 wählt der Kunde das Zahlungsverfahren über die Schaltfläche Choose im Block des Zahlungsverfahrens im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, legt die Erweiterung eine neue Paymob-Bestellung über den Bestellbetrag in der Bestellwährung an, übergibt Name, E-Mail, Telefonnummer und Rechnungsadresse des Kunden an Paymob (bei OpenCart 4, wenn der Shop keine Zahlungsadresse verlangt, die Lieferadresse) und leitet den Kunden zur Zahlungsseite von Paymob in Ihrem Land weiter. Dort bezahlt er mit einer der Methoden Ihrer Integration, zum Beispiel Karte oder mobilem Wallet.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Paymob sie mit einer signierten Transaktion bestätigt. Danach erhält sie ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Eine ausstehende Zahlung (zum Beispiel Barzahlung oder Kiosk) oder eine autorisierte Zahlung gibt der Bestellung ebenfalls einen Status, nämlich den Status Ausstehend oder On hold, und führt zur Erfolgsseite.

Ist die Bestellung noch in Bestätigung, wenn der Kunde zurückkehrt, zeigt eine Seite Payment confirmation die Meldung Paymob accepted your payment and we are confirming it. You will receive an e-mail as soon as your order is confirmed — there is no need to pay again. Bei einer ausstehenden Zahlung lautet der Text Your Paymob payment is pending (for example a cash or kiosk payment). Complete it as Paymob instructed you: your order is confirmed as soon as Paymob reports the payment. Die Seite hat eine Schaltfläche Check again und eine Schaltfläche Back to checkout.

Wurde die Zahlung abgelehnt, kehrt der Kunde mit demselben Warenkorb zur Kasse zurück und sieht die Meldung Your Paymob payment was not completed. Please try again or choose another payment method. Jeder neue Versuch legt eine eigene Paymob-Bestellung an, sodass der Kunde den Warenkorb erneut bezahlen kann. OpenCart 3 legt bei jeder Anzeige des Schritts Confirm Order eine neue Bestellung an; OpenCart 4 behält eine Bestellung für die Kasse bei und aktualisiert sie, sodass der Kunde dieselbe Bestellung mit einem neuen Versuch bezahlt. Lässt sich die Rückmeldung von Paymob nicht prüfen, sieht der Kunde We could not verify the response from Paymob. If you were charged, your order will be updated as soon as Paymob confirms the payment. Wurde eine andere Bestellung desselben Warenkorbs bereits bezahlt oder wartet auf Zahlung (zum Beispiel in einem zweiten Browser-Tab), wird der Kunde statt einer erneuten Zahlung zur Erfolgsseite geleitet. Auf OpenCart 4 werden die Meldungen nach der Rückkehr von Paymob über der Kassenseite angezeigt.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel von Ihnen storniert), wird der Kunde mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zur Kasse zurückgeschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Hat diese Bestellung bereits einen Status und enthält der Warenkorb jetzt andere Produkte oder Mengen, wird der Kunde ebenfalls zur Kasse zurückgeschickt, und der neue Warenkorb erhält eine neue Bestellung.

Kann Paymob die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über dem Button, zum Beispiel Paymob could not start the payment. Please check your billing details and try again, or choose another payment method. oder Could not connect to Paymob. Please try again in a moment. Der technische Grund wird im Protokoll festgehalten.

Die Erweiterung nimmt nur einmalige Zahlungen auf der Paymob-Seite an. Sie unterstützt keine gespeicherten Karten, keine Abonnements, kein eingebettetes Kartenformular auf Ihrer Website und keine Erstattungen aus dem Admin.

Bestellungen

Bestellstatus

No status (missing order): der Kunde wurde zu Paymob geschickt und hat nicht bezahlt, die Zahlung wurde abgelehnt oder Paymob hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Auf OpenCart 4 kann eine unbezahlte Bestellung der Kasse 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): Paymob hat die Zahlung bestätigt. Eine Notiz zeigt die Transaktion, den Betrag und die Kartenart mit den letzten vier Ziffern.

Awaiting Paymob Payment Status (default Pending): die Zahlung ist bei Paymob ausstehend, zum Beispiel eine Barzahlung oder Zahlung am Kiosk. Die Bestellung wechselt in den Status nach der Zahlung, wenn Paymob die Zahlung bestätigt.

Paymob Payment On Hold Status (default Pending): Paymob hat den Betrag nur autorisiert und nicht erfasst (erfassen Sie ihn im Paymob-Dashboard; die Bestellung wechselt in den Status nach der Zahlung, sobald der Capture-Callback eintrifft). Oder der bezahlte Betrag oder die Währung weicht von der Bestellung ab. Oder eine Zahlung ist für eine stornierte Bestellung eingegangen. Die Notiz erklärt den Grund. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung im Paymob-Dashboard.

Ändert sich eine Bestellung, die bereits einen Status hat, benachrichtigt OpenCart den Kunden. Geht eine zweite erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein oder eine Zahlung für eine zweite Bestellung eines bereits bezahlten Warenkorbs, bleibt die bezahlte Bestellung unverändert, und eine Notiz bittet Sie, das Duplikat im Paymob-Dashboard zu erstatten. Eine Zahlung für eine stornierte Bestellung, die zuvor bezahlt war, oder für eine erstattete Bestellung fügt nur eine Notiz hinzu: Die Bestellung wird nicht wieder geöffnet. Eine abgelehnte Zahlung für eine Bestellung, die bereits einen Status hat, fügt nur eine Notiz hinzu.

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

Reiter VibeFox Paymob Pay

Öffnen Sie unter Sales > Orders eine mit Paymob bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Paymob Pay jeden Paymob-Versuch der Bestellung: die Paymob order mit der Händler-Bestell-ID und dem Land, die Paymob transaction ID, den Status, den Requested-Betrag, den Amount reported by Paymob mit der Karte und die Paymob message. Darunter stehen die Notes der Erweiterung zu dieser Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus dem Admin werden nicht unterstützt. Erstatten oder stornieren Sie die Zahlung im Paymob-Dashboard. Meldet Paymob eine Erstattung oder Stornierung, wird der Bestellung eine Notiz hinzugefügt, und der Bestellstatus ändert sich nicht. Aktualisieren Sie die Bestellung manuell.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Paymob Pay ist der erste Block unter Extensions > Extensions > Payments > VibeFox Paymob 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 maskierten Schlüssel, 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-paymob und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen 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 aktiven Schlüssel wird Paymob 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 im selben Browser angemeldet ist, sieht das Zahlungsverfahren im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass 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 Admin-Anmeldung nicht, daher wird das Zahlungsverfahren ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Admin-Dashboard. Schließen Sie ihn mit ×, um ihn 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 Admin-Dashboard oder die Seite Edit ö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

Paymob erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, alle vier Werte (API-Schlüssel, Integrations-ID, iFrame-ID, HMAC-Secret) ausgefüllt sind und die Kassenwährung die Währung des gewählten Paymob country ist. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung die in den Einstellungen festgelegte Total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: die Callbacks erreichen Ihren Shop nicht. Prüfen Sie, ob Transaction processed callback und Transaction response callback der verwendeten Integration genau der URL aus dem Abschnitt Callbacks entsprechen und ob das HMAC secret zum selben Paymob-Konto gehört. Abgelehnte Callbacks werden als Warnungen im Protokoll festgehalten, auch wenn Debug log ausgeschaltet ist. Sehen Sie im Feld Log auf der Seite der Erweiterung nach.

Der Callback antwortet Invalid signature: das HMAC-Secret in den Einstellungen passt nicht zum Paymob-Konto, oder es ist das Konto eines anderen Landes gewählt. Kopieren Sie das HMAC-Secret erneut.

Der Callback antwortet Not configured: das HMAC-Secret ist leer. Geben Sie das Secret ein; Paymob wiederholt den Callback.

Der Callback antwortet locked oder retry: die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert, zum Beispiel der Rückkehr des Kunden, oder der Bestellstatus konnte nicht gesetzt werden. Paymob wiederholt den Callback. Der Grund wird im Protokoll festgehalten.

Das Öffnen der Callback-URL im Browser führt zur Kasse mit der Meldung, dass die Antwort nicht geprüft werden konnte: das ist normal. Die URL akzeptiert nur signierte Anfragen von Paymob.

Der Kunde sieht nach Confirm Order einen Fehler: aktivieren Sie Debug log und sehen Sie im Protokoll nach. Paymob payments are temporarily unavailable bedeutet einen falschen API-Schlüssel oder einen fehlenden Wert. Paymob could not start the payment bedeutet, dass Paymob die Anfrage abgelehnt hat, zum Beispiel wegen einer falschen Integrations-ID oder unvollständiger Rechnungsdaten. This order cannot be paid with Paymob bedeutet, dass der Bestellbetrag null ist. Paymob does not accept payments in gefolgt von einer Währung bedeutet, dass die Bestellwährung nicht die des gewählten Paymob-Landes ist. This payment method is not available. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder das Zahlungsverfahren inzwischen ausgeschaltet wurde: Der Kunde lädt die Kasse neu.

Die Bestellung ist nach der Zahlung im On-hold- oder Ausstehend-Status: lesen Sie die Notizen im Reiter VibeFox Paymob Pay. Die Zahlung ist ausstehend (Barzahlung oder Kiosk), die Transaktion wurde nur autorisiert (erfassen Sie sie im Paymob-Dashboard), Betrag oder Währung stimmten nicht, oder die Zahlung kam an, nachdem die Bestellung storniert worden war.

Testzahlungen: geben Sie die ID einer Paymob-Testintegration unter Integration ID ein und setzen Sie die Callback-URLs in dieser Integration. Für echte Zahlungen geben Sie die ID Ihrer Live-Integration erneut ein.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Paymob 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. Auf OpenCart 4 werden außerdem das OpenCart-Event der Erweiterung und ihr Startup-Action entfernt, der die Callbacks und die Rückkehr des Kunden im Wartungsmodus durchlässt. Ist Clean uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Land, Schlüssel und IDs, Protokollierung) und das Protokoll gelöscht. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Paymob-Zahlungsversuche der Bestellungen bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Paymob-IDs.

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

Paymob ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung steht in keiner Verbindung zu Paymob und wird von Paymob weder unterstützt noch empfohlen.