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

Internetzugang zu Ihrem Shop: MakeCommerce sendet Zahlungsbenachrichtigungen an Ihren Shop, daher muss die Website aus dem Internet erreichbar sein. Eine Firewall oder eine Basis-Authentifizierung kann sie blockieren. Der Wartungsmodus blockiert sie nicht: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die sie durchlässt.

MakeCommerce-Konto: Sie benötigen die Shop-ID und den geheimen Schlüssel (Secret key) aus dem MakeCommerce Merchant Portal (Settings > API). Test- und Live-Umgebung haben getrennte Konten und Schlüssel. Welche Zahlungsarten und Währungen verfügbar sind, legt Ihr Vertrag mit MakeCommerce fest. Währungen mit drei Dezimalstellen wie KWD oder BHD werden nicht angeboten.

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

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_makecommerce_payment-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_makecommerce_payment.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_makecommerce_payment-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 aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox MakeCommerce Payment und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

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

4. Geben Sie die Shop-ID und den Secret key der Testumgebung ein und, für echte Zahlungen, die Live-Schlüssel (siehe Konfiguration). Im Merchant Portal muss nichts eingestellt werden.

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung bei eingeschaltetem Test mode und schalten Sie ihn dann aus, um echte Zahlungen anzunehmen.

OpenCart 4

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

4. Geben Sie den Lizenzschlüssel und die MakeCommerce-Schlüssel ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Callback-URLs sind anders (siehe Zahlungsbenachrichtigungen).

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox MakeCommerce Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt die Seite bei eingeschaltetem Testmodus Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. an. Sie warnt, wenn die Zahlungsart aktiviert ist, aber die Shop-ID oder der Secret key der aktuellen Umgebung leer ist (die Zahlungsart wird dann in der Kasse ausgeblendet), und wenn die Standardwährung des Shops von MakeCommerce nicht belastet werden kann (die Zahlungsart wird dann für Bestellungen in dieser Währung ausgeblendet). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und nicht länger als 128 Zeichen, Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total eine Zahl größer oder gleich 0, und jeder Bestellstatus muss existieren. Ist ein Feld falsch, wird nichts gespeichert und die Seite nennt das Feld. Beim Speichern werden Leerzeichen aus Shop-IDs und Schlüsseln entfernt.

MakeCommerce

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

Title: der Name der Zahlungsart, den Kunden in der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Bank link or card (MakeCommerce). Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order über dem Bestätigungsbutton angezeigt wird. Standard: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

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

Geo Zone: bietet MakeCommerce nur für Zahlungsadressen in der gewählten Geo Zone an. 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 MakeCommerce angeboten wird. Lassen Sie das Feld leer, um MakeCommerce bei jedem Betrag anzubieten.

MakeCommerce-Konto

Shop-ID und Secret key finden Sie im MakeCommerce Merchant Portal unter Settings > API. Das Testportal und das Live-Portal haben getrennte Konten und Schlüssel. Der Abschnitt enthält Links zu beiden Portalen und zur Registrierungsseite von MakeCommerce.

Test mode: nutzt die Testumgebung von MakeCommerce (es wird kein echtes Geld belastet). Neue Zahlungen werden in der gewählten Umgebung mit deren Schlüsseln angelegt. Jede Bestellung merkt sich die Umgebung, in der sie bezahlt wurde: Statusabfragen und Erstattungen gehen immer dorthin. Ist die Option eingeschaltet, sehen Kunden im Schritt Confirm Order TEST MODE — MakeCommerce test environment, no real money is charged. Standard: ein.

Test Shop ID: die Shop-ID Ihres Testkontos im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Test Secret key: der Secret key Ihres Testkontos. Er signiert und überprüft die Zahlungsnachrichten.

Live Shop ID: die Shop-ID Ihres Live-Kontos im selben Format.

Live Secret key: der Secret key Ihres Live-Kontos.

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

Zahlungsbenachrichtigungen

Im Merchant Portal muss nichts eingestellt werden. Callback URLs zeigt zur Information die Adresse für die Rückkehr oder den Abbruch des Kunden und die Adresse für Zahlungsbenachrichtigungen. Sie werden aus der Shop-Adresse Ihrer OpenCart-Installation gebildet, zum Beispiel https://your-store/index.php?route=extension/payment/wcp_makecommerce_payment/notification bei OpenCart 3 und https://your-store/index.php?route=extension/wcp_makecommerce_payment/payment/wcp_makecommerce_payment.notification bei OpenCart 4. Jede Transaktion enthält eigene Rückkehr-, Abbruch- und Benachrichtigungs-URLs, die auf diesen Adressen mit der Bestellnummer und einem angehängten Schlüssel beruhen. MakeCommerce sendet eine signierte Nachricht an die Benachrichtigungs-URL (Server zu Server) und über den Browser des Kunden an die Rückkehr- oder Abbruch-URL. Die Signatur wird mit dem Secret key der Umgebung geprüft, in der die Transaktion erstellt wurde. Nachrichten ohne gültige Signatur werden abgelehnt.

Die Erweiterung verarbeitet diese MakeCommerce-Transaktionsstatus:

Die Zahlung wird auch bestätigt, wenn der Kunde in den Shop zurückkehrt. Kehrt der Kunde ohne signierte Nachricht zurück, fragt die Erweiterung den Status über die MakeCommerce-API ab.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält einen Status erst, nachdem MakeCommerce die Zahlung bestätigt hat (signierte Benachrichtigung oder Rückkehr des Kunden, über die MakeCommerce-API erneut geprüft). Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status nach einer geprüften MakeCommerce-Zahlung. Standard: In Bearbeitung.

Payment On Hold Status: die Zahlung braucht eine manuelle Prüfung: Der bezahlte Betrag oder die Währung weicht von der Bestellung ab, die Transaktion ist bei MakeCommerce noch nicht endgültig, oder das Geld ist für eine stornierte Bestellung eingegangen. Eine Notiz erklärt den Grund. Standard: Zahlung ausstehend, weil OpenCart keinen Status „Wartend“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Cancelled Order Status: der Status, der in Ihrem Shop „storniert“ bedeutet. Eine MakeCommerce-Zahlung, die für eine solche Bestellung eingeht, setzt sie auf Wartend. Die Erweiterung setzt diesen Status nie selbst. Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: protokolliert API-Aufrufe und Zahlungsbenachrichtigungen in wc_mkc_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert. 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: ist die Option aktiviert, entfernt das Deinstallieren der Erweiterung ihre Einstellungen und das Protokoll. Bestellungen und ihre MakeCommerce-Zahlungsdaten bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Shop-IDs und Secret keys werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Shop-IDs und Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Bank link or card (MakeCommerce)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung eine MakeCommerce-Transaktion über den Bestellbetrag in der Bestellwährung und schickt den Kunden zur Zahlungsseite von MakeCommerce. Dort wählt der Kunde eine Bank-Verbindung oder eine Karte. 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 Kasse auf Confirm Order. E-Mail-Adresse und Land des Kunden werden an MakeCommerce übergeben, und die Seite öffnet sich in der Shop-Sprache, wenn MakeCommerce sie unterstützt (Estnisch, Englisch, Lettisch, Litauisch, Finnisch, Russisch, Deutsch, Polnisch), andernfalls auf Englisch.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn MakeCommerce sie bestätigt: durch die signierte Benachrichtigung oder die signierte Rückkehr des Kunden, mit einer Prüfung der Transaktion über die MakeCommerce-API. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Art, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite von OpenCart mit Your MakeCommerce payment has been received. Ist die Bestellung in den Prüfstatus gekommen, zeigt die Seite Your MakeCommerce payment was received and is being reviewed by the store.

Ist die Zahlung genehmigt, aber noch nicht abgeschlossen, wird die Bestellung gerade durch eine andere Anfrage bestätigt, oder ist MakeCommerce nicht erreichbar, zeigt eine Seite Payment confirmation die Meldung We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. mit den Schaltflächen Check again und Back to checkout. Check again fragt bei MakeCommerce den Status der letzten Transaktionen der Bestellung ab. Die Benachrichtigung setzt den Bestellstatus, sobald die Zahlung abgeschlossen ist.

Bricht der Kunde auf der Seite von MakeCommerce ab, oder läuft die Zahlung ab oder schlägt sie fehl, kehrt der Kunde zur Kasse zurück, mit einer Meldung, zum Beispiel The payment was cancelled. You can try again or choose another payment method., The payment session expired. Please try again. oder The payment was not completed. Please try again or choose another payment method. Auf OpenCart 4 werden diese Meldungen über der Kasse angezeigt. Der Warenkorb bleibt erhalten, und der Kunde kann erneut bezahlen. Jeder Versuch ist eine neue MakeCommerce-Transaktion (OpenCart 3 legt außerdem jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 behält eine Bestellung für die Kasse und bezahlt dieselbe Bestellung erneut). Vor einer neuen Transaktion werden die offenen Versuche desselben Warenkorbs bei MakeCommerce geprüft: Ist einer davon bereits bezahlt, geht der Kunde direkt zur Erfolgsseite. Ein älterer Zahlungslink desselben Warenkorbs funktioniert weiterhin, aber ein Warenkorb wird nie in zwei Bestellungen bezahlt: Eine späte Zahlung zu einer älteren Bestellung eines bereits bezahlten Warenkorbs fügt der bezahlten Bestellung nur eine Notiz hinzu.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung ohne Zahlung geschlossen (zum Beispiel haben Sie sie 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ück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Eine solche Bestellung hält den Warenkorb nicht mehr, auch wenn sie bezahlt und danach storniert wurde.

Kann MakeCommerce die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. oder MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. Der technische Grund wird in das Protokoll geschrieben.

Die Bank oder die Karte wird auf der Seite von MakeCommerce gewählt, nicht in Ihrer Kasse. Die Erweiterung kennt keine gespeicherten Karten, wiederkehrenden Zahlungen oder Abonnements und keinen Versand über MakeCommerce (Paketstationen, Etiketten).

Bestellungen und Erstattungen

Bestellstatus

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

Order Status After Payment (Standard In Bearbeitung): die Zahlung wurde bestätigt. Eine Notiz zeigt den Betrag, die Transaktion, die Umgebung und wie die Zahlung geprüft wurde (MakeCommerce-API oder signierte Benachrichtigung).

Payment On Hold Status (Standard Zahlung ausstehend): der bezahlte Betrag oder die Währung weicht von der Bestellung ab, der Betrag fehlte, die Transaktion war bei MakeCommerce noch nicht endgültig, obwohl sie als abgeschlossen gemeldet wurde, oder die Zahlung kam an, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Eine Transaktion mit Abweichung bezahlt die Bestellung nie nachträglich; eine Transaktion, die noch nicht endgültig war, schließt die Bestellung ab, sobald MakeCommerce sie als abgeschlossen meldet. Prüfen Sie die Transaktion im Merchant Portal und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

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

Geht eine zweite Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, das Duplikat im MakeCommerce Merchant Portal zu erstatten. Eine Zahlung für eine erstattete Bestellung oder für eine Bestellung, die auf eine andere Zahlungsart umgestellt wurde, fügt nur eine Notiz hinzu.

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

Tab VibeFox MakeCommerce Payment

Öffnen Sie unter Sales > Orders eine Bestellung, die mit MakeCommerce bezahlt wurde. Unten auf der Bestellseite, neben History und Additional, zeigt der Tab VibeFox MakeCommerce Payment alle MakeCommerce-Transaktionen der Bestellung (Datum, Transaktions-ID, bei Testzahlungen die Markierung Test, Betrag, MakeCommerce-Status und Ergebnis), die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die MakeCommerce notes der Bestellung. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; seine Schaltflächen benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Check MakeCommerce payment status: fragt bei der MakeCommerce-API den Status der Transaktionen der Bestellung ab (die neueste zuerst), übernimmt ihn und fügt eine Notiz mit dem Ergebnis hinzu. Verwenden Sie dies, wenn ein Kunde sagt, er habe bezahlt, die Bestellung aber keinen Status hat.

Erstattungen

Geben Sie im Tab VibeFox MakeCommerce Payment den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via MakeCommerce. Bestätigen Sie die Frage Refund this amount via MakeCommerce? Vollständige und teilweise Erstattungen werden unterstützt. Erstattungen sind auf Betrag und Währung der MakeCommerce-Transaktion begrenzt; nach einer Betragsabweichung können Sie also bis zu dem erstatten, was der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Test oder Live), daher müssen deren Schlüssel gesetzt sein. Der Grund wird als Erstattungskommentar an MakeCommerce übermittelt; ohne Grund lautet der Kommentar Refund for order und die Bestellnummer. Lehnt MakeCommerce die Erstattung ab, zeigt der Tab den Fehler, es wird eine Notiz hinzugefügt und keine Erstattung erfasst. Verarbeitet MakeCommerce die Zahlung noch, lautet die Meldung MakeCommerce is still processing this payment — try the refund again later. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit der MakeCommerce-Erstattungs-ID hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte wieder in den Bestand zu buchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald MakeCommerce die Zahlung bestätigt hat.

Produktrücksendungen unter Sales > Returns schicken kein Geld über MakeCommerce zurück.

Im Merchant Portal vorgenommene Erstattungen kommen mit dem Transaktionsstatus an und werden den Notizen hinzugefügt. Der Bestellstatus wird nicht automatisch geändert.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox MakeCommerce Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox MakeCommerce Payment > 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 zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-makecommerce 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 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 gilt 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 MakeCommerce Kunden in 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 selben Browser im Admin angemeldet ist, sieht die Zahlungsart 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 gibt es diese Vorschau nicht: Der Shop sieht die Admin-Anmeldung nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint im Admin-Dashboard eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: bereits begonnene Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern aber 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. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

MakeCommerce erscheint nicht in der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die aktuelle Umgebung ihre Schlüssel hat: Test Shop ID und Test Secret key im Testmodus, Live Shop ID und Live Secret key im Live-Modus. Prüfen Sie, ob die Bestellwährung höchstens zwei Dezimalstellen hat, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ging durch, aber die Bestellung bleibt ohne Status: die Benachrichtigungen konnten den Shop nicht erreichen, zum Beispiel wegen einer Firewall oder einer Basis-Authentifizierung. Die Bestellung erhält ihren Status auch, wenn der Kunde in den Shop zurückkehrt oder auf Check again klickt, und wenn Sie im Bestell-Tab auf Check MakeCommerce payment status klicken. Prüfen Sie, ob die Schlüssel der Umgebung, in der die Zahlung erfolgte, gesetzt sind: Die Benachrichtigung wird mit dem Secret key dieser Umgebung geprüft, und ohne ihn erhält MakeCommerce einen Fehler und versucht es erneut. Aktivieren Sie Debug log, um die Benachrichtigungen zu sehen.

Die Bestellung ist im Prüfstatus: lesen Sie die MakeCommerce notes im Bestell-Tab (siehe Bestellstatus), prüfen Sie die Transaktion im Merchant Portal und bearbeiten Sie danach die Bestellung oder erstatten Sie die Zahlung.

Benachrichtigungen werden abgelehnt: eine Nachricht mit falscher Signatur, für eine andere Bestellung, einen anderen Shop oder eine Transaktion, die nicht für diese Bestellung erstellt wurde, wird abgelehnt, und es wird nichts geändert. Prüfen Sie, ob Shop-ID und Secret key zum selben MakeCommerce-Konto und zur selben Umgebung gehören.

Der Kunde sieht nach Confirm Order einen Fehler: aktivieren Sie Debug log und sehen Sie im Feld Log auf der Erweiterungsseite nach. This payment method is not available. Please reload the checkout page. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde: Der Kunde lädt die Kasse neu. Eine Währung, die MakeCommerce nicht belasten kann, ergibt MakeCommerce cannot process payments in und den Währungscode.

Erstattung schlägt mit einer Meldung zur Umgebung fehl: die Bestellung wurde in der Test- oder Live-Umgebung bezahlt, und die Schlüssel dieser Umgebung sind nicht eingerichtet. Geben Sie sie ein und versuchen Sie es erneut.

Kein Erstattungsformular im Tab: der Tab nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, die Bestellung wurde auf eine andere Zahlungsart umgestellt, oder die Schlüssel der Zahlungsumgebung sind nicht gesetzt.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse wc_mkc_transaction_data, wc_mkc_customer_data, wc_mkc_supported_locales und wc_mkc_is_available aus, um die Transaktionsdaten, die Kundendaten, die Sprachen der Zahlungsseite und die Verfügbarkeit der Zahlungsart zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox MakeCommerce Payment auf Uninstall (der rote −-Button). 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 Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 zusätzlich deren Ereignisse und Startup-Aktion, die Benachrichtigungen im Wartungsmodus durchlässt). Ist Delete data aktiviert, werden die übrigen Einstellungen (Titel, Beschreibung, Testmodus, Shop-IDs, Secret keys, Debug-Protokoll) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die MakeCommerce-Transaktionen und -Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation noch erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

MakeCommerce ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist weder mit MakeCommerce verbunden noch von MakeCommerce unterstützt.