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

Shop-Währung: HUF, EUR oder USD. SimplePay akzeptiert keine anderen Währungen, und die Zahlungsart wird nicht angeboten, solange der Kunde eine andere Währung ausgewählt hat.

SimplePay-Händlerkonten: SimplePay vergibt für jede Währung ein eigenes Händlerkonto sowie getrennte Konten für Live und Sandbox. Für jedes Konto benötigen Sie seine MERCHANT und SECRET KEY aus dem SimplePay-Händleradministrator (admin.simplepay.hu für Live, sandbox.simplepay.hu für die Sandbox), unter Konto > Technical data. Wenn Sie nur in HUF verkaufen, reicht das HUF-Konto aus. Weitere Schlüssel sind nicht nötig.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer 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_simplepay_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_simplepay_gateway.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 zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_simplepay_gateway-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 und wählen Sie den Typ Payments. Suchen Sie VibeFox SimplePay 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 Schaltfläche mit dem Stift), 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 das MERCHANT und den SECRET KEY Ihrer SimplePay-Konten für jede Währung ein, in der Sie verkaufen: Sandbox-Konten für Tests und Live-Konten für echte Zahlungen (siehe Konfiguration).

5. Kopieren Sie die IPN URL, die auf der Einstellungsseite angezeigt wird, in jedes Händlerkonto (Live und Sandbox) im SimplePay-Händleradministrator.

6. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit aktiviertem Sandbox mode, deaktivieren Sie danach Sandbox mode, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_simplepay_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung 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 SimplePay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Schaltfläche mit dem Stift).

4. Geben Sie den Lizenzschlüssel, die Händlerkonten und die IPN-URL ein wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die IPN-URL ist anders (siehe IPN URL).

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

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox SimplePay Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, wenn die Standardwährung des Shops von SimplePay nicht unterstützt wird oder wenn im aktuellen Modus kein Händlerkonto dafür vorhanden ist. In beiden Fällen wird die Zahlungsart für Bestellungen in dieser Währung nicht angeboten. Solange der Sandbox-Modus eingeschaltet ist, zeigt die Seite Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. an. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (bis zu 128 Zeichen), Sort Order muss eine ganze Zahl sein (negative Werte sind erlaubt), Total muss eine Zahl sein, 0 oder größer, und die Geozone sowie die Bestellstatus müssen vorhanden sein. Ist ein Wert falsch, wird nichts gespeichert.

SimplePay (OTP)

Enable/Disable: Enable SimplePay Gateway schaltet die Zahlungsart ein oder aus. Default: off.

Title: der Name der Zahlungsart, den Kunden in der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Default: SimplePay (Card Payment). Pflichtfeld.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Bestätigungsschaltfläche angezeigt wird. Default: Pay securely with your credit or debit card via SimplePay. Ungarische Händler können hier die Datenübertragungserklärung von SimplePay eintragen.

Sandbox mode: verwendet die SimplePay-Sandbox für Testzahlungen mit den Sandbox-Konten. Dabei werden sowohl die API-Adresse als auch die Händlerkonten umgeschaltet. Es wird kein echtes Geld berechnet. Default: on. Schalten Sie es aus, um echte Zahlungen mit den Live-Konten anzunehmen. Solange es eingeschaltet ist, sieht der Kunde im Schritt Confirm Order den Hinweis Sandbox mode: no real payment is taken. Bestellungen, die in der Sandbox gestartet wurden, werden immer in der Sandbox erstattet.

Sort Order: die Position von SimplePay unter den Zahlungsarten in der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein (negative Werte sind erlaubt).

Geo Zone: bietet SimplePay nur für Rechnungsadressen in der ausgewählten Geozone an. Default: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

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

Live-Händlerkonten

Die Konten, die verwendet werden, wenn Sandbox mode ausgeschaltet ist. Tragen Sie die Konten für die Währungen ein, in denen Ihr Shop verkauft. Die Werte MERCHANT und SECRET KEY finden Sie im SimplePay-Händleradministrator (admin.simplepay.hu, dort stehen die Links zu den Bereichen), unter Konto > Technical data. Ein Konto wird nur verwendet, wenn beide Felder ausgefüllt sind.

HUF account — Merchant ID: das MERCHANT Ihres Live-Kontos in HUF.

HUF account — Secret key: der SECRET KEY Ihres Live-Kontos in HUF.

EUR account — Merchant ID und EUR account — Secret key: dasselbe für Ihr Live-Konto in EUR.

USD account — Merchant ID und USD account — Secret key: dasselbe für Ihr Live-Konto in USD.

Sandbox-Händlerkonten

Die Konten, die verwendet werden, wenn Sandbox mode eingeschaltet ist. Die Felder sind dieselben wie bei den Live-Konten: HUF account — Merchant ID, HUF account — Secret key und dieselben Paare für EUR und USD. Die Werte stammen aus dem Sandbox-Händleradministrator von SimplePay (sandbox.simplepay.hu), unter Konto > Technical data.

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

IPN URL

Die IPN ist die Nachricht, die SimplePay an Ihren Shop sendet, wenn sich der Zahlungsstatus ändert. Sie ist der übliche Weg, auf dem eine Bestellung ihren Status erhält. Der Abschnitt zeigt die IPN-URL Ihres Shops. Bei OpenCart 3 sieht sie so aus: https://your-store/index.php?route=extension/payment/wcp_simplepay_gateway/ipn, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_simplepay_gateway/payment/wcp_simplepay_gateway.ipn. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Tragen Sie diese URL für jedes Händlerkonto ein, Live und Sandbox, im SimplePay-Händleradministrator. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen, denn eine umgeleitete IPN geht verloren.

Die IPN muss mit dem SECRET KEY des Händlerkontos signiert sein, das sie nennt, und zwar im Modus (Sandbox oder Live), in dem die Zahlung gestartet wurde. IPNs ohne gültige Signatur werden abgelehnt. Die Erweiterung bestätigt jede gültige IPN gegenüber SimplePay in der signierten Form, die SimplePay verlangt. Folgende IPN-Status werden verwendet:

Abgelehnte, abgebrochene und abgelaufene Status werden nur für den letzten Zahlungsversuch eines Warenkorbs erfasst, der noch nichts bezahlt hat. Andere Status ändern nichts. Ohne die IPN erhält eine Bestellung ihren Status nur dann, wenn der Kunde nach einer erfolgreichen Zahlung in den Shop zurückkehrt.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung, missing order). Die Bestellung erhält erst dann einen Status, wenn SimplePay die Zahlung bestätigt hat. Die Statusfelder listen Ihre Bestellstatus in OpenCart auf.

Order Status After Payment: welchen Status eine bezahlte Bestellung erhält.

Paid Order Status: der Status einer bezahlten Bestellung, wenn Order Status After Payment auf Processing steht. Default: Processing.

Complete Order Status: der Status einer bezahlten Bestellung, wenn Order Status After Payment auf Completed steht. Default: Complete.

On Hold (Review) Status: Die Zahlung erfolgte in einem anderen Betrag oder einer anderen Währung als die Bestellung (siehe Order statuses). Default: Pending, weil OpenCart keinen On-hold-Status hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

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

Erweitert

Logging: schreibt API-Aufrufe, IPNs und Rückkehrvorgänge in simplepay_op_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden und wird bei 5 MB rotiert. Schlüssel und Kundendaten werden nicht protokolliert. Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. Default: off.

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 dies aktiviert, werden beim Deinstallieren der Erweiterung die Einstellungen des Gateways und das Protokoll entfernt. Bestelldaten (SimplePay-Transaktionen und -Erstattungen) bleiben immer erhalten. Default: off.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die geheimen Schlüssel werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten geheimen Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig SimplePay (Card Payment)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the SimplePay payment page to pay by card. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, startet die Erweiterung eine SimplePay-Kartenzahlung über den Bestellbetrag in der Bestellwährung, mit dem Händlerkonto dieser Währung im aktuellen Modus, und leitet den Kunden zur SimplePay-Zahlungsseite weiter. Die E-Mail-Adresse des Kunden und, wenn sie vollständig ist, die Rechnungsadresse werden an SimplePay übergeben. Die Zahlungsseite verwendet die Sprache der Bestellung, sofern SimplePay sie unterstützt, andernfalls Englisch. Eine gestartete Zahlung kann innerhalb von 30 Minuten bezahlt werden. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit dem Button Choose im Block der Zahlungsart, im Fenster Payment method options, und klickt unten auf der Kassenseite auf Confirm Order.

Nach einer erfolgreichen Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückkehr allein bezahlt nie eine Bestellung: Die Erweiterung fragt bei SimplePay mit einer signierten Anfrage den Status der Transaktion ab, sodass die Bestellung ihren Status auch dann erhält, wenn die IPN verspätet ist. Die Bestellung wird nur dann als bezahlt markiert, wenn SimplePay die Zahlung bestätigt. 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 Erfolgsseite der OpenCart-Bestellung mit Successful transaction. SimplePay transaction ID: und der ID. Hat SimplePay die Zahlung noch nicht bestätigt, zeigt eine Seite Payment confirmation die Meldung Your payment is being confirmed by SimplePay. SimplePay transaction ID: mit der ID, Your order will be confirmed as soon as SimplePay confirms the payment — please do not pay again. und die Schaltflächen Check again und Back to checkout; die IPN setzt den Bestellstatus, sobald sie eintrifft.

Schlägt die Zahlung fehl, wird abgebrochen oder läuft sie ab, kehrt der Kunde mit der Meldung von SimplePay und der Transaktions-ID zur Kasse zurück, zum Beispiel Cancelled payment. You cancelled the payment oder Timeout. The time allowed to complete the payment has expired. Bei einer fehlgeschlagenen Zahlung wird der Kunde gebeten, die eingegebenen Daten zu prüfen und sich mit seiner kartenausgebenden Bank in Verbindung zu setzen. Die Bestellung bleibt ohne Status, der Warenkorb bleibt erhalten und der Kunde kann es erneut versuchen. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird. OpenCart 4 behält eine Bestellung für die Kasse bei und aktualisiert sie, sodass der nächste Versuch dieselbe Bestellung bezahlt. Jeder Versuch erhält seine eigene SimplePay-Referenz: OC, die Bestellnummer und die Versuchsnummer, zum Beispiel OC123-1 und danach OC123-2. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder in Prüfung, gelangt der Kunde direkt zur Erfolgsseite, statt erneut zu bezahlen.

Kann SimplePay die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit The SimplePay payment could not be started. Please try again or choose another payment method. Hat die Bestellwährung kein Händlerkonto, lautet die Meldung SimplePay is not available for the currency of this order. Please choose another payment method. Der technische Grund wird im Protokoll festgehalten. Eine Rückkehr, die keinem Zahlungsversuch zugeordnet werden kann, zeigt We could not match this payment to an order. If you were charged, please contact us.

Bei OpenCart 4 werden die Meldungen, die zurück zur Kasse führen, oberhalb der Kassenseite angezeigt. Wurde die Bestellung für die Kasse inzwischen geschlossen, wird der Kunde mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. oder, wenn sie eine SimplePay-Zahlung hatte, mit Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. zur Kasse zurückgeschickt. Das nächste Confirm Order bezahlt eine neue Bestellung. Ist die Bestellung für die Kasse bereits bezahlt, hat sich der Warenkorb seitdem aber geändert, auch durch eine neue Menge, wird der Kunde zur Kasse zurückgeschickt, und der neue Warenkorb wird mit einer neuen Bestellung bezahlt.

Die IPN und die Rückkehr des Kunden funktionieren auch, wenn der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 legt die Erweiterung dafür eine Startaktion an.

Die Erweiterung nimmt nur einmalige Kartenzahlungen an, die auf der SimplePay-Seite erfasst werden. Sie unterstützt keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements oder wiederkehrenden Zahlungen und keine getrennte Autorisierung und Erfassung.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu SimplePay weitergeleitet und hat nicht bezahlt, die Zahlung ist fehlgeschlagen, abgebrochen oder abgelaufen, oder SimplePay hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Paid Order Status or Complete Order Status: die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Eine Notiz zeigt die SimplePay-Transaktions-ID und ob die IPN oder die Statusabfrage die Zahlung bestätigt hat.

On Hold (Review) Status (default Pending): Gesamtbetrag oder Währung der Bestellung wurden geändert, nachdem die Zahlung gestartet wurde, sodass der bezahlte Betrag von der Bestellung abweicht. Die Notiz zeigt beide Beträge. Prüfen Sie die Bestellung und liefern Sie sie aus oder erstatten Sie die Zahlung im SimplePay-Händleradministrator. Wird danach ein anderer Versuch desselben Warenkorbs mit dem richtigen Betrag bezahlt, erhält die Bestellung dieser Zahlung den bezahlten Status.

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

Eine bezahlte, erstattete oder abgeschlossene Bestellung wird durch eine verspätete IPN nie wieder geöffnet. Wenn eine zweite Zahlung für eine bereits bezahlte Bestellung oder für eine andere Bestellung desselben Warenkorbs erfolgreich ist, bleibt die bezahlte Bestellung unverändert. Eine Notiz bittet Sie, dies im SimplePay-Administrator zu prüfen und die Zahlung zu erstatten, wenn es ein Duplikat ist.

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

VibeFox SimplePay Gateway tab

Öffnen Sie unter Sales > Orders eine mit SimplePay bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox SimplePay Gateway die Transaction ID mit der Kennzeichnung Sandbox bei Sandbox-Zahlungen, die Order reference (orderRef), das Merchant account und den Modus, den SimplePay-Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf, die Payment attempts of the cart (wenn es mehr als einen gab) und die SimplePay notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox SimplePay Gateway den Amount ein (der noch nicht erstattete Betrag ist bereits eingetragen), optional einen Reason (optional, order note only), und klicken Sie auf Refund via SimplePay (OTP). Bestätigen Sie die Frage Refund this amount via SimplePay? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). HUF-Erstattungen müssen ganze Forint-Beträge sein. Die Erstattung wird für die SimplePay-Transaktion gesendet, die die Bestellung bezahlt hat, mit dem Händlerkonto und im Modus (Sandbox oder Live) dieser Zahlung, auch wenn der Shop inzwischen auf den anderen Modus umgestellt wurde; dieses Konto muss in den Einstellungen weiterhin vorhanden sein. Akzeptiert SimplePay die Erstattung nicht, zeigt der Reiter den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der SimplePay-Erstattungstransaktion und dem Grund, falls Sie einen eingegeben haben, dem Verlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht. Eine Bestellung in Prüfung nach einer Betragsabweichung kann nicht über den Reiter erstattet werden: Erstatten Sie sie im SimplePay-Händleradministrator.

Produktrücksendungen unter Sales > Returns senden kein Geld über SimplePay zurück. Im SimplePay-Händleradministrator vorgenommene Erstattungen werden nicht mit OpenCart synchronisiert. Erfassen Sie sie manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox SimplePay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox SimplePay 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-simplepay und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder 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 auf einer Domain: der 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 SimplePay Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin im selben Browser angemeldet ist, sieht die Zahlungsart weiterhin im Shop, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin nicht, daher wird ohne aktiven Schlüssel die Zahlungsart für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admins eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch die IPN bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin öffnen: einmal täglich in den ersten 14 Tagen nach 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

SimplePay erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die Währung des Kunden HUF, EUR oder USD ist und diese Währung im aktuellen Modus sowohl eine Merchant ID als auch einen Secret key hat: die Sandbox-Konten, solange Sandbox mode eingeschaltet ist, die Live-Konten, solange es ausgeschaltet ist. Prüfen Sie außerdem, ob die Rechnungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Die IPN hat den Shop nicht erreicht. Prüfen Sie im SimplePay-Händleradministrator die IPN URL des Händlerkontos, das Sie verwenden (Live oder Sandbox, die Währung der Bestellung). Sie muss genau der URL entsprechen, die in den Einstellungen angezeigt wird, und Ihr Server muss aus dem Internet erreichbar sein. Die Bestellung erhält ihren Status auch dann, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

IPN antwortet Invalid signature.: Die IPN nennt ein Händlerkonto, das nicht in den Einstellungen steht, dessen Secret key falsch ist, oder sie ist mit dem Konto des anderen Modus signiert als die Zahlung. Geben Sie MERCHANT und SECRET KEY genau so ein, wie sie der SimplePay-Händleradministrator anzeigt. SimplePay wiederholt unbestätigte IPNs.

IPN antwortet Order not found. oder Unknown transaction.: Die IPN betrifft eine Zahlung, die dieser Shop nicht gestartet hat. Es wird nichts geändert.

IPN antwortet Busy, retry.: Der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. SimplePay wiederholt die IPN. Der Grund wird im Protokoll festgehalten.

Der Kunde sieht The SimplePay payment could not be started: Sehen Sie im Feld Log auf der Seite der Erweiterung nach. Ein falscher geheimer Schlüssel führt zu Invalid response signature from SimplePay. Check the secret key of the merchant account. SimplePay-Fehler werden mit ihren Fehlercodes protokolliert.

Der Kunde sieht This payment method is not available.: Die Kasse passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen ausgeschaltet. Der Kunde lädt die Kasse neu.

Nach dem Wechsel zwischen Sandbox und Live: Neue Zahlungen verwenden die Konten des neuen Modus. Zuvor gestartete Zahlungen behalten das Händlerkonto und den Modus, mit denen sie gestartet wurden: Ihre IPNs, Statusabfragen und Erstattungen verwenden dieses Konto. Behalten Sie die Konten des alten Modus in den Einstellungen, solange solche Zahlungen offen sind oder erstattet werden können.

Bestellung befindet sich nach der Zahlung im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox SimplePay Gateway. Der Gesamtbetrag oder die Währung der Bestellung wurde geändert, nachdem die Zahlung gestartet wurde. Liefern Sie die Bestellung aus oder erstatten Sie die Zahlung im SimplePay-Händleradministrator.

Kein Erstattungsformular im Reiter: Der Reiter nennt den Grund: Die Bestellung ist nicht durch eine SimplePay-Transaktion bezahlt (zum Beispiel nach einer Betragsabweichung), sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder das Händlerkonto der Zahlung ist nicht in den Einstellungen vorhanden.

Erstattung schlägt fehl: Lesen Sie die Meldung im Reiter. SimplePay refunds in HUF must be whole amounts. bedeutet, dass der HUF-Betrag Dezimalstellen hatte. Sagt die Meldung, dass das Händlerkonto dieser Zahlung nicht konfiguriert ist, tragen Sie das Konto (Währung und Modus) erneut ein, mit dem die Zahlung erfolgte. Hat SimplePay einen anderen Betrag erstattet, bittet Sie die Meldung, die Erstattung im SimplePay-Administrator zu prüfen.

Für Entwickler: Bevor die Zahlung gestartet wird, löst die Erweiterung das OpenCart-Ereignis simplepay_op_payment_data mit den Zahlungsdaten und der Bestellung aus. Händler, Bestellreferenz, Währung, Gesamtbetrag und Rücksprung-URL können dort nicht geändert werden.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox SimplePay Gateway 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 Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (bei OpenCart 4 seine Ereignisse und seine Startaktion, die die IPN und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete Data on Uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Händlerkonten, Protokollierung) und das Protokoll entfernt. Ist es deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die SimplePay-Transaktionen und -Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Bei OpenCart 4 entfernen Sie außerdem die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox SimplePay Gateway auf Uninstall (der orangefarbene −-Button) und danach auf Delete (der rote Papierkorb-Button), um das hochgeladene Paket zu entfernen.

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