VibeFox Paymob for WooCommerce — Hilfe

Anforderungen

WordPress: 6.2 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

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-Geheimnis.

Währung: Die Shop-Währung muss die Währung Ihres Paymob-Landes sein: EGP für Ägypten, AED für die Vereinigten Arabischen Emirate, SAR für Saudi-Arabien, OMR für Oman, PKR für Pakistan. Bei einer anderen Währung wird die Zahlungsart an der Kasse ausgeblendet.

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

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können auch den Ordner wcp_paymob_pay per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Paymob > Manage, oder klicken Sie auf der Seite Plugins unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Wählen Sie das Paymob country und tragen Sie API-Schlüssel, Integrations-ID, iFrame-ID und HMAC-Geheimnis ein (siehe Konfiguration).

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

7. Aktivieren Sie Enable/Disable. Testen Sie eine Zahlung mit der ID einer Paymob-Testintegration und tragen Sie danach die ID Ihrer Live-Integration ein.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Paymob. Oberhalb der Felder warnt Sie die Seite, wenn einer der vier Paymob-Werte fehlt (bis dahin wird Paymob an der Kasse nicht angezeigt), und wenn die Shop-Währung vom gewählten Paymob-Land nicht akzeptiert wird. Ein Kasten zeigt die Callback-URL mit einer Schaltfläche Copy und einen Link zum Paymob-Dashboard des gewählten Landes.

Allgemein

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

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: Paymob.

Description: der Text, der an der Kasse unter der Zahlungsart angezeigt wird. Standard: Pay securely by card or mobile wallet on the Paymob payment page.

Paymob-Konto

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

Paymob country: das Land Ihres Paymob-Kontos. Es bestimmt den API- und Zahlungsseiten-Server, und die Shop-Wä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 Karte oder Wallet. Die Zahlungsarten auf der Paymob-Seite 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 Geheimnis signiert sind.

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

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 URL, die auf der Einstellungsseite angezeigt wird. Sie sieht etwa so aus: https://your-site/wc-api/paymob_pay/. Kopieren Sie sie mit der Schaltfläche Copy. Setzen Sie die URLs in jeder Integration, die Sie verwenden, auch in der Testintegration.

Der Callback für verarbeitete Transaktionen wird vom Paymob-Server gesendet. Der Callback für Transaktionsantworten bringt den Kunden zurück in Ihren Shop. Beide sind mit Ihrem HMAC-Geheimnis signiert und werden vom Plugin geprüft. Callbacks ohne gültige Signatur werden abgelehnt und ändern nichts. Kommt der Server-Callback verspätet oder gar nicht an, bestätigt auch eine signierte Rückkehr des Kunden die Zahlung.

Erweitert

Debug log: Log payment steps and callbacks schreibt die Zahlungsschritte und Callbacks nach WooCommerce > Status > Logs, Quelle wcp_paymob_pay. Fehler und abgelehnte Callbacks werden immer protokolliert. Schlüssel, Tokens und Kundendaten werden nie geschrieben. Standard: aus.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nie etwas. Auf Bestellungen gespeicherte Paymob-IDs bleiben erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Paymob) und gibt die Bestellung auf. Das Plugin legt eine neue Paymob-Bestellung über den Bestellbetrag in der Bestellwährung an, übergibt Name, E-Mail-Adresse, Telefonnummer und Rechnungsadresse des Kunden an Paymob und leitet den Kunden auf die Paymob-Zahlungsseite Ihres Landes weiter. Dort bezahlt der Kunde 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 die Zahlung mit einer signierten Transaktion bestätigt. Eine bezahlte, ausstehende oder autorisierte Zahlung führt den Kunden zur Seite Bestellung eingegangen.

Wurde die Zahlung abgelehnt, kehrt der Kunde zur Kasse zurück (oder zur Seite Pay for order, falls die Zahlung dort gestartet wurde) mit der Meldung Your Paymob payment was not completed. Please try again or choose another payment method. Jeder neue Versuch erhält eine eigene Paymob-Bestellung, sodass der Kunde dieselbe Bestellung erneut bezahlen kann. Lässt sich die Rückkehr 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.

Kann Paymob die Zahlung nicht starten, sieht der Kunde eine kurze Meldung und kann eine andere Zahlungsart wählen, 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 Zahlungsart funktioniert an der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Auf der Seite Pay for order wird die Bestellwährung statt der Shop-Währung geprüft. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin nimmt einmalige Zahlungen auf der Paymob-Seite entgegen. Es gibt keine gespeicherten Karten, keine Abonnements, kein eingebettetes Kartenformular auf Ihrer Website und keine Erstattungen aus WooCommerce.

Bestellungen

Bestellstatus

Pending payment: Der Kunde wurde zu Paymob weitergeleitet und hat noch nicht bezahlt, oder Paymob hat die Zahlung noch nicht bestätigt.

Processing: Paymob hat die Zahlung bestätigt. Bestellungen mit nur virtuellen, herunterladbaren Produkten werden auf Abgeschlossen gesetzt, dem WooCommerce-Standard. Die Bestellnotiz zeigt die Paymob-Transaktion, den Betrag und den Kartentyp mit den letzten vier Ziffern. Die Transaktions-ID ist die Paymob-Transaktions-ID.

On hold: Die Zahlung ist bei Paymob ausstehend, zum Beispiel eine Bar- oder Kiosk-Zahlung; oder Paymob hat den Betrag nur autorisiert und nicht erfasst (erfassen Sie ihn im Paymob-Dashboard; die Bestellung wird abgeschlossen, wenn der Erfassungs-Callback eingeht); oder der bezahlte Betrag oder die Währung weicht von der Bestellung ab; oder es ging eine Zahlung für eine Bestellung ein, die storniert worden war. Die Bestellnotiz erklärt den Grund.

Failed: Paymob hat die Zahlung einer ausstehenden Bestellung abgelehnt. Der Kunde kann erneut zahlen.

Geht eine zweite erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, 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.

Erstattungen

Erstattungen aus WooCommerce 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, der Bestellstatus bleibt unverändert. Aktualisieren Sie die Bestellung manuell, zum Beispiel mit einer manuellen Erstattung in WooCommerce.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Paymob. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren 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. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Seite Plugins und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen: bereits begonnene Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Paymob erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, alle vier Werte (API key, Integration ID, iFrame ID, HMAC secret) ausgefüllt sind und die Shop-Währung der Währung des gewählten Paymob country entspricht. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Entwickler mit einem Paymob-Konto für mehrere Währungen können die akzeptierten Währungen mit dem Filter paymob_p_supported_currencies erweitern.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Pending payment: Die Callbacks erreichen Ihren Shop nicht. Prüfen Sie, ob Transaction processed callback und Transaction response callback der verwendeten Integration genau der URL auf der Einstellungsseite entsprechen und ob das HMAC secret zum selben Paymob-Konto gehört. Abgelehnte Callbacks werden als Warnungen unter WooCommerce > Status > Logs, Quelle wcp_paymob_pay, protokolliert, auch wenn das Debug-Protokoll ausgeschaltet ist.

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

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

Der Callback antwortet locked: Die Bestellung wurde im selben Moment von einer anderen Anfrage aktualisiert, zum Beispiel durch die Rückkehr des Kunden. Paymob wiederholt den Callback.

Der Kunde sieht beim Aufgeben der Bestellung einen Fehler: Aktivieren Sie das Debug log und sehen Sie sich das Protokoll an. 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.

Die Bestellung steht nach der Zahlung auf Wartend: Lesen Sie die Bestellnotiz. Die Zahlung ist ausstehend (Bar oder Kiosk), die Transaktion wurde nur autorisiert (erfassen Sie sie im Paymob-Dashboard), Betrag oder Währung stimmten nicht, oder die Zahlung ging ein, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt den Grund.

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

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen des Gateways und die Protokolle werden nur entfernt, wenn Clean uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen, Transaktions-IDs und Paymob-IDs.

Paymob ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Paymob verbunden und wird nicht von Paymob unterstützt.