VibeFox GMO for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 oder neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Währung: Japanischer Yen (JPY). GMO-PG belastet ausschließlich in Yen, daher wird die Zahlungsart nur angezeigt, wenn die Währung des Kunden an der Kasse JPY ist. Fügen Sie JPY unter System > Localisation > Currencies hinzu, falls Ihr Shop es noch nicht hat. Der Betrag ist die Bestellsumme, umgerechnet mit dem JPY-Kurs des Shops und auf ganze Yen gerundet.

GMO-Payment-Gateway-Konto: ein GMO-PG-Händlervertrag mit Link Type Plus. Sie benötigen die Shop ID, das Shop password und die Link Type Plus Config ID (設定ID) der Test- und/oder Produktionsumgebung sowie die aktivierte Ergebnisbenachrichtigung (結果通知) in der Shop-Konsole von GMO-PG (siehe Configuration). Site ID und Site password werden nicht verwendet.

VibeFox-Lizenzschlüssel: Erwerb über 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 Paket für OpenCart 3 wcp_gmo_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_gmo_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_gmo_payment-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Änderungen, 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 und wählen Sie den Typ Payments. Suchen Sie VibeFox GMO Payment Gateway 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 License key ein und klicken Sie auf Activate (siehe License key).

4. Geben Sie Shop ID, Shop password und Config ID der Test- und/oder Produktionsumgebung ein und wählen Sie die Environment.

5. Aktivieren Sie in der Shop-Konsole von GMO-PG die 結果通知 (result notification) und hinterlegen Sie die in den Einstellungen angezeigte Benachrichtigungs-URL (siehe Configuration).

6. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Führen Sie eine Testzahlung in der Testumgebung durch und stellen Sie danach die Environment auf Produktion um.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_gmo_payment.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 übernimmt den Code der Erweiterung aus 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 GMO Payment Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die GMO-PG-Zugangsdaten und die Benachrichtigungs-URL wie in den Schritten 3 bis 6 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist anders (siehe Payment notifications (結果通知)).

Eine neue Installation startet mit deaktivierter Zahlungsart und ausgewählter Testumgebung.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox GMO Payment Gateway > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn die Standardwährung des Shops nicht JPY ist und wenn Shop ID, Shop password oder Config ID der aktuellen Umgebung fehlen (die Zahlungsart wird dann an der Kasse ausgeblendet). Außerdem zeigt sie an, welche Umgebung aktiv ist: TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. oder PRODUCTION — payments go to p01.mul-pay.jp. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title aus 1 bis 128 Zeichen bestehen, Sort Order muss leer oder eine ganze Zahl sein, Total muss leer oder eine Zahl von 0 oder mehr sein, und jeder Bestellstatus muss vorhanden sein. Ist etwas fehlerhaft, wird nichts gespeichert und die Seite listet die Fehler auf. Leerzeichen um die Zugangsdaten werden entfernt.

GMO Payment Gateway — Kreditkarte

Enable/Disable: Enable GMO Payment Gateway — Credit Card 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: Credit card. Pflichtfeld, bis zu 128 Zeichen.

Description: die Beschreibung der Zahlungsart auf dem Schritt Confirm Order, oberhalb der Bestätigungsschaltfläche. Standard: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.

Sort Order: die Position der Zahlungsart an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: Bietet die Zahlungsart nur für Rechnungsadressen in der gewählten Geo Zone an. Standard: All zones. Geo Zones richten Sie unter System > Localisation > Geo Zones ein.

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

GMO-PG-Konto

Shop ID und Shop password finden Sie in der Shop-Konsole von GMO-PG unter Shop management > Shop information, die Config ID unter Link Type Plus > Settings (設定ID). Test- und Produktionsumgebung haben unterschiedliche Zugangsdaten.

Environment: welche GMO-PG-Umgebung neue Zahlungen annimmt.

Production Shop ID: die Shop ID der Produktionsumgebung.

Production Shop password: das Shop password der Produktionsumgebung.

Production Config ID: die in der GMO-PG-Konsole registrierte Link-Type-Plus-Config-ID (設定ID).

Test Shop ID: die Shop ID der Testumgebung.

Test Shop password: das Shop password der Testumgebung.

Test Config ID: die Link-Type-Plus-Config-ID (設定ID) der Testumgebung.

Gespeicherte Passwörter 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 ein gespeichertes Passwort zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved password on save und klicken Sie auf Save.

Zahlung

Capture: wann die Karte belastet wird.

Order status after payment: der Status, den eine bezahlte Bestellung erhält.

Zahlungsbenachrichtigungen (結果通知)

Die Ergebnisbenachrichtigung teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Sie ist erforderlich. Aktivieren Sie in der Shop-Konsole von GMO-PG die 結果通知 (result notification) und hinterlegen Sie die URL, die in diesem Abschnitt unter Notification URL angezeigt wird. In OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_gmo_payment/notify, in OpenCart 4 so: https://your-store/index.php?route=extension/wcp_gmo_payment/payment/wcp_gmo_payment.notify. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Sie muss aus dem Internet erreichbar sein; der Wartungsmodus blockiert sie nicht.

GMO-PG-Benachrichtigungen sind nicht signiert, daher vertraut die Erweiterung ihrem Inhalt nie. Die Benachrichtigung muss von einer Ihrer konfigurierten Shop IDs stammen und sich auf eine von diesem Shop erstellte Zahlung in der Umgebung beziehen, in der die Zahlung erfolgt ist. Die Erweiterung fragt dann bei GMO-PG die Transaktion ab (SearchTrade), mit Ihrem Shop password, und ändert die Bestellung nur auf Grundlage dieser Antwort. Eine Benachrichtigung, die zu keiner echten Transaktion passt, bewirkt nichts. Transaktionen, die nicht vom Shop erstellt wurden, zum Beispiel solche in der GMO-PG-Konsole, werden bestätigt und ignoriert. Kann die Erweiterung eine Benachrichtigung nicht prüfen, antwortet sie so, dass GMO-PG sie erneut sendet.

Ohne die Benachrichtigung erhält eine Bestellung ihren Status erst, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.

Bestellstatus

OpenCart legt die Bestellung auf dem Schritt Confirm Order ohne Status an (fehlende Bestellung, missing order). Die Bestellung erhält erst einen Status, nachdem GMO-PG die Zahlung bestätigt hat. Jedes Feld listet Ihre Bestellstatus aus OpenCart auf. OpenCart kennt keinen Status „On hold“; daher erhält eine Autorisierung oder eine Zahlung mit einem anderen Betrag den unten genannten Wartestatus und eine Bestellnotiz.

Processing: eine bezahlte Bestellung, wenn Order status after payment auf „In Bearbeitung“ steht. Standard: In Bearbeitung.

Completed: eine bezahlte Bestellung, wenn Order status after payment auf „Abgeschlossen“ steht. Standard: Abgeschlossen.

GMO-PG payment on hold: nur autorisiert (wartet auf die Erfassung) oder der Betrag stimmt nicht mit der Bestellung überein. Standard: Ausstehend. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Cancelled: eine Autorisierung oder eine wartende Zahlung, die bei GMO-PG storniert wurde, oder eine Autorisierung, die vollständig erstattet wurde. Standard: Storniert.

Refunded: nach einer vollständigen Erstattung von der Bestellseite. Standard: Erstattet.

Erweitert

Debug log: schreibt API-Anfragen und Benachrichtigungen in gmo_pg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser öffnen, und bei 5 MB wird sie rotiert. Fehler und Warnungen werden immer protokolliert, auch wenn der Schalter aus ist. Passwörter und Kundendaten werden maskiert. 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, entfernt das Deinstallieren der Erweiterung die Einstellungen des Gateways und das Protokoll. Bestelldaten (GMO OrderID, Transaktions-IDs) bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Shop-Passwörter werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Shop-Passwörter bleiben erhalten.

Kasse

Auf dem Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit card). Auf dem Schritt Confirm Order sieht der Kunde Ihre Beschreibung; in der Testumgebung wird darüber das Kennzeichen TEST — GMO-PG test environment, no real charges. angezeigt. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. In OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options aus und klickt unten auf der Kassenseite auf Confirm Order. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung eine GMO-PG-Link-Type-Plus-Zahlung über die Bestellsumme in ganzen Yen und leitet den Kunden auf die Zahlungsseite von GMO-PG weiter. Dort bezahlt der Kunde mit Kreditkarte. 3-D Secure 2.0 übernimmt GMO-PG, und die E-Mail-Adresse des Kunden wird dafür übergeben. Die Zahlungsseite öffnet sich auf Japanisch, Chinesisch oder Englisch, je nach Sprache der Bestellung. Die Zahlung erscheint bei GMO-PG mit OC- und der Bestellnummer. Weitere Kundendaten werden nicht übermittelt.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Das signierte Ergebnis wird mit dem Shop password der Umgebung der Zahlung geprüft, und die Bestellung wird erst als bezahlt markiert, wenn GMO-PG sie bestätigt: durch eine serverseitige SearchTrade-Anfrage bei der Rückkehr des Kunden oder durch die Ergebnisbenachrichtigung. Beide Wege nutzen dieselbe Logik, sodass die Zahlung nie doppelt verbucht wird. 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 Erfolgsseite der OpenCart-Bestellung. Hat GMO-PG die Zahlung noch nicht bestätigt, zeigt eine Seite Payment confirmation den Text Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. mit den Schaltflächen Check again und Back to checkout; die Benachrichtigung setzt den Bestellstatus, sobald sie eintrifft.

Wird die Karte abgelehnt oder schlägt die Zahlung auf der Seite von GMO-PG fehl, kehrt der Kunde zur Kasse zurück, mit The card payment was declined or could not be completed. Please try again or use another card. Verlässt der Kunde die Seite von GMO-PG ohne zu zahlen, lautet die Meldung The payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. In OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt. Jeder neue Versuch (OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an, OpenCart 4 aktualisiert die Bestellung der Kasse) storniert die vorherigen unbezahlten Zahlungslinks des Warenkorbs. Wurde ein früherer Link inzwischen bezahlt, wird diese Zahlung bestätigt und kein neuer Link erstellt.

In OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel bei GMO-PG oder von Ihnen 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 Kasse zurückgeschickt, und das nächste Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Ist diese Bestellung bereits bezahlt, der Warenkorb seither aber geändert, auch bei einer neuen Menge, lautet die Meldung Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. Eine bezahlte Bestellung wird nie als bezahlt für einen anderen Warenkorb angezeigt.

Bestellsummen von 1 bis 9.999.999 JPY können bezahlt werden; höhere Summen blenden die Zahlungsart aus. Kann die Zahlung nicht gestartet werden, bleibt der Kunde auf dem Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel Card payment could not be started. Please try again or choose another payment method., und der Grund wird im Protokoll festgehalten.

Benachrichtigung und Rückkehr funktionieren auch, während der Shop im Wartungsmodus ist, weil OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und die Erweiterung dafür in OpenCart 4 eine Startaktion hinzufügt.

Die Erweiterung nimmt Kreditkartenzahlungen nur in JPY an, immer auf der Seite von GMO-PG. Sie bietet keine weiteren Zahlungsarten von GMO-PG, keine Mehrwährungsfunktion, keine gespeicherten Karten oder GMO-PG-Mitgliederregistrierung, keine Abonnements oder wiederkehrenden Abbuchungen und kein Kartenformular im Shop selbst.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu GMO-PG weitergeleitet und hat nicht bezahlt, oder GMO-PG hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur angezeigt, wenn der Filter Order Status auf Missing Orders gesetzt ist.

Processing or Completed status: Die Zahlung wurde bestätigt; der Status richtet sich nach Order status after payment. Eine Notiz zeigt den Betrag, den GMO-PG-Status, die Transaktion und wie die Bestätigung erfolgte (Benachrichtigung oder Rückkehr).

GMO-PG payment on hold (authorized): Bei Authorize only (仮売上) wurde der Betrag autorisiert. Erfassen Sie ihn mit Capture payment (GMO-PG) oder in der GMO-PG-Konsole, bevor die Autorisierung abläuft. Nach der Erfassung erhält die Bestellung den Status „bezahlt“. Wird die Autorisierung bei GMO-PG storniert, erhält die Bestellung den Status Cancelled.

GMO-PG payment on hold after payment: GMO-PG hat einen anderen Betrag gemeldet als die Bestellsumme. Die Notiz erklärt es. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Refunded: Die Zahlung wurde über die Erweiterung vollständig erstattet. Eine vollständige Erstattung einer nie erfassten Autorisierung setzt den Status Cancelled.

Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein oder für denselben Warenkorb unter einer anderen Bestellung, bleibt die bezahlte Bestellung unverändert. Eine Notiz bittet Sie, das Duplikat in der GMO-PG-Konsole zu erstatten. Trifft eine Zahlung für eine Bestellung ein, die bereits einen Status ohne GMO-PG-Zahlung hat, wird nur eine Notiz hinzugefügt.

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

Reiter VibeFox GMO Payment Gateway

Öffnen Sie unter Sales > Orders eine mit GMO-PG bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox GMO Payment Gateway die GMO OrderID (mit der Kennzeichnung TEST bei Testzahlungen), die Transaction ID, den Status mit dem GMO-PG-Status, Paid / refunded, die Schaltfläche zur Erfassung und das Erstattungsformular, den Erstattungsverlauf und die GMO-PG notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; Erfassung und Erstattungen erfordern das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Erfassung

Capture payment (GMO-PG) erscheint im Reiter einer wartenden Bestellung, die nur autorisiert wurde. Bestätigen Sie Capture the authorized GMO-PG payment? Die Erweiterung prüft die Transaktion bei GMO-PG und belastet den autorisierten Betrag; danach erhält die Bestellung den Status „bezahlt“. Ist die Transaktion nicht mehr autorisiert, weil sie zum Beispiel bereits in der GMO-PG-Konsole erfasst wurde, zeigt die Meldung den aktuellen Status. Eine Erfassung in der GMO-PG-Konsole kommt über die Ergebnisbenachrichtigung an.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via GMO-PG. Bestätigen Sie Refund this amount through GMO-PG? Vollständige und teilweise Erstattungen werden unterstützt, in ganzen Yen. Die Obergrenze ist der Betrag, den GMO-PG tatsächlich eingezogen hat und noch hält, nicht die Bestellsumme. Die Erstattung des gesamten Restbetrags storniert die GMO-PG-Transaktion, und GMO-PG entscheidet, ob es sich um eine Stornierung oder eine Rückbuchung handelt. Eine Teilerstattung verringert den Betrag der Transaktion. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgt ist, daher müssen Shop ID und Shop password dieser Umgebung gesetzt sein. Lehnt GMO-PG die Erstattung ab, zeigt der Reiter den Fehler an und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt den Status Refunded, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über GMO-PG.

Erstattungen und Stornierungen, die in der GMO-PG-Konsole vorgenommen wurden, kommen über die Ergebnisbenachrichtigung an und werden den Notizen hinzugefügt. Der Bestellstatus ändert sich nicht automatisch, außer bei einer Autorisierung oder einer wartenden Zahlung, die bei GMO-PG storniert wurde. Aktualisieren Sie ihn bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox GMO Payment Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox GMO 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 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-gmo 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. 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 seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird die Kreditkartenzahlung von GMO-PG Kunden an der Kasse nicht angezeigt. Wird dennoch 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-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert als (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. In OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Admin-Dashboard 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 Erfassungen 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 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. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Credit card does not appear at checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Kassenwährung JPY ist und die aktuelle Umgebung ihre Shop ID, ihr Shop password und ihre Config ID hat. Summen über 9.999.999 JPY können nicht mit Karte bezahlt werden. Die Einstellungsseite zeigt eine Warnung, wenn die Währung oder die Zugangsdaten falsch sind. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und die Bestellung den in den Einstellungen festgelegten Total erreicht.

The payment went through, but the order stays without a status: Die Ergebnisbenachrichtigung funktioniert nicht. Prüfen Sie in der GMO-PG-Shop-Konsole der verwendeten Umgebung, ob 結果通知 aktiviert ist und ob die URL genau der unter Notification URL angezeigten entspricht. Prüfen Sie, ob Shop ID und Shop password dieser Umgebung ausgefüllt sind, da die Erweiterung jede Benachrichtigung damit verifiziert. Schalten Sie das Debug log ein und sehen Sie im Feld Log der Erweiterungsseite nach. Die Bestellung erhält ihren Status auch dann, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Log shows Notification rejected: unknown ShopID.: Die Benachrichtigung stammt von einem Shop, dessen Shop ID nicht in den Einstellungen steht. Tragen Sie die Shop ID dieser Umgebung ein.

Log shows Notification ignored: OrderID is not a payment of this store.: Die Transaktion wurde nicht von diesem Shop erstellt, zum Beispiel wurde sie in der GMO-PG-Konsole angelegt. Es ist nichts zu tun.

Log shows that the order was paid in another environment: Test- und Produktionszahlungen werden getrennt gehalten. Eine Testbenachrichtigung bestätigt nie eine Produktionszahlung und umgekehrt.

The customer sees an error after Confirm Order: Schalten Sie das Debug log ein und sehen Sie im Feld Log nach. Das Protokoll zeigt den GMO-PG-Fehlercode (ErrCode, ErrInfo). Eine falsche Shop ID, ein falsches Shop password oder eine falsche Config ID ist der häufigste Grund. This payment method is not available at the moment. Please choose another payment method. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde: Der Kunde lädt die Kasse neu.

Order is in the GMO-PG payment on hold status: Lesen Sie die Notizen im Reiter VibeFox GMO Payment Gateway. Die Bestellung wurde nur autorisiert und wartet auf die Erfassung, oder der bezahlte Betrag wich von der Bestellung ab.

Refund or capture fails: Lesen Sie die Meldung im Reiter. Die Bestellung wurde möglicherweise in der anderen Umgebung bezahlt, deren Shop ID und Passwort nicht gesetzt sind, die Transaktion ist bei GMO-PG eventuell schon storniert, oder der Betrag übersteigt den Restbetrag der Transaktion. The order is being updated by GMO-PG right now. Try again in a moment. bedeutet, dass gleichzeitig eine Benachrichtigung verarbeitet wurde.

The tab shows You do not have permission to refund orders.: Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern. Bitten Sie einen Administrator, es unter System > Users > User Groups zu erteilen.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox GMO Payment Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer seine eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Felder des Abschnitts Order statuses, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auf OpenCart 4 werden außerdem das Ereignis der Erweiterung (die Meldung an der Kasse) und ihre Startaktion entfernt, die Benachrichtigung und Rückkehr im Wartungsmodus durchlässt. Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Umgebung, Zugangsdaten, Erfassung, Bestellstatus nach der Zahlung, Schalter des Debug-Logs) und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die GMO-PG-Transaktionen und Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation weiterhin erfasst und erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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