VibeFox Satispay for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer mit der OpenSSL-Erweiterung. Das Modul lässt sich auf älteren PHP-Versionen oder ohne OpenSSL nicht installieren.

Währung: EUR. Satispay berechnet nur Euro, daher wird die Zahlungsart ausgeblendet, wenn die Warenkorbwährung nicht EUR ist.

Satispay-Konto: ein Satispay-Business-Konto. Sie kopieren keine API-Schlüssel: Das Modul 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 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 eingerichtet werden.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel gilt 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. Klicken Sie nach Abschluss des Uploads auf Configure, oder suchen Sie später VibeFox Satispay Gateway in der Modulliste und klicken Sie auf Configure.

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

4. Wählen Sie die Umgebung: Aktivieren Sie Sandbox Mode für Tests, lassen Sie ihn für echte Zahlungen deaktiviert.

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 dann Sandbox Mode und verbinden Sie die Live-Umgebung mit einem Live-Aktivierungscode.

Bei der Installation legt das Modul den Bestellstatus Satispay payment on hold an. PrestaShop bietet ein neues Zahlungsmodul für alle Währungen, Länder und Kundengruppen an. Sie können diese unter Payment > Preferences einschränken. Dort muss das Modul für den Euro erlaubt sein.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Satispay Gateway > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die gesamte Seite speichert.

Kasse

Was Kunden in der Liste der Zahlungsmethoden sehen.

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

Title: der Name der Zahlungsmethode, der an der Kasse angezeigt wird. Er ist auch der Name der Zahlungsmethode, der in der Bestellung gespeichert wird. Standard: Satispay. Pflichtfeld.

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

Satispay-Verbindung

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

Sandbox Mode: nutzt die Satispay-Sandbox (Testumgebung). Sandbox-Zahlungen werden nicht berechnet. Standard: off. 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 Zahlungsmethode Sandbox mode: no real money is charged.

Activation Code: um die oben gewä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. 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 beizubehalten.

Wenn Sie mit einem Code speichern, erzeugt das Modul ein RSA-Schlüsselpaar, sendet den öffentlichen Schlüssel und den Code an Satispay und speichert die Key ID und die Schlüssel dieser Umgebung in der Shop-Konfiguration. Die privaten Schlüssel werden nie angezeigt. 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 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 ihre bisherige Verbindung.

Zahlungsbenachrichtigungen

In Satispay ist nichts einzurichten. Jede Zahlung trägt ihre eigene Callback-URL, die Satispay aufruft, wenn sich die Zahlung ändert, und das Modul liest die Zahlung vor dem Anlegen oder Ändern einer Bestellung erneut über die Satispay-API. Das Feld Callback URL zeigt ein Beispiel dieser URL. Mit aktivierten freundlichen URLs sieht sie so aus: https://your-shop/module/wcp_satispay_gateway/callback?id_cart={cart}&payment_id={uuid}, eventuell mit einem Sprachcode wie /en/. Die URL muss aus dem Internet erreichbar sein: keine Basis-Authentifizierung davor. Der Callback funktioniert, während der Shop im Wartungsmodus ist, und wird nicht durch die Ländereinschränkung Ihres Shops blockiert.

Erweitert

Debug log: schreibt API-Aufrufe und Zahlungsereignisse in logs/satispay_p_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. Schlüssel und Kundendaten werden nicht protokolliert. Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Standard: 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: wenn aktiviert, entfernt die Deinstallation des Moduls die Einstellungen, die Satispay-Schlüssel beider Umgebungen und das Protokoll. Die für Bestellungen gespeicherten Satispay-Zahlungen und -Rückerstattungen sowie der Bestellstatus Satispay payment on hold bleiben immer erhalten. Standard: off.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig Satispay) und bestätigt die Bestellung. Das Modul erstellt eine Satispay-Zahlung über den Warenkorbbetrag in Euro, mit der Warenkorbnummer als Referenz, und leitet den Kunden zur Satispay-Zahlungsseite weiter. Am Computer scannt der Kunde den QR-Code mit der Satispay-App. Am Smartphone bestätigt der Kunde die Zahlung in der App. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Satispay die Zahlung bestätigt: Das Modul liest die Zahlung über die Satispay-API, prüft, dass sie für diesen Warenkorb erstellt wurde, und vergleicht Status, Betrag (in Cent) und Währung mit dem Warenkorb. Dies geschieht sowohl, wenn Satispay die Callback-URL aufruft, als auch wenn der Kunde zurückkehrt – je nachdem, was zuerst eintrifft. Dann wird die Bestellung angelegt und der Kunde sieht die übliche Bestellbestätigungsseite. Hat Satispay die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, 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 legt die Bestellung an, sobald er eintrifft.

Verlässt der Kunde die Satispay-Seite, ohne zu zahlen, storniert das Modul die Zahlung bei Satispay, sodass die verlassene Seite nicht mehr bezahlt werden kann. Der Kunde ist zurück an der 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.

Bevor für denselben Warenkorb eine neue Satispay-Zahlung erstellt wird, wird die vorherige geprüft: Eine ausstehende Zahlung wird bei Satispay storniert, und war sie bereits bezahlt, wird die Bestellung mit dieser Zahlung angelegt und keine zweite Zahlung ausgeführt.

Lässt sich die Zahlung nicht starten, bleibt der Kunde an der Kasse mit einer kurzen Meldung: Satispay is not available at the moment. Please choose another payment method., wenn der Shop nicht verbunden ist oder Satispay die Schlüssel ablehnt, oder Unable to create the Satispay payment. Please try again or choose another payment method. bei anderen Fehlern. Der Grund wird im Protokoll festgehalten.

Das Modul nimmt nur einmalige Zahlungen in Euro an. Es unterstützt keine Abonnements, gespeicherten Zahlungsmethoden, Vorautorisierungen oder Essensgutscheine. Es gibt keine geplante Prüfung ausstehender Zahlungen: Erreichen weder der Callback von Satispay noch die Rückkehr des Kunden Ihren Shop, wird keine Bestellung angelegt, und die Zahlung ist im Satispay Dashboard sichtbar.

Bestellungen und Rückerstattungen

Bestellstatus

No order yet: der Kunde wurde zu Satispay weitergeleitet und hat nicht bezahlt, oder Satispay hat die Zahlung noch nicht bestätigt. Es existieren nur der Warenkorb und die Satispay-Zahlung des Moduls.

Payment accepted: die Zahlung wurde bestätigt. Die Zahlung wird mit der Satispay-Zahlungs-ID als Transaktions-ID erfasst, und eine Notiz zeigt die Satispay-Zahlung, den Betrag und die Art der Prüfung (callback, redirect or checkout).

Satispay payment on hold: Satispay hat einen anderen Betrag oder eine andere Währung gemeldet als den Warenkorbbetrag (zum Beispiel wurde der Warenkorb in einem anderen Tab geändert, nachdem die Zahlung gestartet war), oder die Zahlung wurde akzeptiert, nachdem die Bestellung storniert worden war. Der erhaltene Betrag wird an der Bestellung erfasst, und die Notiz erklärt dies. Prüfen Sie die Zahlung im Satispay Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung. Wird später eine andere Zahlung desselben Warenkorbs mit dem richtigen Betrag akzeptiert, wechselt die Bestellung zu Payment accepted.

Refunded: die Zahlung wurde über das Modul vollständig erstattet.

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

Satispay-Zahlungsblock

Die Bestellseite zeigt einen Block Satispay payment mit der Satispay-Zahlungs-ID, ihrem Status, dem bezahlten und erstatteten Betrag, einem Abzeichen Sandbox für Sandbox-Zahlungen, dem Rückerstattungsverlauf, der Liste Satispay payments of this cart mit jedem Zahlungsversuch und dessen Umgebung sowie den Satispay notes der Bestellung.

Rückerstattungen

Geben Sie im Block Satispay payment den Betrag ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Grund, und klicken Sie auf Refund via Satispay. Bestätigen Sie die Frage Refund this amount through Satispay? This cannot be undone. Volle und teilweise Rückerstattungen werden unterstützt. Sie benötigen das Recht, Bestellungen zu bearbeiten; der Zugriff auf die Modules-Seiten ist nicht nötig. Rückerstattungen sind auf den Betrag begrenzt, den Satispay für die Zahlung eingezogen hat. Nach einer Betragsabweichung können Sie also bis zu dem erstatten, was der Kunde tatsächlich bezahlt hat, nicht bis zum Bestellbetrag. Die Rückerstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Live oder Sandbox), daher muss diese Umgebung weiterhin verbunden sein. Eine Rückerstattung gilt nur dann als erfolgt, wenn Satispay sie akzeptiert: Eine erfolgreiche Rückerstattung wird dem Rückerstattungsverlauf und den Notizen mit der Satispay-Rückerstattungs-ID und dem Grund hinzugefügt. Lehnt Satispay die Rückerstattung ab, zeigt der Block den Fehler, und es wird keine Rückerstattung erfasst. Eine volle Rückerstattung setzt die Bestellung auf Refunded. Eine teilweise Rückerstattung ändert den Status nicht.

Das Modul erstellt keine Gutschriften. Die standardmäßigen PrestaShop-Rückerstattungsschaltflächen auf der Bestellseite senden kein Geld über Satispay zurück. Rückerstattungen, die im Satispay Dashboard vorgenommen werden, werden nicht in PrestaShop erfasst. Aktualisieren Sie die Bestellung bei Bedarf manuell.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Satispay Gateway ist der erste Block auf Modules > Module Manager > VibeFox Satispay Gateway > Configure, über den Einstellungen. Fügen Sie den Schlüssel in 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, 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: presta-payment-satispay 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 einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul weiter mit dem zuletzt bekannten Status.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Einrichtung. 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 an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Das Frontend von PrestaShop weiß nicht, dass Sie im Back Office angemeldet sind, daher ist die Zahlungsart auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Rückerstattungen funktionieren.

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

Fehlerbehebung

Satispay erscheint nicht an 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 die Warenkorbwährung EUR ist. Prüfen Sie unter Payment > Preferences, ob das Modul für den Euro, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung ist durchgegangen, aber es wurde keine Bestellung angelegt: Die Bestellung wird angelegt, wenn Satispay Ihren Shop aufruft oder wenn der Kunde zurückkehrt. Prüfen Sie, ob Ihr Shop aus dem Internet erreichbar ist, ohne Basis-Authentifizierung 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.: Das Modul konnte die Zahlung nicht von Satispay abrufen, oder die Umgebung der Zahlung ist nicht verbunden. Es wird keine Bestellung 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 die Bestellung konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). 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 diesen Warenkorb 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, 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. Wenn die Seite meldet, dass kein RSA-Schlüsselpaar erzeugt werden konnte, bitten Sie Ihren Hoster, die PHP-Erweiterung OpenSSL zu aktivieren. Wenn Satispay nicht erreicht werden konnte, prüfen Sie, ob Ihr Server ausgehende HTTPS-Verbindungen öffnen kann.

Satispay ist nach dem Wechsel von Sandbox zu Live aus der Kasse verschwunden: 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 Zahlungsmethode ist für den Warenkorb nicht erlaubt (Land, Währung oder Kundengruppe unter Payment > Preferences), ist deaktiviert oder die verwendete Umgebung ist nicht verbunden.

Bestellung ist nach der Zahlung Satispay payment on hold: Lesen Sie die Notizen im Block Satispay payment (siehe Bestellstatus), prüfen Sie die Zahlung im Satispay Dashboard und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung.

Rückerstattung schlägt fehl, weil die Umgebung nicht mehr verbunden ist: Die Zahlung wurde in Live oder Sandbox getätigt, und diese Umgebung hat jetzt keine Schlüssel mehr. Verbinden Sie sie erneut mit einem Aktivierungscode 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. PrestaShop hat die Rückerstattung nicht erfasst, und eine Notiz weist darauf hin. Prüfen Sie es im Satispay Dashboard.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Satispay Gateway und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data on uninstall aktiviert, werden die Einstellungen, die Satispay-Schlüssel beider Umgebungen und das Protokoll entfernt. Ist es deaktiviert, bleiben alle Einstellungen und Schlüssel für eine spätere Neuinstallation erhalten. Die für Bestellungen gespeicherten Satispay-Zahlungen und -Rückerstattungen sowie der Bestellstatus Satispay payment on hold 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 und Transaktions-IDs.

Satispay ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit Satispay verbunden noch wird es von Satispay empfohlen.