VibeFox Moyasar for OpenCart — Hilfe

Voraussetzungen

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: Die Währung der Kasse muss SAR, AED, USD, EUR, KWD, BHD oder OMR sein. Bei jeder anderen Währung wird die Zahlungsart an der Kasse ausgeblendet.

Moyasar-Konto: Sie benötigen die geheimen API-Schlüssel Ihres Moyasar-Kontos (Test und Live). Verwendet werden nur die geheimen Schlüssel. Der öffentliche Schlüssel (Publishable Key) wird nicht benötigt, da die Zahlung auf der Moyasar-Seite erfolgt. Ein Webhook im Moyasar Dashboard wird empfohlen (siehe Konfiguration).

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine einzige ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_moyasar_payment_gateway.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_moyasar_payment_gateway-oc3-(version).ocmod.zip aus. Die Erweiterung enthält keine OCMOD-Modifikationen, 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, wählen Sie den Typ Payments und suchen Sie VibeFox Moyasar Payment Gateway. 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 Schaltfläche mit dem Stift), 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 Lizenzschlüssel).

4. Fügen Sie Ihre geheimen Moyasar-Schlüssel ein und klicken Sie auf Save. Beim ersten Speichern wird das gemeinsame Geheimnis des Webhooks erzeugt und einmalig oberhalb der Einstellungen angezeigt. Richten Sie damit den Webhook im Moyasar Dashboard ein (siehe Konfiguration).

5. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Legen Sie eine Testbestellung im Testmodus an und schalten Sie danach Test mode aus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_moyasar_payment_gateway.ocmod.zip aus. 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 Moyasar Payment Gateway, klicken Sie auf Install (die grüne Schaltfläche +) und dann auf Edit (die Schaltfläche mit dem Stift).

4. Geben Sie den Lizenzschlüssel, die Moyasar-Schlüssel und den Webhook wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Webhook-URL ist unterschiedlich (siehe Webhook URL).

Nach einer Neuinstallation ist die Zahlungsart zunächst deaktiviert und der Testmodus eingeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Moyasar Payment 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 für den aktuellen Modus kein geheimer Schlüssel hinterlegt ist (die Zahlungsart wird dann an der Kasse ausgeblendet), wenn kein gemeinsames Geheimnis des Webhooks gespeichert ist (der Webhook lehnt dann jeden Aufruf ab) oder wenn die Standardwährung des Shops nicht unterstützt wird. Solange die Erweiterung im Testmodus aktiviert ist, zeigt sie Der Testmodus ist aktiv: Zahlungen werden simuliert, es wird kein Geld abgebucht. an. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl größer oder gleich 0 sein, und die Geo Zone sowie die Bestellstatus müssen existieren; andernfalls wird nichts gespeichert. Die Erweiterung lehnt einen öffentlichen Schlüssel, einen Schlüssel des anderen Modus oder einen Schlüssel mit Leerzeichen ab: Der Rest wird mit Einstellungen gespeichert, außer dem rot angezeigten Schlüssel. gespeichert, der bisherige Schlüssel bleibt erhalten und der Grund wird angezeigt. Wird die Erweiterung ohne den geheimen Schlüssel des aktuellen Modus aktiviert, werden die Einstellungen mit einer Warnung gespeichert.

Moyasar

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

Title: Der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird außerdem in der Bestellung gespeichert. Standard: Pay with Moyasar. Pflichtfeld, bis zu 128 Zeichen.

Description: Der Text, den der Kunde im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche sieht. Standard: You will be redirected to the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. Im Testmodus ergänzt der Schritt (Testmodus: Es wird keine echte Zahlung ausgeführt.)

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

Geo Zone: Moyasar nur für Rechnungsadressen in der ausgewählten Geo Zone anbieten. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: Der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Moyasar angeboten wird. Lassen Sie das Feld leer, um Moyasar bei jedem Betrag anzubieten.

API-Schlüssel

Kopieren Sie die geheimen Schlüssel aus Moyasar Dashboard > Settings > API Keys (die Seite enthält dorthin einen Link). Test- und Live-Schlüssel sind getrennt. Der Testmodus verwendet nur den Testschlüssel, der Live-Modus nur den Live-Schlüssel.

Test mode: Verwendet den geheimen Testschlüssel: Zahlungen werden simuliert, es wird kein Geld abgebucht. Standard: eingeschaltet. Schalten Sie ihn aus, um echte Zahlungen mit dem geheimen Live-Schlüssel anzunehmen. Rechnungen des anderen Modus verwenden für Statusabfragen und Erstattungen weiterhin den Schlüssel ihres eigenen Modus.

Test secret key: Der geheime Schlüssel des Testmodus. Er beginnt mit sk_test_.

Live secret key: Der geheime Schlüssel des Live-Modus. Er beginnt mit sk_live_.

Gespeicherte Schlüssel und Geheimnisse werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — zum Beibehalten leer lassen. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld das Häkchen bei Clear the saved value on save und klicken Sie auf Save.

Zahlungsbenachrichtigungen (Webhook)

Der Webhook wird empfohlen, ist aber nicht zwingend erforderlich. Bestellungen werden auch bestätigt, wenn der Kunde in den Shop zurückkehrt, sowie durch die Rechnungsbenachrichtigung, die Moyasar automatisch an Ihren Shop sendet, sobald die Rechnung bezahlt ist. Der Webhook deckt Kunden ab, die den Browser schließen, bevor sie zurückkehren, und meldet Erstattungen, die im Moyasar Dashboard vorgenommen wurden. Fügen Sie ihn unter Moyasar Dashboard > Settings > Webhooks hinzu.

Webhook URL: wird schreibgeschützt mit einer Schaltfläche Copy angezeigt. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_moyasar_payment_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_moyasar_payment_gateway/payment/wcp_moyasar_payment_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. HTTP-Methode: POST. Die URL muss aus dem Internet erreichbar sein.

Webhook shared secret: Geben Sie denselben Wert ein wie das Shared secret des Webhooks in Moyasar, oder setzen Sie das Häkchen bei Generate a new secret und speichern Sie. Ist nichts gespeichert, erzeugt Save ein zufälliges Geheimnis. Ein erzeugtes Geheimnis wird nach dem Speichern einmalig oberhalb der Einstellungen angezeigt und danach nie wieder, kopieren Sie es also sofort nach Moyasar. Webhooks ohne das richtige gemeinsame Geheimnis werden abgelehnt. Ein gemeinsames Geheimnis gilt für beide Modi.

Wählen Sie für den Webhook diese Ereignisse aus (sie sind auch in diesem Abschnitt aufgeführt):

Keine Angabe aus einem Webhook oder einer Benachrichtigung wird direkt übernommen: Die Erweiterung liest für jede Meldung die Rechnung über die Moyasar-API mit dem geheimen Schlüssel des Modus aus, in dem die Rechnung erstellt wurde, und prüft, ob sie von diesem Shop erstellt wurde. Zahlungen anderer Integrationen auf demselben Moyasar-Konto werden ignoriert.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine unvollständige Bestellung). Die Bestellung erhält erst dann einen Status, wenn Moyasar die Rechnung bestätigt hat. Jedes Feld unten listet Ihre Bestellstatus aus OpenCart auf.

Status after payment: Der Status nach einer bestätigten Zahlung. Standard: Verarbeitung. Wählen Sie Complete, wenn bezahlte Bestellungen sofort abgeschlossen werden sollen, oder Ihren Prüfstatus, wenn jede bezahlte Bestellung auf eine manuelle Prüfung warten soll.

Awaiting Moyasar payment status: Moyasar hält die Zahlung zur Prüfung zurück; die Bestellung wechselt zu Status after payment, sobald Moyasar sie bestätigt. Standard: Ausstehend.

Moyasar payment on hold status: Moyasar hat einen anderen Betrag oder eine andere Währung als den Bestellbetrag gemeldet, oder die Rechnung wurde bezahlt, nachdem die Bestellung storniert oder auf einen anderen Status gesetzt worden war. Die Bestellung wird nicht als bezahlt markiert. Standard: Ausstehend, da OpenCart keinen Status für eine Zahlung in Wartestellung hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment error status: Die zu prüfende Zahlung ist fehlgeschlagen. Standard: Fehlgeschlagen.

Refunded status: Wird gesetzt, nachdem die Zahlung von der Bestellseite aus vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: Protokolliert API-Aufrufe und Benachrichtigungen in moyasar_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser öffnen; bei 5 MB wird sie nach moyasar_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert. API-Schlüssel, Kartendaten und Kundendetails werden nie protokolliert. Standard: aus.

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

Clean uninstall: Wenn eingeschaltet, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Die mit den Bestellungen gespeicherten Zahlungsdetails (Moyasar-Rechnungs- und Zahlungs-IDs) bleiben erhalten, damit Erstattungen nachvollziehbar bleiben. Standard: aus.

Import / Export

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

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Schlüssel und Geheimnisse bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Pay with Moyasar). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Moyasar-Rechnung für den Bestellbetrag in der Bestellwährung und leitet den Kunden auf deren Zahlungsseite weiter. Dort zahlt der Kunde mit einer beliebigen Methode, die in Ihrem Moyasar-Konto aktiv ist. Bei 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. Die Rechnung zeigt Order #, die Bestellnummer und Ihren Shopnamen.

Die Bestellung wird erst als bezahlt markiert, nachdem Moyasar sie bestätigt hat: Die Erweiterung liest die Rechnung über die Moyasar-API aus und prüft, ob sie bezahlt ist, zu dieser Bestellung gehört und genau den Bestellbetrag und die Bestellwährung hat. Danach erhält die Bestellung 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 mit Ihre Zahlung mit Moyasar ist eingegangen. Hält Moyasar die Zahlung zur Prüfung zurück, zeigt die Seite Ihre Zahlung wird von Moyasar geprüft. Die Bestellung wird automatisch aktualisiert, sobald Moyasar sie bestätigt — bitte zahlen Sie nicht erneut. Ist die Bestellung für Ihre Prüfung zurückgehalten, zeigt die Seite Wir haben Ihre Zahlung erhalten und prüfen Ihre Bestellung. Wir melden uns, falls etwas benötigt wird — bitte zahlen Sie nicht erneut. Schlägt eine zu prüfende Zahlung später fehl, zeigt die Seite Ihre Zahlung mit Moyasar wurde nicht abgeschlossen. Bitte kontaktieren Sie uns zu dieser Bestellung.

Kehrt der Kunde zurück, ohne bezahlt zu haben (zum Beispiel mit der Zurück-Schaltfläche der Zahlungsseite), landet er wieder an der Kasse mit einer dieser Meldungen: Die Zahlung bei Moyasar wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsart wählen., Ihre Zahlung mit Moyasar wurde abgelehnt oder ist abgelaufen. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart. oder, wenn die Zahlung noch nicht geprüft werden kann, Wir konnten Ihre Zahlung bei Moyasar noch nicht bestätigen. Wenn Sie die Zahlung abgeschlossen haben, wird die Bestellung in wenigen Minuten automatisch aktualisiert — bitte prüfen Sie Ihre E-Mails, bevor Sie erneut zahlen. Der Warenkorb bleibt erhalten. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

Der Kunde kann es erneut versuchen. OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 behält eine Bestellung für den Bestellvorgang bei und bezahlt dieselbe Bestellung erneut. Die Erweiterung prüft zuerst die offenen Rechnungen desselben Warenkorbs: Hat die offene Zahlungsseite dieser Bestellung noch denselben Modus, Betrag und dieselbe Währung, wird sie wiederverwendet; andernfalls wird die alte Rechnung bei Moyasar storniert und eine neue erstellt, sodass die alte nicht mehr bezahlt werden kann. Stellt sich heraus, dass eine frühere Rechnung des Warenkorbs bereits bezahlt ist, wird stattdessen diese Zahlung bestätigt.

OpenCart 4 behält die Bestellung im Bestellvorgang, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil Sie sie storniert haben oder ihre Zahlung fehlgeschlagen ist), wird der Kunde mit Ihre vorherige Bestellung wurde storniert oder ihre Zahlung ist fehlgeschlagen. Bitte bestätigen Sie die Bestellung erneut. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Eine Bestellung des Warenkorbs, die bezahlt und danach storniert oder erstattet wurde, sperrt den Warenkorb nicht mehr.

Kann Moyasar die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel Der Zahlungsdienst von Moyasar antwortet nicht. Bitte versuchen Sie es in einigen Minuten erneut., und kann eine andere Zahlungsart wählen. Die Details werden im Protokoll festgehalten.

Webhook und Rechnungsbenachrichtigung funktionieren auch, während der Shop im Wartungsmodus ist, weil OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt; bei OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu, die auch die Rückkehr des Kunden von Moyasar ermöglicht.

Die Erweiterung verarbeitet nur einmalige Zahlungen auf der Seite von Moyasar. Es gibt kein Kartenformular in Ihrer eigenen Kasse, keine gespeicherten Karten oder Tokenisierung, keine Abonnements und kein getrenntes Autorisieren und Erfassen.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (unvollständige Bestellung): Der Kunde wurde zu Moyasar weitergeleitet und hat nicht bezahlt, Moyasar hat die Zahlung noch nicht bestätigt, oder die Zahlung wurde abgelehnt, ist abgelaufen oder storniert worden. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Status after payment (Standard Verarbeitung): Die Zahlung wurde bestätigt. Eine Notiz zeigt, wie die Zahlung bestätigt wurde (Webhook, Rechnungsbenachrichtigung, Rückkehr des Kunden oder Kasse), die Rechnungs-ID, die Zahlungs-ID und die Zahlungsart, zum Beispiel die Kartenmarke und die letzten vier Ziffern.

Awaiting Moyasar payment status (Standard Ausstehend): Moyasar hält die Zahlung zur Prüfung zurück. Die Bestellung wechselt zu Status after payment, wenn Moyasar die Zahlung bestätigt, oder zu Payment error status, wenn sie fehlschlägt.

Moyasar payment on hold status (Standard Ausstehend): Moyasar hat einen anderen Betrag oder eine andere Währung als den Bestellbetrag gemeldet, oder die Rechnung wurde bezahlt, nachdem Sie die Bestellung storniert oder ihren Status geändert hatten. Die Bestellung wird nicht als bezahlt markiert, der tatsächlich belastete Betrag wird jedoch für Erstattungen festgehalten. Die Notiz erklärt es. Prüfen Sie die Zahlung im Moyasar Dashboard und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Payment error status (Standard Fehlgeschlagen): Die zu prüfende Zahlung ist fehlgeschlagen.

Refunded status (Standard Erstattet): Die Zahlung wurde über die Erweiterung vollständig erstattet.

Eine bezahlte oder erstattete Bestellung wird durch spätere Ereignisse nie wieder verändert. Haben Sie bereits selbst einen bezahlt-Status gesetzt, wird die Zahlung erfasst, der Status aber nicht geändert. Wird eine zweite Rechnung eines bereits bezahlten Warenkorbs ebenfalls bezahlt (zum Beispiel aus zwei Browser-Tabs), bleibt die bezahlte Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im Moyasar Dashboard zu erstatten.

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

Registerkarte VibeFox Moyasar Payment Gateway

Öffnen Sie unter Sales > Orders eine mit Moyasar bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Moyasar Payment Gateway die Moyasar invoice (bei Testzahlungen mit dem Hinweis Test mode), die Moyasar payment, die Method, den Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Moyasar notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie in der Registerkarte VibeFox Moyasar Payment Gateway den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Moyasar. Bestätigen Sie die Abfrage Diesen Betrag über Moyasar erstatten? Dies kann nicht rückgängig gemacht werden. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die Moyasar belastet hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht bis zum Bestellbetrag. Eine vollständige Erstattung einer Kartenzahlung, die vor weniger als 2 Stunden erfolgte, wird als Stornierung (Void) gesendet: Abbruch vor der Abrechnung, ohne Gebühren. STC-Pay-Zahlungen und alle übrigen Fälle werden erstattet. Die Erstattung verwendet den geheimen Schlüssel des Modus, in dem die Zahlung erfolgt ist (Test oder Live), daher muss dieser Schlüssel gesetzt sein. Die Erweiterung prüft zuerst bei Moyasar Währung, Status und erstattungsfähigen Betrag der Zahlung. Lehnt Moyasar die Erstattung ab, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung oder Stornierung wird dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded status, ohne den Kunden zu benachrichtigen und ohne Produkte wieder dem Bestand zuzubuchen, genau wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Moyasar die Zahlung bestätigt hat.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Moyasar.

Erstattungen und Stornierungen, die im Moyasar Dashboard vorgenommen wurden, werden über den Webhook gemeldet. Zeigt Moyasar mehr erstattet an, als die Erweiterung erfasst hat, wird der Bestellung eine Notiz hinzugefügt. Der Bestellstatus wird nicht automatisch geändert. Aktualisieren Sie ihn bei Bedarf manuell, ohne Refund via Moyasar zu verwenden.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Moyasar Payment Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Moyasar Payment 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 gültig 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-moyasar 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 folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Schlüssel nicht gefunden, Dieser Schlüssel gehört zu einem anderen Produkt, Domain-Limit erreicht oder Lizenz abgelaufen am mit einem Datum. Nachdem sich die Shopadresse geändert hat 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. 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 Moyasar Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde Diese Zahlungsart ist nicht verfügbar. Bitte wählen Sie eine andere. Ein Admin-Benutzer, der im selben Browser im Admin-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (nicht lizenziert — nur für Admins sichtbar), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 steht diese Vorschau nicht zur Verfügung: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist 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. Mit × blenden Sie sie 7 Tage lang aus. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch 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 Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job wird nicht benötigt. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Moyasar erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus einen geheimen Schlüssel hat: Test secret key im Testmodus, Live secret key im Live-Modus. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt. Der Kunde muss in SAR, AED, USD, EUR, KWD, BHD oder OMR bezahlen (der im Shop ausgewählten Währung). Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Die Bestätigungen haben Ihren Shop nicht erreicht. Richten Sie den Webhook ein: Prüfen Sie im Moyasar Dashboard, ob er existiert, ob seine URL genau der Webhook URL aus den Einstellungen entspricht, die Methode POST ist, alle vier Ereignisse ausgewählt sind und sein gemeinsames Geheimnis dem in Webhook shared secret gespeicherten entspricht. Die Bestellung erhält ihren Status auch dann, wenn der Kunde in den Shop zurückkehrt oder versucht, denselben Warenkorb erneut zu bezahlen.

Der Webhook antwortet Unauthorized: Das gemeinsame Geheimnis in Moyasar weicht vom gespeicherten ab. Tragen Sie das Geheimnis des Moyasar-Webhooks in Webhook shared secret ein und speichern Sie, oder setzen Sie das Häkchen bei Generate a new secret, speichern Sie und fügen Sie das angezeigte Geheimnis in Moyasar ein.

Der Webhook antwortet Webhook secret not configured: Es ist kein gemeinsames Geheimnis gespeichert, zum Beispiel nachdem es mit Clear the saved value on save entfernt wurde. Klicken Sie auf Save, um eines zu erzeugen, und kopieren Sie es nach Moyasar.

Der Webhook antwortet Key not configured: Die Rechnung wurde in einem Modus (Test oder Live) erstellt, dessen geheimer Schlüssel leer ist. Geben Sie diesen Schlüssel ein.

Der Webhook antwortet Verification failed oder Try again later: Die Rechnung konnte nicht über die Moyasar-API gelesen werden, der Warenkorb wurde im selben Moment von einer anderen Anfrage aktualisiert, oder der Bestellstatus konnte nicht gesetzt werden. Moyasar wiederholt den Webhook. Schalten Sie das Debug log ein, um den Grund zu sehen.

Die Webhook-URL zeigt im Browser Method not allowed: Das ist normal. Die URL akzeptiert nur POST-Anfragen von Moyasar.

Fehler beim Speichern wegen des Schlüssels: Es wurde ein öffentlicher Schlüssel (pk_...) oder ein Schlüssel des anderen Modus eingefügt, oder der Schlüssel enthält Leerzeichen. Der bisherige Wert wurde beibehalten. Testschlüssel beginnen mit sk_test_, Live-Schlüssel mit sk_live_.

Der Kunde sieht nach Confirm Order einen Fehler: Schalten Sie das Debug log ein und sehen Sie im Feld Log auf der Seite der Erweiterung nach. Die Meldung Diese Zahlungsart ist nicht verfügbar. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde: Der Kunde lädt die Kasse neu. Die Meldung Diese Zahlungsart ist vorübergehend nicht verfügbar. Bitte wählen Sie eine andere Zahlungsart oder kontaktieren Sie uns. deutet meist auf einen falschen oder fehlenden geheimen Schlüssel hin. Die Meldung Für diese Bestellung wurde bereits eine Zahlung empfangen und wird geprüft. Bitte kontaktieren Sie uns, statt erneut zu zahlen. bedeutet, dass der Warenkorb bereits eine bezahlte Rechnung hat, deren Bestellstatus nicht gesetzt werden konnte; prüfen Sie das Protokoll.

Die Bestellung ist nach der Zahlung im Wartestatus: Lesen Sie die Moyasar notes in der Registerkarte VibeFox Moyasar Payment Gateway. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung kam, nachdem die Bestellung storniert worden war. Bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Kein Erstattungsformular in der Registerkarte: Die Registerkarte nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, oder Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern.

Erstattung schlägt fehl: Lesen Sie die Meldung. Wurde die Zahlung im anderen Modus getätigt, geben Sie dessen geheimen Schlüssel ein. Ist der Betrag größer als der bei Moyasar noch erstattungsfähige Betrag, wurde ein Teil der Zahlung bereits erstattet, zum Beispiel im Moyasar Dashboard. Hat Moyasar den erstatteten Betrag nicht bestätigt, prüfen Sie die Zahlung im Moyasar Dashboard, bevor Sie es erneut versuchen.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse moyasar_p_supported_currencies und moyasar_p_invoice_params aus, um die unterstützten Währungen und die Rechnungsdaten zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Moyasar Payment Gateway auf Uninstall (die rote Schaltfläche −). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt außerdem immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus im Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 dessen Ereignisse und die Startaktion, die den Webhook im Wartungsmodus durchlässt). Ist Clean uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, gemeinsames Geheimnis des Webhooks, Debug-Protokoll) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Rechnungen, Zahlungen und Erstattungen von Moyasar werden immer aufbewahrt, sodass ältere Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Moyasar ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Moyasar verbunden und wird von Moyasar nicht unterstützt.