VibeFox GMO for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

Währung: Japanischer Yen (JPY). GMO-PG berechnet ausschließlich Yen, daher wird die Zahlungsart nur angezeigt, wenn die Warenkorbwährung JPY ist. Fügen Sie JPY unter International > Localization > Currencies hinzu, falls Ihr Shop es noch nicht hat.

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

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine Domain.

Installation

1. Gehen Sie im Back-Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie VibeFox GMO Payment Gateway später in der Modulliste und klicken Sie dort auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel unter License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

5. Schalten Sie in der Shop-Konsole von GMO-PG 結果通知 (Ergebnisbenachrichtigung) ein und setzen Sie die in den Einstellungen angezeigte Benachrichtigungs-URL (siehe Konfiguration).

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

Bei der Installation legt das Modul den Bestellstatus GMO-PG payment on hold an. PrestaShop bietet ein neues Zahlungsmodul für alle Währungen, Länder und Kundengruppen an. Sie können dies unter Payment > Preferences einschränken; JPY muss erlaubt bleiben.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox GMO Payment Gateway > Configure. Jede Schaltfläche Save speichert die gesamte Seite. Oberhalb der Felder 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. Leerzeichen um die Zugangsdaten werden beim Speichern entfernt.

GMO Payment Gateway — Credit Card

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

Title: der Name der Zahlungsart, der an der Kasse angezeigt wird. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Credit card. Pflichtfeld.

Description: der Text, der an der Kasse unter der Zahlungsart angezeigt wird. 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 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.

Test (sandbox): pt01.mul-pay.jp mit den Testzugangsdaten (Standard).

Production (live): p01.mul-pay.jp mit den Produktionszugangsdaten.

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 Config ID (設定ID) von Link Type Plus.

Test Shop ID: die Shop ID der Testumgebung.

Test Shop password: das Shop password der Testumgebung.

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

Gespeicherte Passwörter werden nie wieder 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.

Clear saved passwords: Setzen Sie bei einem Passwort einen Haken und klicken Sie auf Save, um es zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Payment

Capture: wann die Karte belastet wird.

Capture immediately (即時売上): die Karte wird sofort belastet (Standard).

Authorize only (仮売上): der Betrag wird nur autorisiert, und die Bestellung wird in GMO-PG payment on hold gesetzt, bis Sie sie mit Capture payment (GMO-PG) auf der Bestellseite oder in der GMO-PG-Konsole erfassen, bevor die Autorisierung abläuft.

Order status after payment: der Status einer bezahlten Bestellung.

Processing: die Bestellung wird Payment accepted (Standard).

Completed: die Bestellung wird Delivered. Geeignet für virtuelle und herunterladbare Produkte.

Zahlungsbenachrichtigungen (結果通知)

Die Ergebnisbenachrichtigung teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Sie ist erforderlich. Schalten Sie in der Shop-Konsole von GMO-PG 結果通知 (Ergebnisbenachrichtigung) ein und tragen Sie die URL ein, die unter Notification URL in diesem Abschnitt angezeigt wird. Mit suchmaschinenfreundlichen URLs sieht sie etwa so aus: https://your-shop/module/wcp_gmo_payment/notify, gegebenenfalls mit einem Sprachkürzel wie /ja/. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Sie muss aus dem Internet erreichbar sein; der Wartungsmodus blockiert sie nicht.

Benachrichtigungen von GMO-PG sind nicht signiert, daher vertraut das Modul 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. Anschließend fragt das Modul die Transaktion bei GMO-PG mit Ihrem Shop password ab (SearchTrade) und ändert den Warenkorb oder die Bestellung nur auf Grundlage dieser Antwort. Eine Benachrichtigung, die zu keiner echten Transaktion passt, bewirkt nichts. Transaktionen, die nicht vom Shop erstellt wurden, etwa solche in der GMO-PG-Konsole, werden bestätigt und ignoriert. Kann das Modul eine Benachrichtigung nicht prüfen, antwortet es so, dass GMO-PG sie erneut sendet (GMO-PG wiederholt bis zu 5 Mal).

Ohne die Benachrichtigung wird eine Bestellung erst angelegt, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.

Advanced

Debug log: schreibt API-Anfragen und Benachrichtigungen in logs/gmo_pg_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Fehler 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: Wenn eingeschaltet, werden beim Deinstallieren des Moduls die Einstellungen des Gateways und das Protokoll entfernt. Bestelldaten (GMO OrderID, Transaktions-IDs) bleiben immer erhalten. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsart (standardmäßig Credit card) und sieht deren Beschreibung. In der Testumgebung wird darüber das Kennzeichen TEST — GMO-PG test environment, no real charges. angezeigt. Nach der Bestätigung legt das Modul eine GMO-PG-Link-Type-Plus-Zahlung für die Warenkorbsumme an, auf ganze Yen gerundet, und leitet den Kunden zur Zahlungsseite von GMO-PG weiter. Dort bezahlt der Kunde per Kreditkarte. 3-D Secure 2.0 wird von GMO-PG abgewickelt, und die E-Mail-Adresse des Kunden wird dafür an GMO-PG übergeben. Die Zahlungsseite öffnet sich auf Japanisch, Chinesisch oder Englisch, je nach Sprache des Kunden. Die Zahlung erscheint bei GMO-PG mit PS- und der Warenkorbnummer. Weitere Kundendaten werden nicht übermittelt. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Nach der Zahlung kehrt der Kunde zu Ihrem 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, nachdem GMO-PG die Zahlung bestätigt hat: entweder durch eine serverseitige SearchTrade-Anfrage bei der Rückkehr des Kunden oder durch die Ergebnisbenachrichtigung. Beide verwenden dieselbe Logik, daher wird eine Bestellung nie doppelt angelegt. Anschließend sieht der Kunde die übliche Bestellbestätigungsseite. Hat GMO-PG die Zahlung noch nicht bestätigt, zeigt eine Seite Payment confirmation den Hinweis Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. mit einer Schaltfläche Check again; die Benachrichtigung legt die Bestellung an, 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 und sieht den Hinweis 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 der Hinweis The payment was not completed. You can try again or choose another payment method.. Der Warenkorb bleibt erhalten. Jeder neue Versuch storniert den vorherigen unbezahlten Zahlungslink. Wurde der vorherige Link inzwischen bezahlt, wird die Bestellung aus dieser Zahlung erstellt, und es wird kein neuer Link erzeugt.

Warenkorbsummen 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 an der Kasse mit einem kurzen Hinweis, 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, und werden nicht durch die Ländereinschränkung Ihres Shops blockiert.

Das Modul nimmt Kreditkartenzahlungen nur in JPY entgegen, immer auf der Seite von GMO-PG. Andere GMO-PG-Zahlungsarten, mehrere Währungen, gespeicherte Karten oder die Mitgliederregistrierung bei GMO-PG, Abonnements oder wiederkehrende Abrechnungen und ein Kartenformular im Shop werden nicht unterstützt.

Bestellungen und Erstattungen

Bestellstatus

Noch keine Bestellung: Der Kunde wurde zu GMO-PG weitergeleitet und hat noch nicht bezahlt, oder GMO-PG hat die Zahlung noch nicht bestätigt. Es existiert nur der Warenkorb.

Payment accepted oder Delivered: Die Zahlung wurde bestätigt. Der Status richtet sich nach Order status after payment. Die Zahlung wird mit der GMO-PG TranID als Transaktions-ID erfasst, und eine Notiz zeigt den Betrag, den GMO-PG-Status, die Transaktion und die Art der Bestätigung (Benachrichtigung oder Rückkehr).

GMO-PG payment on hold (autorisiert): 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 wird die Bestellung zu Payment accepted oder Delivered. Wird die Autorisierung bei GMO-PG storniert, wird die Bestellung Canceled.

GMO-PG payment on hold nach der Zahlung: GMO-PG hat einen anderen Betrag als die Warenkorbsumme gemeldet, oder der Warenkorb war nicht in JPY. Die Notiz erklärt dies, und die Zahlung wird für den Betrag erfasst, den GMO-PG tatsächlich eingezogen hat. Prüfen Sie die Bestellung und erfüllen Sie sie oder erstatten Sie die Zahlung.

Refunded: Die Zahlung wurde über das Modul vollständig erstattet. Eine vollständige Erstattung einer nie erfassten Autorisierung setzt Canceled.

Trifft eine zweite Zahlung für einen Warenkorb ein, dessen Bestellung bereits bezahlt oder abgeschlossen ist, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, die doppelte Zahlung in der GMO-PG-Konsole zu erstatten.

GMO-Payment-Gateway-Block

Die Bestellseite zeigt einen Block GMO Payment Gateway mit GMO OrderID, Transaction ID, dem Status (mit dem GMO-PG-Status), Paid / refunded, einem Kennzeichen TEST für Testzahlungen, dem Erstattungsverlauf und den GMO-PG notes der Bestellung. Erfassung und Erstattungen erfordern das Recht zum Bearbeiten von Bestellungen; der Zugriff auf die Modulseiten ist nicht nötig.

Erfassung

Capture payment (GMO-PG) erscheint im Block einer wartenden Bestellung, die nur autorisiert wurde. Bestätigen Sie Capture the authorized GMO-PG payment?. Das Modul prüft die Transaktion bei GMO-PG und belastet den autorisierten Betrag. Ist die Transaktion nicht mehr autorisiert, etwa weil sie bereits in der GMO-PG-Konsole erfasst wurde, zeigt eine Notiz den aktuellen Status, und die Bestellung folgt ihm.

Erstattungen

Geben Sie im Block den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via GMO-PG. Bestätigen Sie Refund this amount through GMO-PG?. Vollständige und teilweise Erstattungen sind möglich, 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 verbleibenden Betrags 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; deren Shop ID und Shop password müssen daher eingetragen sein. Lehnt GMO-PG die Erstattung ab, zeigt der Block den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded; eine Teilerstattung ändert den Status nicht.

Das Modul erstellt keine Gutschriften. Die Standard-Erstattungsschaltflächen von PrestaShop auf der Bestellseite senden kein Geld über GMO-PG zurück.

Erstattungen und Stornierungen, die in der GMO-PG-Konsole vorgenommen werden, kommen über die Ergebnisbenachrichtigung an und werden den Notizen hinzugefügt. Der Bestellstatus und die Gutschriften werden nicht automatisch geändert, außer bei einer bei GMO-PG stornierten Autorisierung. Aktualisieren Sie sie bei Bedarf manuell.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox GMO Payment Gateway ist der erste Block auf Modules > Module Manager > VibeFox GMO Payment Gateway > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel unter License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-gmo und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back-Office (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. Kann der Lizenzserver nicht erreicht werden, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Domain des Hauptshops, auch in einem Multistore-Setup. 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 GMO-PG-Kartenzahlung Kunden in der Kasse nicht angezeigt. Wird die Zahlung dennoch gestartet, sieht der Kunde This payment method is not available. Please choose another one. Der PrestaShop-Storefront weiß nicht, dass Sie im Back-Office angemeldet sind, daher wird die Zahlungsmethode auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt, und Erfassungen sowie Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird während Ihrer Arbeit im Back-Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Kreditkarte erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Warenkorbwährung JPY ist und die aktuelle Umgebung ihre Shop ID, ihr Shop password und ihre Config ID hat. Warenkorbsummen über 9.999.999 JPY können nicht mit Karte bezahlt werden. Die Einstellungsseite zeigt eine Warnung, wenn Währung oder Zugangsdaten falsch sind. Prüfen Sie unter Payment > Preferences, ob das Modul für JPY, das Land des Kunden und die Kundengruppe des Kunden erlaubt ist.

Die Zahlung war erfolgreich, aber es wurde keine Bestellung angelegt: Die Ergebnisbenachrichtigung funktioniert nicht. Prüfen Sie in der GMO-PG-Shop-Konsole der verwendeten Umgebung, ob 結果通知 eingeschaltet 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, denn das Modul prüft jede Benachrichtigung damit. Schalten Sie Debug log ein und sehen Sie im Feld Log auf der Modulseite nach. Die Bestellung wird auch angelegt, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.

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

Das Log zeigt 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.

Das Log zeigt, dass der Warenkorb in einer anderen Umgebung bezahlt wurde: Test- und Produktionszahlungen bleiben getrennt. Eine Testbenachrichtigung bestätigt nie eine Produktionszahlung und umgekehrt.

Das Log zeigt Cannot create the order: the module is disabled: Das Modul wurde deaktiviert, während eine Zahlung bestätigt wurde. Aktivieren Sie es; GMO-PG sendet die Benachrichtigung erneut.

Der Kunde sieht bei Auswahl der Kartenzahlung einen Fehler: Schalten Sie 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. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. bedeutet, dass der Warenkorb nicht in JPY ist.

Bestellung ist GMO-PG payment on hold: Lesen Sie die Notizen im Block GMO Payment Gateway. Die Bestellung wurde nur autorisiert und wartet auf die Erfassung, oder der bezahlte Betrag wich von der Warenkorbsumme ab.

Erstattung oder Erfassung schlägt fehl: Lesen Sie die Meldung im Block. Die Bestellung wurde möglicherweise in der anderen Umgebung bezahlt, deren Shop ID und Passwort nicht eingetragen sind; die Transaktion ist bei GMO-PG eventuell bereits storniert; oder der Betrag übersteigt den Rest der Transaktion. The order is being updated by GMO-PG right now. Try again in a moment. bedeutet, dass gleichzeitig eine Benachrichtigung verarbeitet wurde.

Der Block zeigt You do not have permission to refund orders.: Ihr Mitarbeiterprofil hat kein Recht zum Bearbeiten von Bestellungen. Bitten Sie einen Administrator, es Ihnen zu gewähren.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox GMO Payment Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data on uninstall eingeschaltet, werden die Einstellungen des Gateways und das Protokoll entfernt. Ist es ausgeschaltet, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die GMO-PG-Transaktionen und Erstattungen sowie der Bestellstatus GMO-PG payment on hold bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erfasst und erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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