VibeFox Paysera for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

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

Paysera-Projekt: Sie benötigen die Projekt-ID und das Projektpasswort (Sign-Key) Ihres Paysera-Projekts. Die Zahlungsmethoden, die der Kunde sieht, sind die in diesem Projekt aktivierten. In Paysera muss für den Callback nichts eingerichtet werden: Seine URL wird mit jeder Zahlungsanfrage übermittelt.

Erreichbarer Shop: Bestellungen werden durch den Paysera-Callback angelegt. Ihr Shop muss deshalb aus dem Internet erreichbar sein, nicht hinter einer Anmeldung, einer Basisauthentifizierung oder einer Firewall. Der Callback funktioniert auch, wenn der Shop im Wartungsmodus ist.

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

Installation

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

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

3. Fügen 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. Geben Sie die Project ID und das Project password aus Ihrem Paysera-Konto ein (siehe Konfiguration).

5. Optional: Aktivieren Sie Allow test payments im Paysera-Projekt und Test payments im Modul, um den Ablauf ohne Geldabbuchung zu testen. Schalten Sie es vor dem Verkauf wieder aus.

6. Aktivieren Sie Enable/Disable und klicken Sie auf Save.

Bei der Installation legt das Modul zwei Bestellstatus an: Awaiting Paysera payment und Paysera payment on hold. PrestaShop bietet ein neues Zahlungsmodul für alle Währungen, Länder und Kundengruppen an. Sie können dies unter Payment > Preferences einschränken.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Paysera Payment > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Über den Feldern zeigt die Seite Paysera is hidden at checkout until the project ID and the project password are entered., solange eines der beiden fehlt, und Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders., solange Testzahlungen oder die Sandbox aktiv sind.

Paysera

Enable/Disable: Enable Paysera Payment schaltet die Zahlungsmethode ein oder aus. Standard: off.

Title: der Name der Zahlungsmethode, den der Kunde auf der Bestellseite sieht. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: Paysera. Pflichtfeld.

Description: der Text, der auf der Bestellseite unter der Zahlungsmethode angezeigt wird. Standard: Pay securely via Paysera.

Paysera-Projekt

Projekt-ID und Projektpasswort finden Sie in Ihrem Paysera-Konto unter Projects and activities, dann Ihr Projekt und General project settings.

Callback URL: die Adresse, über die Paysera jede Zahlung bestätigt. Mit schönen URLs sieht sie so aus: https://your-shop/module/wcp_paysera_payment/callback, eventuell mit einem Sprachcode. Sie wird bei jeder Zahlung automatisch übermittelt, daher muss in Paysera nichts eingerichtet werden, aber sie muss aus dem Internet erreichbar sein. Bestellungen werden nur durch diese signierten Callbacks angelegt.

Project ID: die numerische ID Ihres Paysera-Projekts. Es werden nur Ziffern akzeptiert: Jeder andere Wert führt zur Fehlermeldung Project ID must be a number: the numeric ID of your Paysera project., und nichts wird gespeichert.

Project password: das Projektpasswort (Sign-Key). Es signiert Zahlungsanfragen und prüft die Paysera-Callbacks. Das gespeicherte Passwort wird 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.

Clear saved password: Setzen Sie den Haken bei Project password und klicken Sie auf Save, um das gespeicherte Passwort zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Testen

Test payments: sendet Zahlungen im Testmodus, sodass kein Geld abgebucht wird. Paysera gibt eine erfolgreiche Testzahlung zurück, ohne den Kunden zu belasten. Aktivieren Sie zuerst Allow test payments in den Einstellungen des Paysera-Projekts. Solange diese Option aktiv ist, markieren Testzahlungen Bestellungen als bezahlt; ist sie ausgeschaltet, hält eine Testzahlung die Bestellung zurück. Standard: off. Solange sie aktiv ist, sehen Kunden unter der Zahlungsmethode TEST MODE — no money will be charged.

Environment: wohin der Kunde geschickt wird. Behalten Sie Production für ein normales Paysera-Projekt, auch für Testzahlungen. Standard: Production.

Erweitert

Debug log: schreibt Zahlungsereignisse in logs/wc_psr_debug.log.php im Modulordner. Die Datei lässt sich nicht über den Webbrowser öffnen. Fehler und Warnungen werden immer geschrieben, die übrigen Schritte nur, solange diese Option aktiv ist. Passwörter und Kundendaten werden nie geschrieben. 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: Wenn aktiviert, entfernt die Deinstallation des Moduls die Moduleinstellungen und das Protokoll. Bestelldaten (Bestellungen, Paysera-Zahlungsdatensätze, Bestellstatus) bleiben immer erhalten. Standard: off.

Bestellvorgang

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig Paysera) und bestätigt die Bestellung. Das Modul erstellt eine signierte Zahlungsanfrage mit dem Gesamtbetrag des Warenkorbs in der kleinsten Einheit der Warenkorbwährung, dem Namen, der E-Mail-Adresse und der Rechnungsadresse des Kunden sowie der Sprache der Shopseite (Litauisch, Lettisch, Estnisch, Russisch, Deutsch, Polnisch, sonst Englisch). Der Kunde wird zum Zahlungsfenster von Paysera weitergeleitet und wählt dort eine Bank, eine Karte oder eine andere Methode. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Paysera bestätigt die Zahlung mit einem Server-zu-Server-Callback. Die Bestellung wird erst als bezahlt markiert, wenn Paysera die Zahlung mit einem signierten Callback bestätigt; die Rückkehr des Kunden in den Shop legt nie eine Bestellung an und bezahlt nie eine. Kehrt der Kunde nach dem Callback zurück, wird die übliche Bestellbestätigungsseite angezeigt. Hat die Bank den Zahlungsauftrag angenommen, aber noch nicht ausgeführt, wird die Bestellung im Status Awaiting Paysera payment angelegt, und die Seite zeigt Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Bei einer Bestellung auf Halten zeigt die Seite Your payment is being reviewed. We will contact you if anything else is needed.

Kehrt der Kunde zurück, bevor der Callback eingegangen ist, erklärt eine Seite Payment confirmation, dass die Bestellung angelegt wird, sobald Paysera die Zahlung bestätigt, und bietet Check again und Back to checkout an.

Bricht der Kunde im Zahlungsfenster von Paysera ab, kehrt er zum Bestellvorgang zurück, mit The Paysera payment was cancelled. You can try again or choose another payment method. Teilt Paysera mit, dass die Zahlung nicht ausgeführt wurde, lautet die Meldung The payment was not completed. You can try again or choose another payment method. In beiden Fällen bleibt der Warenkorb erhalten. Hat der Warenkorb bereits eine Bestellung, führt ein neuer Versuch direkt zur Bestellbestätigung statt zu einer zweiten Zahlung.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Bestellvorgang mit Paysera payments are temporarily unavailable. Please choose another payment method. oder bei einem ungültigen Bestellbetrag mit This order cannot be paid via Paysera. Der Grund wird im Protokoll gespeichert.

Der Callback funktioniert, während sich der Shop im Wartungsmodus befindet, und wird nicht durch die Länderbeschränkung Ihres Shops blockiert.

Das Modul bietet im Back Office keine Erstattungen, auf der Bestellseite keine Auswahl von Bank oder Zahlungsmethode, keine Abonnements, keine gespeicherten Karten und keine Versand- oder Kurierdienste von Paysera.

Bestellungen

Bestellstatus

No order yet: Der Kunde wurde zu Paysera weitergeleitet, und der Callback ist noch nicht eingegangen, oder der Kunde hat abgebrochen. Es existiert nur der Warenkorb.

Payment accepted: Paysera hat die Zahlung mit passendem Betrag und passender Währung bestätigt. Die Zahlung wird mit der Paysera-Anfrage-ID als Transaktions-ID erfasst, und eine Notiz zeigt die Anfrage und die Zahlungsmethode, bei Testzahlungen mit der Kennzeichnung (TEST — no money charged).

Awaiting Paysera payment: Paysera hat den Zahlungsauftrag angenommen, aber die Bank hat ihn noch nicht ausgeführt. Die Bestellung wechselt zu Payment accepted, sobald Paysera die Zahlung bestätigt.

Paysera payment on hold: Die Zahlung braucht eine manuelle Prüfung. Der bezahlte Betrag oder die Währung weicht vom Warenkorb oder vom Bestellbetrag ab, eine TEST-Zahlung ist eingegangen, während Test payments ausgeschaltet war (es wurde kein Geld abgebucht), oder die Zahlung wurde bestätigt, nachdem der Kunde sie abgebrochen hatte. Die Zahlung wird nicht erfasst. Die Notiz erklärt dies, und der Paysera-Block fordert Sie auf, die Zahlung in Ihrem Paysera-Konto zu prüfen und die Bestellung dann auf Payment accepted zu setzen oder sie zu stornieren und die Zahlung in Paysera zu erstatten.

Cancelled: Eine später bestätigte Zahlung für eine stornierte Bestellung ändert deren Status nicht. Eine Notiz fordert Sie auf, die Bestellung wiederherzustellen (auf Payment accepted setzen) oder die Zahlung in Paysera zu erstatten. Eine spätere TEST-Zahlung oder eine Betragsabweichung bei einer stornierten Bestellung fügt ebenfalls nur eine Notiz hinzu.

Geht eine weitere erfolgreiche Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert, und eine Notiz fordert Sie auf, das Duplikat in Ihrem Paysera-Konto zu erstatten. Andere Paysera-Status (Zahlung nicht ausgeführt, zusätzliche Informationen) fügen nur eine Notiz hinzu.

Paysera-Zahlungsblock

Die Bestellseite zeigt einen Block Paysera payment mit der Paysera-Bestell-ID (Warenkorbnummer und Versuch), der Paysera-Anfrage-ID, der Umgebung und einer Kennzeichnung TEST payment, dem Zahlungsstatus, dem angeforderten und dem bezahlten Betrag, der Zahlungsmethode und den Notizen des Moduls.

Erstattungen

Erstattungen aus dem Back Office werden nicht unterstützt: Das Protokoll des Paysera-Zahlungsfensters hat keine Erstattungs-API. Nehmen Sie Erstattungen in Ihrem Paysera-Konto vor. Meldet Paysera eine Erstattung, wird der Bestellung eine Notiz mit dem erstatteten Betrag hinzugefügt, und der Bestellstatus bleibt unverändert. Erfassen Sie die Erstattung bei Bedarf manuell in PrestaShop.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Paysera Payment ist der erste Block auf Modules > Module Manager > VibeFox Paysera Payment > Configure, oberhalb der 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-paysera und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einer Multistore-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 einen aktiven Schlüssel wird Paysera Kunden auf der Bestellseite nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird die Zahlungsmethode auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch den Callback bestätigt.

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

Fehlerbehebung

Paysera erscheint nicht im Bestellvorgang: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und sowohl Project ID als auch Project password eingegeben sind. Die Einstellungsseite zeigt eine Warnung, solange eines davon fehlt. Prüfen Sie unter Payment > Preferences, ob das Modul für die Währung des Warenkorbs, das Land des Kunden und die Kundengruppe zugelassen ist.

Die Zahlung ist erfolgt, aber es wurde keine Bestellung angelegt: Die Bestellung wird durch den Paysera-Callback angelegt, nicht durch die Rückkehr des Kunden. Prüfen Sie, ob Ihr Shop unter der in den Einstellungen angezeigten Callback URL aus dem Internet erreichbar ist (nicht hinter einer Anmeldung, einer Basisauthentifizierung oder einer Firewall), und sehen Sie im Feld Log auf der Modulseite nach.

Der Callback antwortet Invalid signature: Das Project password stimmt nicht mit dem Projekt überein, oder der Callback stammt nicht von Paysera. Kopieren Sie das Projektpasswort erneut. Haben Sie das Projekt oder das Passwort geändert, können Zahlungen, die vor der Änderung gestartet wurden, nicht mehr überprüft werden.

Der Callback antwortet Project ID mismatch: Die Project ID in den Einstellungen unterscheidet sich von dem Projekt, das die Zahlung ausgelöst hat.

Der Callback antwortet Order not found: Der Warenkorb im Callback hat in diesem Shop keine Paysera-Zahlung, zum Beispiel weil die Zahlung in einem anderen Shop mit demselben Projekt gestartet wurde.

Der Callback antwortet Gateway not configured, Busy oder Temporary error: Projekt-ID oder Passwort sind leer, ein weiterer Callback für denselben Warenkorb läuft noch, oder die Bestellung konnte nicht angelegt werden (zum Beispiel weil das Modul deaktiviert ist). Paysera wiederholt den Callback. Aktivieren Sie Debug log, um den Grund zu sehen.

Paysera lehnt das Zahlungsfenster ab oder meldet, dass das Projekt nicht existiert: Prüfen Sie Environment. Ein normales Paysera-Projekt funktioniert nur mit Production; Sandbox benötigt ein Projekt, das in der Paysera-Sandbox-Umgebung angelegt wurde.

Die Testzahlung bezahlt die Bestellung nicht: Eine TEST-Zahlung bezahlt eine Bestellung nur, solange Test payments eingeschaltet ist. Andernfalls wird die Bestellung mit einer Notiz zurückgehalten, dass kein Geld abgebucht wurde. Aktivieren Sie außerdem Allow test payments im Paysera-Projekt.

Eine Bestellung ist Paysera payment on hold mit einer Notiz zu einer Abweichung von Betrag oder Währung: Paysera hat eine Zahlung bestätigt, deren Betrag oder Währung vom Warenkorbbetrag abweicht, zum Beispiel weil der Warenkorb in einem anderen Tab geändert wurde, nachdem der Kunde mit der Zahlung begonnen hatte. Vergleichen Sie die Zahlung in Ihrem Paysera-Konto und nehmen Sie die Bestellung an oder erstatten Sie die Zahlung manuell. Eine spätere korrekte Zahlung für dieselbe Bestellung markiert sie als bezahlt.

Der Kunde sieht Paysera payments are temporarily unavailable: Sehen Sie im Feld Log nach. Projekt-ID oder Passwort sind möglicherweise leer, oder eine der an Paysera übermittelten Shop-Adressen ist länger als 255 Zeichen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Paysera Payment und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data aktiviert, werden die Moduleinstellungen und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Paysera-Zahlungsdatensätze und die Bestellstatus Awaiting Paysera payment und Paysera payment on hold bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Paysera ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit Paysera verbunden und wird nicht von Paysera empfohlen.