VibeFox Satispay 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 mit der OpenSSL-Erweiterung. Die Erweiterung erstellt ihre RSA-Schlüssel mit OpenSSL.

Währung: EUR. Satispay berechnet ausschließlich Euro. Die Währung EUR muss unter System > Localisation > Currencies aktiviert sein, und die Zahlungsart wird nur angezeigt, solange der Kunde EUR ausgewählt hat.

Satispay-Konto: ein Satispay-Business-Konto. Sie kopieren keine API-Schlüssel: Die Erweiterung verbindet sich über einen einmaligen Aktivierungscode, den Sie im Satispay Business Dashboard erzeugen (siehe Konfiguration). Für Tests benötigen Sie ein Satispay-Sandbox-Konto, das Sie bei Satispay für Entwickler anfordern.

Öffentlicher Shop: Ihr Shop muss aus dem Internet erreichbar sein, damit Satispay ihn aufrufen kann, wenn sich eine Zahlung ändert. Dafür muss in Satispay nichts konfiguriert werden.

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_satispay_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_satispay_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_satispay_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 Satispay 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. Wählen Sie die Umgebung: Aktivieren Sie Sandbox Mode für Tests, lassen Sie es für echte Zahlungen ausgeschaltet.

5. Fügen Sie einen Aktivierungscode dieser Umgebung in Activation Code ein und klicken Sie auf Save. Das Feld Status zeigt dann Connected mit der Key ID an.

6. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung in der Sandbox, deaktivieren Sie danach Sandbox Mode und verbinden Sie die Live-Umgebung mit einem Live-Aktivierungscode.

OpenCart 4

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

4. Geben Sie den Lizenzschlüssel ein, wählen Sie die Umgebung und verbinden Sie sie mit einem Aktivierungscode, wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Callback-URL ist anders (siehe Zahlungsbenachrichtigungen).

Eine Neuinstallation startet mit deaktivierter Zahlungsart und mit der Live-Umgebung als ausgewählter Umgebung.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Satispay 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 Zahlungsart aktiviert ist, die verwendete Umgebung aber nicht verbunden ist (die Zahlungsart wird dann in der Kasse ausgeblendet), und wenn die Standardwährung des Shops nicht EUR ist (die Zahlungsart wird dann nur angezeigt, solange der Kunde EUR ausgewählt hat). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein (negative Zahlen 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 und der Aktivierungscode nicht gesendet.

Kasse

Enable/Disable: Enable Satispay payment 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: Satispay. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Bestätigungsschaltfläche angezeigt wird. Default: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

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

Geo Zone: bietet Satispay 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 Satispay angeboten wird: eine Zahl, 0 oder größer. Lassen Sie das Feld leer, um Satispay bei jedem Betrag anzubieten.

Satispay-Verbindung

Status: der Zustand beider Umgebungen, zum Beispiel Live: Connected mit der Key ID oder Sandbox: Not connected, sowie welche Umgebung in use ist. Solange die verwendete Umgebung nicht verbunden ist, steht im Feld Satispay is hidden at checkout until the environment in use is connected.

Sandbox Mode: verwendet die Satispay-Sandbox (Testumgebung). Sandbox-Zahlungen werden nicht berechnet. Default: off. Sandbox und Live haben getrennte Schlüssel: Verbinden Sie jede Umgebung mit einem Aktivierungscode dieser Umgebung. Solange die Sandbox verwendet wird, sehen Kunden im Schritt Confirm Order den Hinweis Sandbox mode: no real money is charged.

Activation Code: Um die oben ausgewählte Umgebung zu verbinden, fügen Sie einen neuen 6-stelligen Aktivierungscode ein und klicken Sie auf Save. Live-Codes werden im Satispay Business Dashboard im Bereich Online shop erzeugt (das Feld verlinkt dorthin). Sandbox-Codes erhalten Sie mit einem Satispay-Sandbox-Konto. Der Code wird nur einmal verwendet und nicht gespeichert. Lassen Sie das Feld leer, um die bestehende Verbindung beizubehalten.

Wenn Sie mit einem Code speichern, werden zuerst die Einstellungen gespeichert. Danach erzeugt die Erweiterung ein RSA-Schlüsselpaar, sendet den öffentlichen Schlüssel und den Code an Satispay und speichert die Key ID sowie die Schlüssel der verwendeten Umgebung. Die privaten Schlüssel werden nie angezeigt und nie exportiert. Bei Erfolg zeigt die Seite zum Beispiel Satispay Live connected. Key ID: gefolgt von der ID. Lehnt Satispay den Code ab, zeigt die Seite Satispay activation failed: mit der Meldung von Satispay und bittet Sie zu prüfen, ob der Code zu dieser Umgebung gehört und noch nicht verwendet wurde; die bestehende Verbindung bleibt erhalten. Ein Code, der nicht aus 4 bis 64 Buchstaben und Ziffern besteht, wird abgelehnt, bevor etwas gesendet wird. Ein neuer Code für eine Umgebung ersetzt deren bisherige Verbindung.

Zahlungsbenachrichtigungen

In Satispay ist nichts zu konfigurieren. Jede Zahlung hat eine eigene Callback-URL, die Satispay aufruft, wenn sich die Zahlung ändert, und die Erweiterung liest die Zahlung über die Satispay-API erneut ein, bevor eine Bestellung geändert wird. Das Feld Callback URL zeigt ein Beispiel dieser URL. Bei OpenCart 3 sieht sie so aus: https://your-store/index.php?route=extension/payment/wcp_satispay_gateway/callback&satispay_p_order={order}&payment_id={uuid}, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_satispay_gateway/payment/wcp_satispay_gateway.callback&satispay_p_order={order}&payment_id={uuid}. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Die URL muss aus dem Internet erreichbar sein: Davor darf keine Firewall und keine Basisauthentifizierung stehen. Der Wartungsmodus von OpenCart blockiert sie nicht. Kann der Callback Ihren Shop nicht erreichen, wird die Bestellung bestätigt, sobald der Kunde 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 Satispay die Zahlung akzeptiert hat. Jedes Feld unten listet Ihre Bestellstatus in OpenCart auf.

Order Status After Payment: der Status, der nach der akzeptierten Zahlung gesetzt wird. Default: Processing.

Satispay Payment On Hold Status: Das Geld wurde empfangen, aber die Bestellung muss geprüft werden (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

Debug log: schreibt API-Aufrufe und Zahlungsereignisse in satispay_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden; bei 5 MB wird sie nach satispay_p_debug.old.log.php verschoben. Schlüssel, Aktivierungscode 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, die Satispay-Schlüssel beider Umgebungen und das Protokoll entfernt. Die für Bestellungen gespeicherten Satispay-Zahlungen und -Erstattungen bleiben immer erhalten. Default: off.

Import / Export

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

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die Satispay-Verbindung bleibt erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Satispay). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the Satispay page: scan the QR code with the Satispay app or confirm the payment on your phone. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Satispay-Zahlung über den Bestellbetrag in Euro, mit der Bestellnummer als Referenz, und leitet den Kunden zur Satispay-Zahlungsseite weiter. Auf dem Computer scannt der Kunde den QR-Code mit der Satispay-App. Auf dem Smartphone bestätigt der Kunde die Zahlung in der App. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart, im Fenster Payment method options, und klickt unten auf der Kassenseite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Satispay die Zahlung bestätigt: Die Erweiterung liest die Zahlung über die Satispay-API, prüft, ob sie für diese Bestellung erstellt wurde, und vergleicht ihren Status, ihren Betrag (in Cent) und ihre Währung mit der Bestellung. Dies geschieht sowohl dann, wenn Satispay die Callback-URL aufruft, als auch dann, wenn der Kunde zurückkehrt, je nachdem, was zuerst eintritt. 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. Hat Satispay die Zahlung noch nicht bestätigt, wenn der Kunde zurückkommt, zeigt eine Seite Payment confirmation die Meldung Satispay has not confirmed your payment yet. The order will be updated automatically as soon as the confirmation arrives. und eine Schaltfläche Check again. Der Callback setzt den Bestellstatus, sobald er eintrifft.

Verlässt der Kunde die Satispay-Seite, ohne zu zahlen, storniert die Erweiterung die Zahlung bei Satispay, sodass die verlassene Seite nicht mehr bezahlt werden kann. Der Kunde gelangt zurück zur Kasse mit der Meldung Your Satispay payment was cancelled and nothing was charged. You can try again or choose another payment method. Dieselbe Meldung erscheint, wenn der Kunde die Zahlung in der App ablehnt. Der Warenkorb bleibt erhalten.

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 und aktualisiert sie, sodass nach einer abgebrochenen Zahlung dieselbe Bestellung mit einer neuen Satispay-Zahlung bezahlt wird. Bevor eine neue Satispay-Zahlung erstellt wird, werden die früheren Zahlungen des Warenkorbs geprüft: Eine ausstehende Zahlung wird bei Satispay storniert, und wurde bereits eine bezahlt, bestätigt sie ihre Bestellung; es wird keine zweite Zahlung ausgeführt, und der Kunde gelangt direkt zur Erfolgsseite.

Bei OpenCart 4 wird die Meldung über die abgebrochene Zahlung oberhalb der Kassenseite angezeigt. Wurde die Bestellung der Kasse inzwischen vom Shop geschlossen (zum Beispiel storniert oder erstattet) oder ist sie bereits bezahlt, hat sich der Warenkorb seitdem aber geändert, auch durch eine neue Menge, wird der Kunde mit Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. oberhalb der Kassenseite zur Kasse zurückgeschickt, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche: Satispay is not available at the moment. Please choose another payment method., wenn Satispay die Schlüssel ablehnt; Satispay supports EUR currency only. bei einer Bestellung in einer anderen Währung; oder Unable to create the Satispay payment. Please try again or choose another payment method. bei anderen Fehlern. Der Grund wird im Protokoll festgehalten.

Der Callback 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 fügt die Erweiterung dafür eine Startaktion hinzu.

Die Erweiterung nimmt nur einmalige Zahlungen in Euro an. Sie unterstützt keine Abonnements, keine gespeicherten Zahlungsmethoden, keine Vorautorisierungen und keine Essensgutscheine. Es gibt keine geplante Prüfung ausstehender Zahlungen: Erreichen weder der Satispay-Callback noch die Rückkehr des Kunden Ihren Shop, bleibt die Bestellung ohne Status, und die Zahlung ist im Satispay Dashboard sichtbar.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu Satispay weitergeleitet und hat nicht bezahlt, oder Satispay hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. Eine abgebrochene Satispay-Zahlung lässt die Bestellung ohne Status, und der Kunde kann erneut bezahlen.

Order Status After Payment (default Processing): Die Zahlung wurde akzeptiert. Eine Notiz zeigt die Satispay-Zahlung, den Betrag und wie sie geprüft wurde (Callback, Weiterleitung oder Kasse).

Satispay Payment On Hold Status (default Pending): Satispay hat einen anderen Betrag oder eine andere Währung gemeldet als der Bestellbetrag, oder die Zahlung wurde akzeptiert, nachdem die Bestellung einen anderen Status erhalten hatte (zum Beispiel storniert). Die Notiz erklärt dies. Prüfen Sie die Zahlung im Satispay Dashboard und liefern Sie dann die Bestellung aus oder erstatten Sie die Zahlung. Wird später eine weitere Zahlung desselben Warenkorbs mit dem richtigen Betrag akzeptiert, wechselt die Bestellung zu Order Status After Payment.

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

Wird eine zweite Zahlung für eine bereits bezahlte Bestellung oder für eine andere Bestellung desselben Warenkorbs akzeptiert, bleibt die bezahlte Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im Satispay Dashboard zu erstatten.

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

VibeFox Satispay Gateway tab

Öffnen Sie unter Sales > Orders eine mit Satispay bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Satispay Gateway die Satispay payment ID mit der Kennzeichnung Sandbox bei Sandbox-Zahlungen, den Status der Zahlung, die Beträge Paid / refunded, das Erstattungsformular, den Verlauf Refunds, die Liste Satispay payments of this cart mit jedem Zahlungsversuch, dessen Bestellung und Umgebung, sowie die Satispay notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox Satispay Gateway den Amount ein (der noch nicht erstattete Betrag ist bereits eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Satispay. Bestätigen Sie die Frage Refund this amount through Satispay? 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). Erstattungen sind auf den Betrag begrenzt, den Satispay für die Zahlung berechnet hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht bis zum Bestellbetrag. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Live oder Sandbox), daher muss diese Umgebung weiterhin verbunden sein. Eine Erstattung gilt nur dann als erledigt, wenn Satispay sie akzeptiert: Eine erfolgreiche Erstattung wird mit der Satispay-Erstattungs-ID und dem Grund dem Verlauf und den Notizen hinzugefügt. Akzeptiert Satispay die Erstattung nicht, zeigt der Reiter den Fehler an, und es wird keine Erstattung erfasst. 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. Erstattungen sind verfügbar, sobald Satispay die Zahlung akzeptiert hat.

Produktrücksendungen unter Sales > Returns senden kein Geld über Satispay zurück. Im Satispay Dashboard vorgenommene Erstattungen werden nicht in OpenCart erfasst. Aktualisieren Sie die Bestellung bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Satispay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Satispay 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-satispay 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 Satispay 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 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

Satispay erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die verwendete Umgebung verbunden ist (das Feld Status zeigt dafür Connected) und der Kunde EUR ausgewählt hat. 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 Bestellung erhält ihren Status, wenn Satispay Ihren Shop aufruft oder wenn der Kunde zurückkehrt. Prüfen Sie, dass Ihr Shop aus dem Internet erreichbar ist, ohne Firewall oder Basisauthentifizierung vor der Callback-URL, und aktivieren Sie Debug log, um die Callbacks im Feld Log zu sehen. Die Zahlung ist im Satispay Dashboard sichtbar.

Callback antwortet Payment status unavailable, retry later. oder Not configured.: Die Erweiterung konnte die Zahlung nicht von Satispay abrufen, oder die Umgebung der Zahlung ist nicht verbunden. Keine Bestellung wird geändert. Satispay ruft erneut auf. Prüfen Sie den Verbindungsstatus und das Protokoll.

Callback antwortet Busy, retry later.: Der Warenkorb wurde im selben Moment von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Satispay ruft erneut auf. Das Protokoll zeigt den Grund.

Callback antwortet Unknown payment. oder Missing or invalid payment_id.: Die Zahlung wurde nicht von diesem Shop für diese Bestellung erstellt, oder die Anfrage ist kein Satispay-Callback. Es wird nichts geändert.

Aktivierung schlägt fehl: Aktivierungscodes können nur einmal verwendet werden. Prüfen Sie, dass der Code zu der unter Sandbox Mode gewählten Umgebung gehört (ein Live-Code für Live, ein Sandbox-Code für die Sandbox), erzeugen Sie einen neuen Code und speichern Sie erneut. Meldet die Seite, dass kein RSA-Schlüsselpaar erzeugt werden konnte, bitten Sie Ihren Hoster, die PHP-OpenSSL-Erweiterung zu aktivieren. Konnte Satispay nicht erreicht werden, prüfen Sie, ob Ihr Server ausgehende HTTPS-Verbindungen öffnen kann.

Satispay verschwand aus der Kasse nach dem Wechsel von Sandbox auf Live: Sandbox und Live verwenden unterschiedliche Schlüssel. Fügen Sie einen Live-Aktivierungscode ein, während Sandbox Mode ausgeschaltet ist, und speichern Sie.

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.

Bestellung befindet sich nach der Zahlung im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox Satispay Gateway (siehe Order statuses), prüfen Sie die Zahlung im Satispay Dashboard und liefern Sie dann die Bestellung aus oder erstatten Sie die Zahlung.

Kein Erstattungsformular im Reiter: Der Reiter nennt den Grund: Die Bestellung hat keine akzeptierte Satispay-Zahlung, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder die Umgebung der Zahlung ist nicht mehr verbunden.

Erstattung schlägt fehl, weil die Umgebung nicht mehr verbunden ist: Die Zahlung erfolgte in Live oder Sandbox, und diese Umgebung hat jetzt keine Schlüssel mehr. Verbinden Sie sie mit einem Aktivierungscode erneut oder erstatten Sie die Zahlung im Satispay Dashboard.

Erstattung schlägt fehl mit Satispay did not accept the refund: Satispay hat einen anderen Status als accepted zurückgegeben. OpenCart hat die Erstattung nicht erfasst, und eine Notiz weist darauf hin. Prüfen Sie dies im Satispay Dashboard.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Satispay 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. Bei OpenCart 4 werden außerdem das Ereignis der Erweiterung und ihre Startaktion entfernt, die den Callback 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, Protokollierung), die Satispay-Schlüssel beider Umgebungen und das Protokoll entfernt. Ist es deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten, einschließlich der Satispay-Verbindung. Die für Bestellungen gespeicherten Satispay-Zahlungen und -Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation erstattet werden können, sobald die Umgebung wieder verbunden ist. 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 Satispay Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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