VibeFox PayMongo 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: philippinischer Peso (PHP). PayMongo wird in der Kasse nur angezeigt, wenn der Kunde in PHP bezahlt und die Summe mindestens 100,00 ₱ beträgt. Fügen Sie die Währung unter System > Localisation > Currencies hinzu, falls Ihr Shop sie noch nicht hat. Wenn die Standardwährung Ihres Shops nicht PHP ist, warnt Sie die Einstellungsseite, und Kunden müssen auf PHP wechseln, um PayMongo zu sehen.

PayMongo-Konto: Sie benötigen die geheimen API-Schlüssel Ihres PayMongo-Kontos und einen Webhook für jeden Modus (siehe Konfiguration). Verwendet werden nur die geheimen Schlüssel (sk_test_..., sk_live_...) und die Signatur-Geheimnisse der Webhooks (whsk_...). Öffentliche Schlüssel werden nicht benötigt, da die Zahlungsseite von PayMongo gehostet wird. Die von Ihnen angebotenen Zahlungsmethoden müssen für Ihr PayMongo-Konto aktiviert sein.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel funktioniert auf einer 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 Paket für OpenCart 3 wcp_paymongo_payment_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_paymongo_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_paymongo_payment_gateway-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie den Inhalt des Ordners upload dieses Pakets auch in das Stammverzeichnis Ihres Shops kopieren.

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

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

4. Fügen Sie Ihre geheimen PayMongo-Schlüssel ein, erstellen Sie die Webhooks in PayMongo und fügen Sie deren Signatur-Geheimnisse ein (siehe Konfiguration).

5. Wählen Sie die Zahlungsmethoden aus, aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung bei eingeschaltetem Test mode und schalten Sie ihn danach wieder aus.

OpenCart 4

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

4. Geben Sie den Lizenzschlüssel, die PayMongo-Schlüssel, die Webhooks und die Zahlungsmethoden 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 anders (siehe Webhook).

Eine neue Installation startet mit ausgeschalteter Zahlungsmethode und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn die Standardwährung des Shops nicht PHP ist, wenn für den aktuellen Modus kein geheimer Schlüssel (dann wird PayMongo in der Kasse nicht angezeigt) oder kein Webhook-Geheimnis hinterlegt ist (dann werden Zahlungen nur bestätigt, wenn der Kunde in Ihren Shop zurückkehrt). Solange der Testmodus eingeschaltet ist, zeigt sie Test mode is on: no real payments are made. an.

Beim Speichern darf Title nicht leer sein (bis zu 128 Zeichen), Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total eine Zahl größer oder gleich 0, und die gewählte Geozone sowie die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert, und die Seite nennt das Feld. Ein Schlüssel mit falschem Präfix wird nicht gespeichert, die übrigen Felder aber schon (siehe API-Schlüssel).

PayMongo

Enable/Disable: Enable PayMongo schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden in der Kasse sehen. Er wird auch als Zahlungsmethode in der Bestellung gespeichert. Standard: PayMongo (Card, GCash, GrabPay, Maya). Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, den Kunden im Schritt Confirm Order über der Bestätigungsschaltfläche sehen. Standard: You will be redirected to PayMongo to pay securely with your card, GCash, GrabPay or Maya.

Payment methods: die auf der PayMongo-Zahlungsseite angebotenen Methoden. Wählen Sie nur Methoden, die für Ihr PayMongo-Konto aktiviert sind, sonst lehnt PayMongo die Zahlung ab. Wenn keine ausgewählt ist, gelten die Standardwerte. Standard: Cards, GCash, GrabPay und Maya.

Sort Order: die Position von PayMongo unter den Zahlungsmethoden in der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: PayMongo nur für Zahlungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor PayMongo angeboten wird, zusätzlich zum PayMongo-Mindestbetrag von 100,00 ₱. Lassen Sie das Feld leer, wenn kein zusätzliches Minimum gelten soll.

API-Schlüssel

Kopieren Sie die geheimen Schlüssel aus PayMongo Dashboard > Developers > API keys (dort sind auch Links zu diesem Bereich). Öffentliche Schlüssel werden nicht benötigt. Jeder Schlüssel muss mit dem erwarteten Präfix beginnen. Ein Wert mit falschem Präfix, zum Beispiel ein Live-Schlüssel in einem Testfeld, wird nicht gespeichert: Die Seite zeigt, dass das Feld mit dem Präfix beginnen muss, und The previous value was kept.

Test mode: Enable test mode (no real payments). Neue Zahlungen verwenden die Testschlüssel. Frühere Zahlungen behalten den Modus, in dem sie erfolgt sind, sodass Statusprüfungen und Erstattungen den passenden Schlüssel verwenden. Standard: ein. Schalten Sie ihn aus, um echte Zahlungen anzunehmen. Solange er eingeschaltet ist, sieht der Kunde im Schritt Confirm Order den Hinweis Test mode: no real payment will be made.

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

Test webhook secret: das Signatur-Geheimnis des Webhooks im Testmodus. Es beginnt mit whsk_.

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

Live webhook secret: das Signatur-Geheimnis des Webhooks im Live-Modus. Es beginnt mit whsk_.

Gespeicherte Schlüssel und Geheimnisse 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 value on save und klicken Sie auf Save.

Webhook

Der Webhook meldet Ihrem Shop, dass eine Zahlung erfolgt ist, auch wenn der Kunde nach dem Bezahlen den Browser schließt. Erstellen Sie im PayMongo Dashboard (oder über die PayMongo-API) für jeden Modus, Test und Live, einen Webhook mit der URL, die unter Webhook URL in diesem Abschnitt angezeigt wird. Bei OpenCart 3 hat sie folgende Form: https://your-store/index.php?route=extension/payment/wcp_paymongo_payment_gateway/webhook, bei OpenCart 4: https://your-store/index.php?route=extension/wcp_paymongo_payment_gateway/payment/wcp_paymongo_payment_gateway.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.

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

Kopieren Sie das Signatur-Geheimnis (whsk_...) jedes Webhooks in Test webhook secret oder Live webhook secret. Webhooks ohne gültige Signatur werden abgelehnt. Die Signatur wird mit dem Geheimnis des eigenen Modus geprüft, und der Modus des Ereignisses muss dazu passen, sodass ein Test-Webhook nie eine Live-Zahlung bestätigt. Jedes Ereignis wird vor einer Änderung der Bestellung über die PayMongo-API noch einmal mit dem geheimen Schlüssel des Modus der Zahlung geprüft. Ereignisse zu Zahlungen, die in diesem Shop nicht gestartet wurden, werden ignoriert. Ohne Webhook wird eine Bestellung nur bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst einen Status, nachdem PayMongo die Zahlung bestätigt hat. OpenCart hat keinen Status „On hold“: Standardmäßig sind der Status für ausstehende Zahlungen und der für zurückgehaltene Zahlungen beide Ausstehend; der Reiter PayMongo und die Bestellnotizen unterscheiden beide. Eigene Status können Sie unter System > Localisation > Order Statuses anlegen und hier auswählen. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order status after payment: der Status nach einer erfolgreichen Zahlung. Standard: In Bearbeitung. Complete eignet sich für virtuelle oder herunterladbare Produkte, die keinen Versand benötigen.

Awaiting PayMongo payment: der Kunde hat auf der PayMongo-Seite abgeschlossen, die Zahlung wird aber noch verarbeitet (zum Beispiel Online-Banking). Der Webhook oder die nächste Prüfung schließt die Bestellung ab. Standard: Ausstehend.

PayMongo payment on hold: eine Abweichung bei Betrag oder Währung, eine Testzahlung in einem Live-Shop oder eine Zahlung, die nach der Stornierung der Bestellung eingegangen ist. Eine Notiz erklärt den Grund. Standard: Ausstehend.

Failed status: eine ausstehende Zahlung ist später fehlgeschlagen (payment.failed). Ein fehlgeschlagener Versuch bei einer Bestellung ohne Status lässt sie ohne Status, und der Kunde kann erneut bezahlen. Standard: Fehlgeschlagen.

Cancelled status: der Status, den Sie einer stornierten Bestellung geben. Eine später eingehende Zahlung setzt die Bestellung in den Status „On hold“, statt sie abzuschließen. Standard: Storniert.

Refunded status: wird gesetzt, nachdem die Zahlung im Reiter der Bestellung vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: protokolliert PayMongo-API-Aufrufe und Webhook-Ereignisse in paymongo_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen. Fehler und Warnungen werden immer protokolliert, auch wenn der Schalter aus ist. Schlüssel 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: ist die Option eingeschaltet, löscht die Deinstallation der Erweiterung die Einstellungen des Gateways und das Protokoll. Die für Bestellungen und Erstattungen gespeicherten PayMongo-IDs bleiben immer erhalten, weil sie für Erstattungen und die Buchhaltung gebraucht werden. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig PayMongo (Card, GCash, GrabPay, Maya)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis After you confirm the order you will be redirected to PayMongo to complete the payment. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Auf OpenCart 4 wählt der Kunde die Zahlungsmethode mit der Schaltfläche Choose im Block der Zahlungsmethode im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine PayMongo-Checkout-Sitzung für die Bestellsumme in PHP, mit einer Position Order # und der Bestellnummer, und leitet den Kunden zur PayMongo-Zahlungsseite weiter. Name, E-Mail-Adresse, Telefonnummer und Rechnungsadresse des Kunden werden an PayMongo übergeben. Dort wählt der Kunde eine der ausgewählten Methoden und bezahlt. Eine Notiz zur Bestellung hält die PayMongo-Checkout-Sitzung fest.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn PayMongo die Zahlung bestätigt: Die Erweiterung fragt die PayMongo-API nach der Zahlung, wenn der Kunde zurückkehrt, und wenn der Webhook eintrifft. Die Bestellung erhält dann ihren Status auf die übliche OpenCart-Weise mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die OpenCart-Erfolgsseite mit Your PayMongo payment has been received. Wenn PayMongo die Zahlung noch verarbeitet, wenn der Kunde zurückkehrt, erhält die Bestellung den Status für ausstehende Zahlungen, und die Seite zeigt PayMongo is still processing your payment. Your order will be updated as soon as PayMongo confirms it — please do not pay again. Bei einer zurückgehaltenen Bestellung zeigt sie Your payment was received and is being reviewed. We will update your order shortly. Wenn PayMongo nicht erreicht werden kann, wenn der Kunde zurückkehrt, sagt eine Seite Payment confirmation: Your payment is being confirmed by PayMongo. You will receive an e-mail as soon as it is confirmed — please do not pay again. mit einer Schaltfläche Check again; der Webhook setzt den Bestellstatus, sobald er eintrifft. Wenn eine Bestellung vom Status für ausstehende Zahlungen auf bezahlt oder auf den Status für Zahlungsfehler wechselt, erhält der Kunde die übliche OpenCart-E-Mail zur Statusänderung.

Bricht der Kunde auf der PayMongo-Seite ab oder schließt er die Zahlung nicht ab, gelangt er zurück zur Kasse mit You cancelled the PayMongo payment. You can try again or choose another payment method. oder Your PayMongo payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. Auf OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt. Ein neuer Versuch (OpenCart 3 legt bei jeder Anzeige des Schritts Confirm Order eine neue Bestellung an; OpenCart 4 aktualisiert die Bestellung der Kasse) prüft zuerst den vorherigen: Wurde er inzwischen bezahlt, wird die Zahlung ohne eine neue bestätigt; andernfalls läuft der vorherige PayMongo-Zahlungslink ab, sodass der Warenkorb nicht zweimal bezahlt werden kann. Solange die vorherige Zahlung noch verarbeitet wird, sieht der Kunde Your previous PayMongo payment for this order is still being processed. Please wait a few minutes before trying again. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder wartet auf Zahlung, wird der Kunde zur Erfolgsseite geleitet. Eine Änderung des Warenkorbs, auch eine neue Menge, zählt als neuer Warenkorb, der eine eigene Zahlung braucht.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel von Ihnen storniert) oder für einen anderen Warenkorb bezahlt, wird der Kunde mit der Meldung Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. zurück zur Kasse geschickt. Das nächste Confirm Order bezahlt eine neue Bestellung. Eine bezahlte Bestellung wird nie als bezahlt für einen anderen Warenkorb angezeigt.

Wenn PayMongo die Zahlung nicht starten kann, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel The payment could not be started. Please try again or choose another payment method. oder PayMongo could not be reached. Please try again in a moment. Der technische Grund wird im Protokoll festgehalten.

Der Webhook funktioniert auch, wenn der Shop im Wartungsmodus ist, weil OpenCart Anfragen von Zahlungserweiterungen durchlässt (auf OpenCart 4 fügt die Erweiterung dafür eine eigene Startaktion hinzu, die auch die Rückkehr des Kunden von PayMongo durchlässt).

Die Erweiterung nimmt Einmalzahlungen auf der PayMongo-Seite an. Auf Ihrer eigenen Kassenseite gibt es keine Kartenfelder, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen, keine Ratenzahlungen und keine getrennte Autorisierung und Erfassung.

Bestellungen und Erstattungen

Bestellstatus

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

Bestellstatus nach Zahlung (Standard In Bearbeitung): die Zahlung wurde bestätigt. Eine Notiz zeigt die PayMongo-Zahlung, den Betrag, die Methode, den Modus und wie sie bestätigt wurde (Webhook, Rückkehr oder erneuter Zahlungsversuch).

PayMongo-Zahlung ausstehend (Standard Ausstehend): der Kunde ist zurückgekehrt, während PayMongo die Zahlung noch verarbeitete. Die Bestellung wechselt in den bezahlten Status, sobald PayMongo die Zahlung bestätigt.

PayMongo-Zahlung zurückgehalten (Standard Ausstehend): der bezahlte Betrag oder die Währung weicht von der Bestellsumme ab; oder eine Zahlung wurde im Testmodus getätigt, während der Shop im Live-Modus ist, sodass kein Geld eingegangen ist; oder die Zahlung ist nach der Stornierung der Bestellung eingegangen. Die Notiz erklärt es. Prüfen Sie die Bestellung und bearbeiten Sie sie oder erstatten Sie die Zahlung.

Status Fehlgeschlagen (Standard Fehlgeschlagen): ein signierter Webhook payment.failed meldete, dass der letzte Zahlungsversuch einer ausstehenden Bestellung fehlgeschlagen ist. Die Notiz zeigt den PayMongo-Fehlercode und die Meldung. Gelingt dieselbe Zahlung später, wechselt die Bestellung in den bezahlten Status.

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

Geht eine zweite Zahlung für eine bereits bezahlte Bestellung oder für eine andere Bestellung eines bereits bezahlten Warenkorbs ein, bleibt die bezahlte Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im PayMongo Dashboard zu erstatten. Eine Bestellung, die bezahlt und dann storniert oder erstattet wurde, wird nie wieder geöffnet.

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

Reiter VibeFox PayMongo Payment Gateway

Öffnen Sie unter Sales > Orders eine mit PayMongo bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox PayMongo Payment Gateway die PayMongo payment, die PayMongo payment intent, den PayMongo checkout, den PayMongo mode mit einem Hinweis Test mode für Testzahlungen, den Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox PayMongo Payment Gateway den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via PayMongo. Bestätigen Sie die Frage Refund this amount through PayMongo? This cannot be undone. Vollständige und teilweise Erstattungen sind möglich, mit höchstens zwei Dezimalstellen. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen sind auf den Betrag begrenzt, den PayMongo tatsächlich eingezogen hat; nach einer Betragsabweichung können Sie also nur bis zu dem erstatten, was der Kunde bezahlt hat, nicht bis zur Bestellsumme. Die Erstattung wird mit dem geheimen Schlüssel des Modus gesendet, in dem die Zahlung erfolgte (Test oder Live), daher muss dieser Schlüssel hinterlegt sein. Akzeptiert PayMongo die Erstattung nicht, zeigt der Reiter den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der PayMongo-Erstattungs-ID und dem Status hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über PayMongo. Erstattungen, die im PayMongo Dashboard vorgenommen werden, werden nicht an OpenCart gemeldet. Erstatten Sie stattdessen über den Reiter der Bestellung oder aktualisieren Sie die Bestellung manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayMongo Payment Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit, oberhalb der Einstellungen. Geben 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-paymongo 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 Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse 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 auf einer Domain: der 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 PayMongo Kunden in der Kasse nicht angezeigt. Versucht trotzdem jemand, eine Zahlung zu starten, 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 Zahlungsmethode im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsmethode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

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

Fehlerbehebung

PayMongo erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus einen geheimen Schlüssel hat (Test secret key im Testmodus, Live secret key im Live-Modus), der Kunde in PHP bezahlt und die Summe mindestens 100,00 ₱ beträgt. 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 ging durch, aber die Bestellung bleibt ohne Status: Der Webhook funktioniert nicht, und der Kunde ist nicht in den Shop zurückgekehrt. Prüfen Sie im PayMongo Dashboard, ob im verwendeten Modus ein Webhook existiert, ob seine URL genau der unter Webhook URL angezeigten entspricht und ob die drei Ereignisse ausgewählt sind. Prüfen Sie, ob sein Signatur-Geheimnis im passenden Feld steht (Test webhook secret oder Live webhook secret).

Der Webhook antwortet Invalid signature: Das Signatur-Geheimnis dieses Modus fehlt oder gehört zu einem anderen Webhook. Fügen Sie das Signatur-Geheimnis des Webhooks in das Feld seines Modus ein.

Der Webhook antwortet Mode mismatch: Ein Testereignis wurde als Live-Ereignis signiert oder umgekehrt. Prüfen Sie, dass jeder Webhook zum richtigen Modus gehört.

Der Webhook antwortet Temporary error: Die Zahlung konnte nicht über die PayMongo-API geprüft werden, zum Beispiel weil der geheime Schlüssel des Zahlungsmodus fehlt. PayMongo wiederholt den Webhook automatisch.

Der Webhook antwortet Busy, retry: Die Bestellung wurde gerade von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. PayMongo wiederholt den Webhook automatisch. Der Grund steht im Log.

Der Webhook antwortet Ignored: Das Ereignis gehört zu einer Zahlung, die in diesem Shop nicht gestartet wurde, oder zu einem anderen Modus. Es wird nichts geändert.

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

Der Wert wurde nicht gespeichert: Ein Schlüssel wurde in das falsche Feld eingefügt. Geheime Schlüssel beginnen mit sk_test_ oder sk_live_, Webhook-Geheimnisse mit whsk_.

Der Kunde sieht nach Confirm Order einen Fehler: Sehen Sie im Feld Log auf der Seite der Erweiterung nach. Ein falscher geheimer Schlüssel führt zur Meldung, dass die Zahlungsmethode vorübergehend nicht verfügbar ist. Eine Zahlungsmethode, die für Ihr PayMongo-Konto nicht aktiviert ist, führt zur Ablehnung der Zahlung durch PayMongo; entfernen Sie sie unter Payment methods. This payment method is not available. Please reload the checkout page. bedeutet, dass die Checkout-Sitzung nicht mehr zur Bestellung passt oder die Zahlungsmethode inzwischen deaktiviert wurde.

Testzahlungen in einem Live-Shop: Eine Testzahlung, die im Live-Modus des Shops eingeht, setzt die Bestellung in den Status „On hold“ mit einer Notiz, dass kein Geld eingegangen ist. Echte Zahlungen werden immer erkannt, auch nach dem Wechsel zurück in den Testmodus, und mit dem Live-Schlüssel erstattet.

Die Bestellung ist nach der Zahlung im Status „On hold“: Lesen Sie die Notizen im Reiter VibeFox PayMongo Payment Gateway (siehe Bestellstatus) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Kein Erstattungsformular im Reiter: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, oder Ihre Benutzergruppe darf die Erweiterung nicht ändern.

Erstattung schlägt mit einer Meldung zum Modus fehl: Die Zahlung erfolgte im Test- oder Live-Modus, und der geheime Schlüssel dieses Modus ist nicht hinterlegt. Geben Sie ihn ein und versuchen Sie es erneut.

Für Entwickler: Bevor die Checkout-Sitzung erstellt wird, löst die Erweiterung das OpenCart-Ereignis paymongo_p_checkout_session_data mit den Sitzungsdaten und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox PayMongo Payment Gateway auf Uninstall (die rote Schaltfläche −). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus aus dem Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 seine Ereignisse und seine Startaktion, die Webhook und Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Zahlungsmethoden, Testmodus, Schlüssel, Webhook-Geheimnisse, Protokollierung) und das Protokoll gelöscht. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die PayMongo-IDs der Bestellungen und Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Auf OpenCart 4 entfernen Sie zusätzlich die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie neben VibeFox PayMongo Payment Gateway in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene Schaltfläche −) und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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