VibeFox Satispay for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

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

PHP: 8.0 oder neuer mit der OpenSSL-Erweiterung. Ohne OpenSSL zeigt das Plugin im Administrationsbereich einen Fehler, und die Zahlungsart wird nicht geladen.

Währung: EUR. Satispay berechnet nur Euro, daher wird die Zahlungsart ausgeblendet, wenn die Shop-Währung (auf der Seite „Pay for order“ die Bestellwährung) nicht EUR ist.

Satispay-Konto: ein Satispay-Business-Konto. Sie kopieren keine API-Schlüssel: Das Plugin verbindet sich mit einem 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 for developers anfordern.

Öffentliche Website: Ihre Website muss aus dem Internet erreichbar sein, damit Satispay sie aufrufen kann, wenn sich eine Zahlung ändert. Dafür muss bei Satispay nichts konfiguriert werden.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Satispay > Manage oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock am Anfang der Seite ein und klicken Sie auf Activate.

5. Wählen Sie die Umgebung: Setzen Sie für Tests den Haken bei Sandbox Mode, lassen Sie ihn für echte Zahlungen leer.

6. Fügen Sie einen Aktivierungscode dieser Umgebung in Activation Code ein und speichern Sie. Der Verbindungsstatus zeigt dann die Key ID an.

7. Aktivieren Sie Enable/Disable und speichern Sie. Testen Sie eine Zahlung in der Sandbox, entfernen Sie dann den Haken bei Sandbox Mode und verbinden Sie die Live-Umgebung mit einem Live-Aktivierungscode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Satispay. Der Abschnitt Satispay connection zeigt den Status beider Umgebungen, zum Beispiel Live: Connected mit der Key ID oder Sandbox: Not connected, und markiert die verwendete Umgebung. Solange die verwendete Umgebung nicht verbunden ist, zeigt die Seite Satispay wird an der Kasse ausgeblendet, bis die verwendete Umgebung verbunden ist. In der WooCommerce-Liste der Zahlungsarten wird Satispay als einrichtungsbedürftig markiert, bis die verwendete Umgebung verbunden ist, und solange Sandbox Mode aktiv ist, erscheint ein Testmodus-Hinweis.

Enable/Disable: Enable Satispay payment schaltet die Zahlungsart ein oder aus. Standard: aus.

Kasse

Was Kunden in der Liste der Zahlungsarten sehen.

Title: der Name der Zahlungsart an der Kasse. Standard: Satispay.

Description: der Text unter der Zahlungsart an der Kasse. Standard: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay-Verbindung

Sandbox Mode: Use the Satispay sandbox (staging) environment. Sandbox-Zahlungen werden nicht belastet. Standard: aus. Sandbox und Live haben getrennte Schlüssel: Verbinden Sie jede Umgebung mit einem Aktivierungscode dieser Umgebung. Solange die Sandbox verwendet wird, sehen Kunden unter der Zahlungsart Sandbox-Modus: Es wird kein echtes Geld belastet.

Activation Code: Um die oben gewählte Umgebung zu verbinden, fügen Sie einen neuen 6-stelligen Aktivierungscode ein und speichern Sie. Live-Codes werden im Satispay Business Dashboard im Bereich Online shop erzeugt. Sandbox-Codes gibt es mit einem Satispay-Sandbox-Konto. Der Code wird nur einmal verwendet und nicht gespeichert. Lassen Sie das Feld leer, um die aktuelle Verbindung zu behalten.

Beim Speichern mit einem Code erzeugt das Plugin ein RSA-Schlüsselpaar, sendet den öffentlichen Schlüssel und den Code an Satispay und speichert Key ID und die Schlüssel dieser Umgebung in der WordPress-Datenbank. Bei Erfolg zeigt die Seite zum Beispiel Satispay Live connected. Key ID: gefolgt von der ID an. Lehnt Satispay den Code ab, zeigt die Seite die Meldung von Satispay und bittet Sie zu prüfen, ob der Code für diese Umgebung gilt und noch nicht verwendet wurde. Ein Code mit anderen Zeichen als Buchstaben und Ziffern wird abgelehnt, bevor etwas gesendet wird. Das Speichern eines neuen Codes für eine Umgebung ersetzt deren bisherige Verbindung.

Zahlungsbenachrichtigungen

Bei Satispay ist nichts zu konfigurieren. Jede Zahlung trägt eine eigene Callback-URL, die Satispay aufruft, wenn sich die Zahlung ändert, und das Plugin ruft die Zahlung vor jeder Änderung einer Bestellung erneut über die Satispay-API ab. Der Abschnitt zeigt ein Beispiel dieser URL. Sie sieht so aus: https://your-site/wc-api/satispay_payment_callback/?action=callback&order_id={order}&payment_id={uuid}. Die URL muss aus dem Internet erreichbar sein: kein Wartungsmodus und kein Passwortschutz für /wc-api/.

Erweitert

Debug log: Log API calls and payment events schreibt in WooCommerce > Status > Logs, Quelle wcp_satispay_gateway, ohne Schlüssel oder Kundendaten. Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. Standard: aus.

Delete data on uninstall: Remove the settings and Satispay keys when the plugin is deleted. Zahlungsdaten, die bei Bestellungen gespeichert sind, bleiben erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Satispay) und klickt auf Pay with Satispay. Das Plugin erstellt eine Satispay-Zahlung über den Bestellbetrag in Euro mit der Bestellnummer als Referenz und leitet den Kunden zur Satispay-Zahlungsseite weiter. Auf einem Computer scannt der Kunde den QR-Code mit der Satispay-App. Auf einem Smartphone bestätigt der Kunde die Zahlung in der App.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, nachdem Satispay die Zahlung bestätigt hat: Das Plugin ruft die Zahlung über die Satispay-API ab, prüft, dass sie für diese Bestellung erstellt wurde, und vergleicht Status, Betrag (in Cent) und Währung mit der Bestellung. Dies geschieht sowohl, wenn Satispay die Callback-URL aufruft, als auch wenn der Kunde zurückkehrt, je nachdem, was zuerst eintrifft. Ist die Zahlung noch nicht bestätigt, zeigt die Bestätigungsseite Satispay hat Ihre Zahlung noch nicht bestätigt. Die Bestellung wird automatisch aktualisiert, sobald die Bestätigung eintrifft.

Verlässt der Kunde die Satispay-Seite, ohne zu zahlen, storniert das Plugin die Zahlung bei Satispay, sodass die verlassene Seite nicht mehr bezahlt werden kann. Der Kunde wird zurück zur Kasse (oder zur Seite Pay for order) geschickt, mit der Meldung Ihre Satispay-Zahlung wurde storniert, und es wurde nichts belastet. Sie können es erneut versuchen oder eine andere Zahlungsart wählen. Dieselbe Meldung erscheint, wenn der Kunde die Zahlung in der App ablehnt.

Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen, zum Beispiel über die Seite Pay for order. Bevor eine neue Satispay-Zahlung erstellt wird, wird die vorherige geprüft: Eine ausstehende Zahlung wird bei Satispay storniert, und wenn sie bereits bezahlt wurde, wird die Bestellung mit dieser Zahlung als bezahlt markiert und keine zweite Zahlung erstellt.

Kann die Zahlung nicht gestartet werden, sieht der Kunde eine kurze Meldung und kann eine andere Zahlungsart wählen: Satispay ist derzeit nicht verfügbar. Bitte wählen Sie eine andere Zahlungsart. wenn der Shop nicht verbunden ist oder Satispay die Schlüssel ablehnt, oder Die Satispay-Zahlung kann nicht erstellt werden. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart. bei anderen Fehlern. Der Grund wird im Protokoll festgehalten.

Die Zahlungsart funktioniert an der klassischen Kasse, im Checkout-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin nimmt nur einmalige Zahlungen in Euro an. Es unterstützt keine Abonnements, gespeicherten Zahlungsmethoden, Vorautorisierungen oder Essensgutscheine. Eine geplante Prüfung offener Zahlungen gibt es nicht: Erreichen weder der Satispay-Callback noch die Rückkehr des Kunden Ihre Website, bleibt die Bestellung auf Zahlung ausstehend, und die Zahlung ist im Satispay Dashboard sichtbar.

Bestellungen und Rückerstattungen

Order statuses

Pending payment: Der Kunde wurde zu Satispay geschickt und hat noch nicht bezahlt, oder Satispay hat die Zahlung noch nicht bestätigt. Die Bestellnotiz zeigt die Satispay-Zahlungs-ID, den Betrag und die Umgebung (Live oder Sandbox).

Processing or Completed: Die Zahlung wurde bestätigt. Die Bestellung folgt der üblichen WooCommerce-Regel: In Bearbeitung, oder Abgeschlossen bei Bestellungen mit nur virtuellen, herunterladbaren Produkten. Die Bestellnotiz zeigt die Satispay-Zahlung, den Betrag und wie sie geprüft wurde (Callback, Weiterleitung oder Kasse). Die Transaktions-ID ist die Satispay-Zahlungs-ID.

On hold: Satispay meldete einen anderen Betrag oder eine andere Währung als der Bestellbetrag, oder die Zahlung wurde akzeptiert, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt dies, und die Zahlung wird als Transaktions-ID gespeichert, damit sie erstattet werden kann. Prüfen Sie die Zahlung im Satispay Dashboard und schließen Sie dann die Bestellung ab oder erstatten Sie die Zahlung.

Cancelled: Die letzte Satispay-Zahlung der Bestellung wurde storniert oder ist abgelaufen, zum Beispiel weil der Kunde die Satispay-Seite verlassen hat. Eine ältere Zahlung, die abläuft, storniert keine Bestellung mit einer neueren laufenden Zahlung. Bestellungen, die Sie im Administrationsbereich angelegt haben (Zahlungslinks), werden nicht storniert: Sie bleiben auf Zahlung ausstehend mit einer Notiz, damit der Kunde sie weiterhin bezahlen kann.

Wird eine zweite Zahlung für eine bereits bezahlte Bestellung akzeptiert, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, die doppelte Zahlung im Satispay Dashboard zu erstatten. Eine wiederholte Bestätigung öffnet nie eine stornierte oder erstattete Bestellung erneut.

Refunds

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Satispay. Volle und teilweise Rückerstattungen werden für mit Satispay bezahlte Bestellungen unterstützt. Die Rückerstattung wird an die Umgebung gesendet, in der die Zahlung erfolgt ist (Live oder Sandbox), daher muss diese Umgebung weiterhin verbunden sein. Eine Rückerstattung gilt erst als erledigt, wenn Satispay sie annimmt: Eine erfolgreiche Rückerstattung wird mit der Satispay-Rückerstattungs-ID und dem Grund in den Bestellnotizen vermerkt. Akzeptiert Satispay die Rückerstattung nicht, zeigt WooCommerce den Fehler an, und es wird keine Rückerstattung erfasst.

Im Satispay Dashboard vorgenommene Rückerstattungen werden nicht in WooCommerce-Rückerstattungen umgewandelt. Erstellen Sie bei Bedarf eine manuelle Rückerstattung in WooCommerce ohne Refund via Satispay.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Satispay. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, 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 funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Satispay 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, markiert als (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Ein Hinweis erscheint auf der Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Rückerstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, doch Updates und Support erfordern eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Satispay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die verwendete Umgebung verbunden ist (der Abschnitt Satispay connection zeigt für sie Connected) und die Währung EUR ist.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Zahlung ausstehend: Die Bestellung wird aktualisiert, wenn Satispay Ihre Website aufruft oder der Kunde zurückkehrt. Prüfen Sie, ob Ihre Website aus dem Internet erreichbar ist, ohne Wartungsmodus oder Passwortschutz für /wc-api/, und sehen Sie im Bereich WooCommerce > Status > Logs, Quelle wcp_satispay_gateway, nach. Die Zahlung ist im Satispay Dashboard sichtbar.

Callback antwortet Payment status unavailable, retry later oder Not configured: Das Plugin konnte die Zahlung nicht bei Satispay abrufen, oder die Umgebung der Bestellung ist nicht verbunden. Die Bestellung wird nicht verändert. Prüfen Sie den Verbindungsstatus und das Protokoll.

Callback antwortet Busy, retry later: Die Bestellung wurde gerade von einer anderen Anfrage aktualisiert. Durch diesen Callback wird die Bestellung nicht verändert. Sie wird beim nächsten Callback oder bei der Rückkehr des Kunden aktualisiert.

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

Aktivierung schlägt fehl: Aktivierungscodes können nur einmal verwendet werden. Prüfen Sie, ob der Code zur 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-Erweiterung OpenSSL zu aktivieren.

Satispay verschwand von der Kasse nach dem Wechsel von Sandbox zu Live: Sandbox und Live verwenden verschiedene Schlüssel. Fügen Sie einen Live-Aktivierungscode ein, wenn Sandbox Mode deaktiviert ist, und speichern Sie.

Bestellung ist On hold und die Notiz passt nicht zur Bestellung: Satispay meldete einen anderen Betrag oder eine andere Währung als den Bestellbetrag, etwa weil die Bestellung bearbeitet wurde, nachdem die Zahlung begonnen hatte. Prüfen Sie die Zahlung im Satispay Dashboard und schließen Sie dann die Bestellung ab oder erstatten Sie die Zahlung.

Rückerstattung 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.

Rückerstattung schlägt fehl mit Satispay did not accept the refund: Satispay hat einen anderen Status als accepted zurückgegeben. WooCommerce hat die Rückerstattung nicht erfasst. Prüfen Sie sie im Satispay Dashboard.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel 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 Adresse der Website 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 zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen, die Satispay-Schlüssel beider Umgebungen und die Plugin-Protokolle werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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