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

KOMOJU-Konto: Sie benötigen den geheimen Schlüssel (sk_live_... und für den Testmodus sk_test_...) und das geheime Token eines Webhooks, der im KOMOJU-Dashboard angelegt wurde (siehe Konfiguration). Der öffentliche Schlüssel wird nicht benötigt. KOMOJU muss die Webhook-URL Ihres Shops erreichen können.

Bestellwährung: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD oder VND. Bei Bestellungen in anderen Währungen wird die Zahlungsart ausgeblendet.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert 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_komoju_payment-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_komoju_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_komoju_payment-oc3-(version).ocmod.zip. 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 aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments, suchen Sie VibeFox KOMOJU Payment und 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 Stift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in das Feld License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Fügen Sie im KOMOJU-Dashboard einen Webhook mit der URL und den Ereignissen aus dem Abschnitt Webhook URL hinzu und kopieren Sie dessen geheimes Token (siehe Konfiguration).

5. Geben Sie den geheimen Live-Schlüssel und das geheime Live-Webhook-Token sowie die Testschlüssel für den Sandbox-Modus ein. Aktivieren Sie Enable/Disable und klicken Sie auf Save.

OpenCart 4

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

4. Geben Sie den Lizenzschlüssel, das Webhook und die 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 Webhook-URL ist anders (siehe Webhook-URL).

Eine Neuinstallation startet mit deaktivierter Zahlungsart und deaktiviertem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite KOMOJU Sandbox Mode is enabled., solange der Testmodus eingeschaltet ist. Sie warnt, wenn der aktuelle Modus keinen geheimen Schlüssel hat (die Zahlungsart wird dann an der Kasse ausgeblendet) oder kein geheimes Webhook-Token (KOMOJU-Benachrichtigungen werden dann abgelehnt, sodass Konbini- und Banküberweisungszahlungen nie bestätigt werden), und wenn KOMOJU die Standardwährung des Shops nicht unterstützt (die Zahlungsart wird dann für Bestellungen in dieser Währung ausgeblendet). Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title höchstens 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 Geozone und Bestellstatus müssen vorhanden sein. Andernfalls wird nichts gespeichert, und die Seite nennt das betreffende Feld. Fehlende Schlüssel verhindern das Speichern nicht.

KOMOJU-Zahlung

Enable/Disable: Enable KOMOJU Payment Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: KOMOJU Payment. Bleibt das Feld leer, wird der Standardname verwendet. Maximal 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

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

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

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

Live-API-Schlüssel

Die Schlüssel finden Sie im KOMOJU-Dashboard (dort sind die Links zu den Abschnitten): den geheimen Schlüssel unter Settings > API keys, das geheime Webhook-Token unter Settings > Webhooks (fügen Sie dort zuerst die Webhook-URL aus dem Abschnitt Webhook URL hinzu).

Live Secret Key: Ihr geheimer KOMOJU-Live-Schlüssel. Er beginnt mit sk_live_.

Live Webhook Secret Token: das geheime Token des Live-Webhooks. Es wird verwendet, um die Signatur jeder Benachrichtigung zu prüfen.

Testmodus

KOMOJU verwendet dieselbe API-Adresse für Test- und Live-Zahlungen: Der Schlüssel entscheidet. Zahlungen behalten den Modus, in dem sie getätigt wurden, daher verwenden Erstattungen und Statusabfragen einer Bestellung immer den Schlüssel dieses Modus.

Sandbox Mode: Enable test mode (use the test keys below, no real payments). Standard: aus. Solange er eingeschaltet ist, zeigt der Schritt Confirm Order über der Beschreibung Test mode an.

Sandbox Secret Key: Ihr geheimer KOMOJU-Testschlüssel. Er beginnt mit sk_test_.

Sandbox Webhook Secret Token: das geheime Token des Webhooks für den Testmodus.

Gespeicherte Schlüssel und Token werden nie erneut angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. 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-URL

Der Webhook informiert Ihren Shop über Zahlungen, einschließlich verzögerter Konbini- und Banküberweisungszahlungen. Fügen Sie im KOMOJU-Dashboard unter Settings > Webhooks die URL aus diesem Abschnitt hinzu, und zwar für den Live-Modus und für den Testmodus. Auf OpenCart 3 hat sie die Form https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook, auf OpenCart 4 die Form https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Kopieren Sie dann das geheime Token jedes Webhooks in Live Webhook Secret Token beziehungsweise Sandbox Webhook Secret Token.

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

Abgelaufene, stornierte und fehlgeschlagene Ereignisse ändern eine Bestellung nur für ihre aktuelle Zahlung, sodass eine Zahlung eines früheren Versuchs keine Bestellung stornieren kann, die auf andere Weise bezahlt wird. Webhooks ohne gültige Signatur werden abgelehnt. Webhooks, die mit einem der beiden geheimen Token signiert sind, werden akzeptiert, aber nur für Zahlungen desselben Modus. Ohne den Webhook werden Kartenzahlungen weiterhin bestätigt, wenn der Kunde in den Shop zurückkehrt, Konbini- und Banküberweisungszahlungen dagegen nie.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Einen Status erhält sie erst, nachdem KOMOJU die Zahlung bestätigt hat. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: die Zahlung wurde erfasst, und Betrag und Währung wurden geprüft. Standard: In Bearbeitung.

Awaiting KOMOJU Payment Status: die Zahlung ist autorisiert: Ein Konbini-Beleg oder eine Banküberweisung wurde ausgestellt, oder die Zahlung wartet im KOMOJU-Dashboard auf die Erfassung. Standard: Zahlung ausstehend.

KOMOJU Payment On Hold Status: der gezahlte Betrag oder die Währung weicht von der Bestellung ab, oder die Zahlung ist nach der Stornierung der Bestellung eingegangen. Eine Notiz erklärt den Grund. Standard: Zahlung ausstehend, da OpenCart keinen Status „Zurückgehalten“ hat.

Cancelled Payment Status: die Zahlung einer wartenden Bestellung ist abgelaufen oder wurde storniert, zum Beispiel wenn der Konbini-Beleg nicht rechtzeitig bezahlt wurde. Standard: Storniert.

Failed Payment Status: die Zahlung einer wartenden Bestellung ist fehlgeschlagen. Standard: Fehlgeschlagen.

Refunded Status: wird gesetzt, nachdem die Zahlung vollständig erstattet wurde, entweder auf der Bestellseite oder im KOMOJU-Dashboard. Standard: Erstattet.

Sie können eigene Status anlegen, zum Beispiel Awaiting KOMOJU payment oder On hold, unter System > Localisation > Order Statuses und sie hier auswählen.

Erweitert

Invoice Prefix: das Präfix für die Bestellnummern, die an KOMOJU gesendet werden. Die Nummer bei KOMOJU besteht aus dem Präfix, der OpenCart-Bestellnummer und einem kurzen Zufallssuffix, zum Beispiel OC-123-A1B2C3. Wenn Sie mehrere Shops mit demselben KOMOJU-Konto nutzen, machen Sie das Präfix für jeden Shop eindeutig. Standard: OC-.

Enable Logging: schreibt KOMOJU-Ereignisse und API-Aufrufe in komoju_p_debug.log.php im Logordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Schlüssel und Kundendaten werden nicht protokolliert. Fehler und Warnungen werden immer geschrieben. Standard: aus.

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

Delete data on uninstall: Ist die Option eingeschaltet, werden beim Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll entfernt. Bestellungen sowie die KOMOJU-Transaktionen und -Erstattungen bleiben immer erhalten, sodass alte Bestellungen nach einer Neuinstallation weiterhin bestätigt und erstattet werden können. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Geheime Schlüssel und Webhook-Token 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 Zahlungsart (standardmäßig KOMOJU Payment). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the KOMOJU payment page to complete the payment. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine KOMOJU-Zahlungssitzung für den Bestellbetrag in der Bestellwährung und leitet den Kunden zur KOMOJU-Zahlungsseite weiter. E-Mail-Adresse, Name, Zahlungs- und Lieferadressen sowie die bestellten Artikel werden an KOMOJU übergeben. Die Seite wird je nach Sprache des Kunden auf Japanisch, Englisch oder Koreanisch angezeigt (für andere Sprachen auf Englisch). Dort wählt der Kunde eine Zahlungsmethode. Welche Methoden angeboten werden, hängt von Ihrem KOMOJU-Konto und der Bestellwährung ab.

Auf 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. Standardmäßig fragt OpenCart 4 nicht nach einer Zahlungsadresse; die Erweiterung übergibt dann die Lieferadresse als Zahlungsadresse.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Erweiterung liest die Zahlungssitzung über die KOMOJU-API mit dem Schlüssel des Zahlungsmodus. Die Bestellung wird erst als bezahlt markiert, wenn KOMOJU die Zahlung bestätigt: durch den signierten Webhook oder durch das Auslesen der Sitzung, wenn der Kunde zurückkehrt. 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 OpenCart-Erfolgsseite mit Your payment with KOMOJU has been received. Kann KOMOJU in diesem Moment nicht erreicht werden oder ist die Zahlung bestätigt, aber noch nicht übernommen, zeigt eine Seite Payment confirmation den Hinweis We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. sowie eine Schaltfläche Check again.

Bei Konbini- und Banküberweisungszahlungen erhält der Kunde einen Zahlungsbeleg. Die Bestellung erhält Awaiting KOMOJU Payment Status, und die Erfolgsseite teilt dem Kunden mit, dass die Zahlung autorisiert ist und wie von KOMOJU angegeben abgeschlossen werden muss (zum Beispiel in einem Supermarkt oder per Banküberweisung). Die Bestellung wechselt zu Order Status After Payment, sobald der Kunde zahlt und KOMOJU den Webhook sendet. Läuft der Beleg ab, wechselt die Bestellung zu Cancelled Payment Status.

Wurde die Zahlung nicht abgeschlossen, kehrt der Kunde zur Kasse zurück, mit der Meldung The payment was not completed. You can try again or choose another payment method. Wurde die Bestellung bereits storniert, lautet die Meldung The KOMOJU payment was not completed and the order has been cancelled. Der Warenkorb bleibt erhalten. Auf OpenCart 4 werden diese Meldungen über der Kasse angezeigt. Bei jedem neuen Versuch (OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an; OpenCart 4 aktualisiert die Bestellung der Kasse und bezahlt dieselbe Bestellung erneut) prüft die Erweiterung die offenen KOMOJU-Sitzungen dieser Bestellung und anderer Bestellungen desselben Warenkorbs: Die offene Sitzung dieser Bestellung wird mit unverändertem Betrag wiederverwendet, andere offene Sitzungen werden bei KOMOJU storniert, und eine Sitzung, die inzwischen bezahlt wurde, bestätigt ihre Bestellung, statt eine neue Zahlung auszulösen. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt 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 ist ihr Konbini-Zahlschein abgelaufen, die Zahlung ist fehlgeschlagen oder Sie haben sie storniert), wird der Kunde mit Your previous order was cancelled or its payment failed. Please confirm the order again. zurück zur Kasse geschickt. Ist die Bestellung bereits aufgegeben und der Warenkorb enthält inzwischen andere Produkte, lautet die Meldung Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. In beiden Fällen bezahlt das nächste Confirm Order eine neue Bestellung des Warenkorbs.

Kann KOMOJU die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel KOMOJU could not accept this payment: mit dem Grund, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. oder Payment error: Could not connect to KOMOJU. Please try again in a moment. Der technische Grund wird im Protokoll festgehalten.

Der Webhook funktioniert auch, wenn der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die den Webhook und die Rückkehr des Kunden durchlässt.

Die Erweiterung hat kein Kartenformular auf Ihrer Website, keine gespeicherten Karten und keine Abonnements. Sie schränkt die Zahlungsmethoden nicht ein: Sie werden auf der KOMOJU-Seite gewählt. Eine manuelle Erfassungsaktion gibt es nicht: Zahlungen, die für eine manuelle Erfassung autorisiert wurden, müssen im KOMOJU-Dashboard erfasst werden, und die Bestellung bleibt bis dahin in Awaiting KOMOJU Payment Status.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu KOMOJU weitergeleitet und hat noch nicht bezahlt, oder KOMOJU 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 (default Processing): KOMOJU hat die Zahlung bestätigt. Eine Notiz zeigt die KOMOJU-Zahlungs-ID, die Zahlungsart und die Art der Bestätigung (Webhook oder Rückkehr).

Awaiting KOMOJU Payment Status (default Pending): ein Konbini-Beleg oder eine Banküberweisung wurde ausgestellt und wartet auf Zahlung, oder eine Zahlung wartet im KOMOJU-Dashboard auf die Erfassung.

KOMOJU Payment On Hold Status (default Pending): KOMOJU hat einen anderen Betrag oder eine andere Währung gemeldet als die Bestellsumme, oder die Zahlung wurde erfasst, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Cancelled Payment Status (default Canceled): der Zahlungsbeleg ist abgelaufen oder die Zahlung wurde storniert.

Failed Payment Status (default Failed): die Zahlung einer wartenden Bestellung ist fehlgeschlagen.

Refunded Status (default Refunded): die Zahlung wurde vollständig erstattet, entweder auf der Bestellseite oder im KOMOJU-Dashboard.

Wird für eine Bestellung, die bereits bezahlt ist, oder für eine andere Bestellung eines bereits bezahlten Warenkorbs eine zweite Zahlung erfasst, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, sie im KOMOJU-Dashboard zu erstatten, wenn es sich um ein Duplikat handelt. Erstattete Bestellungen werden nie wieder geöffnet.

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

Registerkarte VibeFox KOMOJU Payment

Öffnen Sie unter Sales > Orders eine mit KOMOJU bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox KOMOJU Payment die KOMOJU-Zahlungs-ID (verlinkt mit der Zahlung im KOMOJU-Dashboard) mit einem Etikett Test mode für Testzahlungen, die Zahlungsart, die Sitzung, die Bestellnummer bei KOMOJU, den Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf (aus OpenCart oder dem KOMOJU-Dashboard) und die KOMOJU notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox KOMOJU Payment den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via KOMOJU. Bestätigen Sie die Frage Refund this amount through KOMOJU? This cannot be undone. Vollständige und Teilerstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups). Erstattungen sind auf den Betrag begrenzt, den KOMOJU tatsächlich eingezogen hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde gezahlt hat, nicht den Bestellbetrag. Die Erstattung wird mit dem Schlüssel des Modus gesendet, in dem die Zahlung getätigt wurde, daher muss dessen geheimer Schlüssel gesetzt sein. Die Erweiterung prüft zuerst die Zahlung bei KOMOJU und lehnt Erstattungen ab, die den noch erstattbaren Betrag übersteigen. Kann KOMOJU eine Zahlung nicht automatisch erstatten (bei manchen Methoden, zum Beispiel Konbini, sind die Bankdaten des Kunden nötig), wird die Fehlermeldung von KOMOJU angezeigt und nichts erfasst: Solche Erstattungen müssen Sie im KOMOJU-Dashboard vornehmen. Eine Erstattung gilt erst als erledigt, wenn KOMOJU sie bestätigt. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne Produkte in den Bestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald KOMOJU die Zahlung erfasst hat.

Bei Zahlungen, die KOMOJU in eine andere Währung umgerechnet hat (zum Beispiel Konbini in JPY bei einer Bestellung in EUR), ist aus OpenCart nur eine vollständige Erstattung möglich. Teilerstattungen nehmen Sie im KOMOJU-Dashboard vor.

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

Im KOMOJU-Dashboard vorgenommene Erstattungen werden per Webhook übermittelt und mit einer Notiz in den Erstattungsverlauf eingetragen. Wird die gesamte Zahlung erstattet, wird die Bestellung auf Refunded Status gesetzt. Teilerstattungen im Dashboard bei Zahlungen, die in eine andere Währung umgerechnet wurden, werden nur in der Bestellung vermerkt: Erfassen Sie den entsprechenden Betrag manuell in OpenCart.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox KOMOJU Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox KOMOJU 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 gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-komoju 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 Sprache des Admin-Bereichs (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird KOMOJU Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser 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 auf dem Dashboard des Admin-Bereichs eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen bleiben unberührt: Bereits begonnene 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 des Admin-Bereichs öffnen: täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

KOMOJU 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: Sandbox Secret Key im Testmodus, Live Secret Key im Live-Modus. Der Kunde muss in einer von KOMOJU unterstützten Währung bezahlen. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Betrag erreicht.

Die Zahlung ist eingegangen, die Bestellung hat aber keinen Status: Der Webhook funktioniert nicht. Prüfen Sie im KOMOJU-Dashboard, ob der Webhook für den von Ihnen verwendeten Modus existiert, ob seine URL genau der im Abschnitt Webhook URL angezeigten entspricht und ob die Ereignisse ausgewählt sind. Prüfen Sie, ob das geheime Token im passenden Feld steht (Live Webhook Secret Token oder Sandbox Webhook Secret Token), und sehen Sie im Feld Log auf der Seite der Erweiterung nach. Kartenzahlungen werden auch bestätigt, wenn der Kunde in Ihren Shop zurückkehrt, Konbini- und Banküberweisungszahlungen dagegen nur durch den Webhook.

Der Webhook antwortet Failed to verify KOMOJU webhook signature.: Das geheime Token fehlt oder gehört zu einem anderen Webhook. KOMOJU wiederholt die Benachrichtigung.

Der Webhook antwortet Mode mismatch, ignored.: Der Webhook wurde mit dem geheimen Token des anderen Modus signiert als die Zahlung getätigt wurde. Verwenden Sie getrennte Webhooks und Token für Live- und Testmodus und prüfen Sie, ob sie nicht vertauscht sind.

Der Webhook antwortet Order not found.: Die Zahlung gehört zu keiner Bestellung dieses Shops, zum Beispiel weil sie von einem anderen Shop mit demselben KOMOJU-Konto stammt. Das Ereignis wird ignoriert.

Der Webhook antwortet Order is busy, retry later. oder Temporary error, retry later.: Die Bestellung wurde gerade von einer anderen Anfrage aktualisiert, oder die Zahlung konnte in diesem Moment nicht verarbeitet werden. KOMOJU wiederholt die Benachrichtigung. Der Grund steht im Protokoll.

Die Webhook-URL zeigt im Browser einen Fehler: Das ist normal. Die URL akzeptiert nur signierte Anfragen von KOMOJU.

Die Bestellung befindet sich im Status wartend oder zurückgehalten: Lesen Sie die KOMOJU notes in der Registerkarte der Bestellung. Ein Beleg wartet auf Zahlung, eine Zahlung wartet im KOMOJU-Dashboard auf Erfassung, der Betrag oder die Währung stimmte nicht überein, oder die Zahlung ist nach der Stornierung der Bestellung eingegangen.

Kein Erstattungsformular in der Registerkarte: Die Registerkarte nennt den Grund: KOMOJU hat die Zahlung noch nicht erfasst, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu bearbeiten, oder der geheime Schlüssel des Zahlungsmodus ist nicht gesetzt.

Erstattung schlägt fehl: Lesen Sie die Meldung. Der geheime Schlüssel des Modus, in dem die Zahlung getätigt wurde, fehlt möglicherweise, die Zahlung kann eventuell nicht automatisch erstattet werden (erstatten Sie sie im KOMOJU-Dashboard), KOMOJU kennt die Zahlung mit dem konfigurierten Schlüssel möglicherweise nicht, oder bei einer umgerechneten Zahlung ist nur eine vollständige Erstattung möglich.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse komoju_p_supported_currencies (zum Ändern der Währungsliste) und komoju_p_session_params (zum Ändern der Zahlungssitzung, zum Beispiel der Zahlungsmethoden) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox KOMOJU Payment auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus im Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 zusätzlich deren Ereignisse und Startup-Aktion, die Webhook und Kundenrückkehr im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Schlüssel, Webhook-Token, Testmodus, Rechnungspräfix, Protokollierung) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die KOMOJU-Transaktionen und -Erstattungen bleiben immer erhalten, sodass alte Bestellungen nach einer Neuinstallation weiterhin bestätigt und 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 KOMOJU 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.

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