VibeFox GMO for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiviert. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

Shop-Währung: Japanischer Yen (JPY). Bei einer anderen Shop-Währung wird die Zahlungsart an der Kasse ausgeblendet. Auf der Seite Pay for order zählt die Währung der Bestellung.

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

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

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können den Ordner wcp_gmo_payment auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > Manage, oder klicken Sie auf der Plugin-Seite unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzbereich oben auf der Seite ein und klicken Sie auf Activate.

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

6. Aktivieren Sie in der GMO-PG-Shop-Konsole 結果通知 (Ergebnisbenachrichtigung) und hinterlegen Sie die in den Einstellungen angezeigte Benachrichtigungs-URL (siehe Konfiguration).

7. Aktivieren Sie Enable/Disable. Führen Sie eine Testzahlung in der Testumgebung durch und stellen Sie anschließend Environment auf Produktion um.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Der Seitentitel zeigt für die aktuelle Umgebung die Kennzeichnung TEST oder PRODUCTION. Oberhalb der Felder erscheint eine Warnung, wenn die Shop-Währung nicht JPY ist oder Shop ID, Shop password oder Config ID der aktuellen Umgebung fehlen. In beiden Fällen wird die Zahlungsart an der Kasse ausgeblendet. In der Liste der Zahlungsarten wird das Gateway als einrichtungsbedürftig gekennzeichnet, bis die Zugangsdaten der aktuellen Umgebung vorliegen. Führende und nachgestellte Leerzeichen in den Zugangsdaten werden beim Speichern entfernt.

Enable/Disable: Enable GMO Payment Gateway — Credit Card schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der an der Kasse angezeigte Name der Zahlungsart. Standard: Credit card.

Description: der Text unter der Zahlungsart an der Kasse. Standard: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.

GMO-PG-Konto

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

Environment: die GMO-PG-Umgebung, die Zahlungen entgegennimmt.

Produktions-Zugangsdaten (p01.mul-pay.jp)

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-Konfigurations-ID (設定ID).

Test-Zugangsdaten (pt01.mul-pay.jp)

Test Shop ID: die Shop ID der Testumgebung.

Test Shop password: das Shop password der Testumgebung.

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

Zahlung

Capture: wann die Karte belastet wird.

Order status after payment: der Status einer bezahlten Bestellung. Er wird sofort gesetzt, mit genau einer Statusänderung und einer Kunden-E-Mail.

Zahlungsbenachrichtigungen (結果通知)

Die Ergebnisbenachrichtigung teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Sie ist erforderlich. Aktivieren Sie in der GMO-PG-Shop-Konsole 結果通知 (Ergebnisbenachrichtigung) und hinterlegen Sie die in diesem Einstellungsabschnitt angezeigte Benachrichtigungs-URL. Sie sieht etwa so aus: https://your-site/wc-api/gmo_pg_webhook/. Kopieren Sie die URL genau wie in den Einstellungen angezeigt.

GMO-PG-Benachrichtigungen sind nicht signiert, daher vertraut das Plugin ihrem Inhalt nie. Eine 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 Bestellung bezahlt wurde. Das Plugin fragt dann mit Ihrem Shop password die Transaktion bei GMO-PG ab (SearchTrade) und ändert die Bestellung ausschließlich anhand dieser Antwort. Eine Benachrichtigung ohne passende echte Transaktion ändert nichts. Transaktionen, die nicht vom Shop erstellt wurden, beispielsweise in der GMO-PG-Konsole, werden bestätigt und ignoriert. Kann das Plugin eine Benachrichtigung nicht prüfen, antwortet es so, dass GMO-PG sie erneut sendet (GMO-PG versucht es bis zu 5 Mal erneut).

Ohne Benachrichtigung wird eine Bestellung erst bestätigt, wenn der Kunde nach dem Bezahlen zum Shop zurückkehrt.

Erweitert

Debug log: Log API requests and notifications schreibt sie nach WooCommerce > Status > Logs, Quelle wcp_gmo_payment. Fehler werden immer protokolliert. Passwörter und Kundendaten werden maskiert. Standard: aus.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Eine Deaktivierung löscht nie etwas. Bestelldaten (Transaktions-IDs) bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Credit card) und gibt die Bestellung auf. Das Plugin erstellt eine GMO-PG Link Type Plus-Zahlung für die auf ganze Yen gerundete Bestellsumme und leitet den Kunden zur GMO-PG-Zahlungsseite weiter. Dort bezahlt er per Kreditkarte. GMO-PG wickelt 3-D Secure 2.0 ab und erhält die Rechnungs-E-Mail-Adresse des Kunden für 3-D Secure. Die Zahlungsseite öffnet sich je nach Sprache Ihrer Website auf Japanisch, Chinesisch oder Englisch. Die Zahlung erscheint bei GMO-PG mit WC- und der Bestellnummer. Weitere Kundendaten werden nicht übertragen.

Nach dem Bezahlen kehrt der Kunde zu Ihrem Shop zurück. Das signierte Ergebnis wird mit Ihrem Shop password geprüft. Die Bestellung wird erst als bezahlt markiert, nachdem GMO-PG sie bestätigt hat: durch eine serverseitige SearchTrade-Anfrage bei der Rückkehr des Kunden oder durch die Ergebnisbenachrichtigung. Beide Wege verwenden dieselbe Logik, sodass die Bestellung nie doppelt verarbeitet wird. Ist die Zahlung noch nicht bestätigt, zeigt die Bestelleingangsseite Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed.

Wird die Karte abgelehnt oder schlägt die Zahlung auf der GMO-PG-Seite fehl, erhält die Bestellung den Status Fehlgeschlagen und der Kunde gelangt auf die Seite Pay for order mit der Meldung The card payment was declined or could not be completed. Please try again or use another card. Wenn der Kunde die GMO-PG-Seite ohne Zahlung verlässt, zeigt dieselbe Seite The payment was not completed. You can try again or choose another payment method. Jeder neue Versuch storniert den vorherigen unbezahlten Zahlungslink. Wurde der vorherige Link inzwischen bereits bezahlt, wird diese Zahlung übernommen und kein neuer Link erstellt.

Bestellsummen von 1 bis 9.999.999 JPY können bezahlt werden. Bei höheren Summen wird die Zahlungsart ausgeblendet. Kann die Zahlung nicht gestartet werden, sieht der Kunde eine kurze Meldung, beispielsweise Card payment could not be started. Please try again or choose another payment method., und der Grund wird in den Bestellnotizen ergänzt.

Die Zahlungsart funktioniert in der klassischen Kasse, in den Warenkorb- und Kassen-Blöcken sowie auf der Seite Pay for order. Im Kassen-Block zeigt sie das Kartensymbol und die Beschreibung. In der Testumgebung zeigen sowohl die klassische Kasse als auch der Kassen-Block die Kennzeichnung Test mode — no real charge. Das Plugin ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin akzeptiert Kreditkartenzahlungen ausschließlich in JPY und immer auf der GMO-PG-Seite. Andere GMO-PG-Zahlungsarten, mehrere Währungen, gespeicherte Karten, GMO-PG-Mitgliederregistrierung, Abonnements, wiederkehrende Abrechnungen und ein Kartenformular auf Ihrer Website werden nicht unterstützt.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: der Kunde wurde zu GMO-PG weitergeleitet und hat noch nicht bezahlt, oder GMO-PG hat die Zahlung noch nicht bestätigt.

Processing or Completed: die Zahlung wurde bestätigt. Der Status richtet sich nach Order status after payment. Die Bestellnotiz zeigt den Betrag, den GMO-PG-Status, die Transaktion und die Art der Bestätigung (Benachrichtigung oder Rückkehr). Die Transaktions-ID entspricht der GMO-PG TranID.

On hold (authorized): mit Authorize only (仮売上) wurde der Betrag autorisiert. Erfassen Sie ihn vor Ablauf der Autorisierung mit der Bestellaktion Capture payment (GMO-PG) oder in der GMO-PG-Konsole. Danach erhält die Bestellung den Status In Bearbeitung oder Abgeschlossen. Wird die Autorisierung bei GMO-PG storniert, wird auch die Bestellung storniert.

On hold after payment: GMO-PG hat einen von der Bestellsumme abweichenden Betrag gemeldet oder die Zahlung ging nach der Stornierung der Bestellung ein. Die Bestellnotiz erklärt den Sachverhalt. Prüfen Sie die Bestellung und führen Sie sie aus oder erstatten Sie die Zahlung.

Failed: die Karte wurde abgelehnt oder die Zahlung auf der GMO-PG-Seite nicht abgeschlossen.

Geht eine zweite Zahlung für eine bereits bezahlte oder geschlossene Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung in der GMO-PG-Konsole zu erstatten.

Erfassung

Die Bestellaktion Capture payment (GMO-PG) erscheint bei Bestellungen in Wartestellung, die nur autorisiert wurden. Sie belastet den autorisierten Betrag. Ist die Transaktion nicht mehr autorisiert, etwa weil sie bereits in der GMO-PG-Konsole erfasst wurde, ergänzt die Aktion eine Notiz mit dem aktuellen Status und richtet sich danach.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Credit card (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen in ganzen Yen werden unterstützt. Die Erstattung des gesamten Restbetrags storniert die GMO-PG-Transaktion; GMO-PG entscheidet, ob es sich um eine Aufhebung oder Rückzahlung handelt. Eine Teilerstattung verringert den Transaktionsbetrag, und der Kartenanbieter autorisiert den neuen Betrag. Die Erstattung wird an die Umgebung gesendet, in der die Bestellung bezahlt wurde. Shop ID und Shop password dieser Umgebung müssen daher hinterlegt sein. Akzeptiert GMO-PG die Erstattung nicht, zeigt WooCommerce den Fehler an und erfasst keine Erstattung. Eine erfolgreiche Erstattung wird den Bestellnotizen hinzugefügt.

Erstattungen und Stornierungen aus der GMO-PG-Konsole gehen über die Ergebnisbenachrichtigung ein und werden den Bestellnotizen hinzugefügt. Sie werden nicht automatisch als WooCommerce-Erstattungen erfasst. Erstellen Sie bei Bedarf eine manuelle Erstattung in WooCommerce ohne die GMO-PG-Schaltfläche.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben auf WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich zeigt den Status, beispielsweise das Ablaufdatum der Lizenz und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird die Zahlungsart Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin mit der Kennzeichnung (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Auf der Plugin-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen sowie Erfassungen funktionieren.

Nach Ablauf einer Lizenz funktioniert das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Kreditkarte erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv, Enable/Disable eingeschaltet, die Shop-Währung JPY und Shop ID, Shop password sowie Config ID der aktuellen Umgebung hinterlegt sind. Bestellsummen über 9.999.999 JPY können nicht per Karte bezahlt werden. Bei falscher Währung oder falschen Zugangsdaten zeigt die Einstellungsseite eine Warnung.

Zahlung erfolgt, Bestellung bleibt aber Pending payment: Die Ergebnisbenachrichtigung funktioniert nicht. Prüfen Sie in der GMO-PG-Shop-Konsole der verwendeten Umgebung, ob 結果通知 aktiviert ist und die URL genau der in den Einstellungen entspricht. Prüfen Sie, ob Shop ID und Shop password dieser Umgebung eingetragen sind, da das Plugin jede Benachrichtigung damit verifiziert. Aktivieren Sie Debug log und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_gmo_payment. Die Bestellung wird auch bestätigt, wenn der Kunde nach dem Bezahlen zum Shop zurückkehrt.

Protokoll zeigt 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.

Protokoll zeigt Notification ignored ... is not a payment of this store: Die Transaktion wurde nicht von diesem Shop erstellt, beispielsweise in der GMO-PG-Konsole. Es ist nichts zu tun.

Protokoll meldet, dass die Bestellung in einer anderen Umgebung bezahlt wurde: Test- und Produktionszahlungen bleiben getrennt. Eine Testbenachrichtigung bestätigt niemals eine Produktionsbestellung und umgekehrt.

Der Kunde sieht beim Bestellen einen Fehler: Öffnen Sie die Bestellnotizen oder aktivieren Sie Debug log. Die Notiz zeigt den GMO-PG-Fehlercode (ErrCode, ErrInfo). Meist sind Shop ID, Shop password oder Config ID falsch. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. bedeutet, dass die Bestellung nicht in JPY geführt wird.

Bestellung ist nach Zahlung On hold: Lesen Sie die Bestellnotiz. Die Bestellung wurde nur autorisiert und wartet auf Erfassung, der bezahlte Betrag wich von der Bestellsumme ab oder die Zahlung ging nach der Stornierung ein.

Erstattung schlägt fehl: Lesen Sie die Meldung. Die Bestellung wurde möglicherweise in der anderen Umgebung bezahlt, deren Shop ID und Passwort fehlen, die Transaktion ist bei GMO-PG bereits storniert oder der Betrag übersteigt den Restbetrag der Transaktion.

Der Lizenzbereich zeigt einen Fehler: Folgen Sie der Meldung im Bereich. Wird der Schlüssel beispielsweise bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Website-Adresse geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem letzten bekannten Status weiter.

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Deaktivieren und löschen Sie es zum Entfernen auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Gateway-Einstellungen und Protokolle werden nur entfernt, wenn Delete data on uninstall eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Die in Bestellungen gespeicherten GMO-PG-Daten gehören zur Zahlungshistorie und bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

GMO Payment Gateway ist eine Marke des jeweiligen Inhabers. Dieses Plugin ist weder mit GMO Payment Gateway verbunden noch wird es von GMO Payment Gateway unterstützt.