VibeFox Paysera for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

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

PHP: 8.0 oder neuer.

Paysera-Projekt: Sie benötigen die Projekt-ID und das Projektpasswort (Signaturschlüssel) 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.

Erreichbare Website: Bestellungen werden durch den Paysera-Callback bezahlt. Ihre Website muss daher aus dem Internet erreichbar sein, also nicht hinter einem Login, dem Wartungsmodus oder einer Firewall liegen.

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net erworben. Ein Schlüssel gilt für eine Domain.

Installation

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Paysera > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Tragen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Tragen Sie die Project ID und das Project password aus Ihrem Paysera-Konto ein (siehe Konfiguration).

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

7. Aktivieren Sie Enable/Disable und speichern Sie.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Paysera. Oberhalb der Felder zeigt die Seite Paysera wird auf der Kasse ausgeblendet, bis Projekt-ID und Projektpasswort eingegeben sind., solange eines davon fehlt. Außerdem erscheint ein Hinweis, dass Kunden nicht belastet werden, solange Testzahlungen oder die Sandbox aktiv sind. In der Liste der Zahlungsmethoden ist Paysera als einrichtungsbedürftig markiert, bis das Projekt konfiguriert ist, und bei aktiven Testzahlungen oder aktiver Sandbox wird ein Testmodus-Hinweis angezeigt.

Allgemein

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

Title: der Name der Zahlungsmethode, der auf der Kasse angezeigt wird. Standard: Paysera.

Description: der Text, der auf der Kasse 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, Ihr Projekt, General project settings. Der Bereich zeigt die Callback-URL, die etwa so aussieht: https://your-site/wc-api/wc_psr_payment/. Sie wird automatisch mit jeder Zahlung übermittelt; in Paysera muss nichts eingerichtet werden.

Project ID: die numerische ID Ihres Paysera-Projekts.

Project password: das Projektpasswort (Signaturschlüssel). Es signiert Zahlungsanfragen und prüft Paysera-Callbacks.

Testen

Test payments: Send payments in test mode (no money is charged). Paysera bestätigt eine Testzahlung als erfolgreich, 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 aus, bezahlt eine Testzahlung nie eine Bestellung. Standard: aus.

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

Erweitert

Debug log: Log payment events. Fehler werden immer protokolliert. Die Protokolle finden Sie unter WooCommerce > Status > Logs, Quelle wcp_paysera_payment. Passwörter und Kundendaten werden nie geschrieben. Standard: aus.

Delete data: Delete the plugin settings and logs when the plugin is deleted. Das Deaktivieren des Plugins löscht nichts. Bestelldaten bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Paysera) und gibt die Bestellung auf. Bei aktivierten Testzahlungen zeigt die Kasse TESTMODUS — Es wird kein Geld abgebucht. an. Das Plugin erstellt eine signierte Zahlungsanfrage mit der Bestellsumme in der kleinsten Einheit der Bestellwährung, dem Namen, der E-Mail-Adresse und der Rechnungsadresse des Kunden sowie einer Sprache, die aus der Sprache Ihrer Website abgeleitet wird (Litauisch, Lettisch, Estnisch, Russisch, Deutsch, Polnisch, andernfalls Englisch). Der Kunde wird zum Zahlungsfenster von Paysera geleitet und wählt dort Bank, Karte oder eine andere Methode.

Nach der Zahlung kehrt der Kunde zur Seite „Bestellung eingegangen“ zurück. Die Bestellung wird erst als bezahlt markiert, wenn der signierte Paysera-Callback eintrifft; die Rückkehr selbst bezahlt nie eine Bestellung.

Bricht der Kunde im Zahlungsfenster von Paysera ab, wird die Bestellung auf die übliche WooCommerce-Weise storniert, und der Kunde kann erneut bestellen. Kann die Zahlung nicht gestartet werden, sieht der Kunde Paysera-Zahlungen sind vorübergehend nicht verfügbar. Bitte wählen Sie eine andere Zahlungsmethode. Der Grund wird im Protokoll festgehalten.

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

Das Plugin bietet keine Erstattungen aus WooCommerce, keine Auswahl von Bank oder Zahlungsmethode auf der Kasse, keine Abonnements, keine gespeicherten Karten und keine Liefer- oder Kurierdienste von Paysera.

Bestellungen

Bestellstatus

Pending payment: Der Kunde wurde zu Paysera weitergeleitet, und der Callback ist noch nicht eingetroffen.

Processing: Paysera hat die Zahlung bestätigt (Status 1). Bestellungen mit ausschließlich virtuellen, herunterladbaren Produkten werden auf Abgeschlossen gesetzt, dem WooCommerce-Standard. Die Bestellnotiz zeigt die Paysera-Anfrage und die Zahlungsmethode. Die Transaktions-ID ist die Paysera-Anfrage-ID.

On hold: Paysera hat den Zahlungsauftrag angenommen, aber noch nicht ausgeführt (Status 2); die Bestellung wird abgeschlossen, sobald Paysera die Zahlung bestätigt. Oder der bezahlte Betrag bzw. die Währung weicht von der Bestellung ab (Notiz amount/currency mismatch). Oder es ist eine TESTZAHLUNG eingegangen, während Testzahlungen ausgeschaltet waren, sodass kein Geld abgebucht wurde. Die Bestellnotiz erklärt dies.

Cancelled: Der Kunde hat im Zahlungsfenster von Paysera abgebrochen, oder die Bestellung wurde von Ihnen bzw. durch das Zeitlimit der Lagerreservierung storniert. Eine später bestätigte Zahlung für eine stornierte Bestellung ändert deren Status nicht: Eine Notiz fordert Sie auf, die Bestellung wiederherzustellen (auf Processing setzen) oder die Zahlung in Paysera zu erstatten.

Andere Paysera-Status (Zahlung nicht ausgeführt, zusätzliche Informationen) fügen nur eine Notiz hinzu. Trifft 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.

Erstattungen

Erstattungen aus WooCommerce 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, der Bestellstatus bleibt unverändert. Erfassen Sie die Erstattung bei Bedarf manuell in WooCommerce.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Paysera. 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 gültig 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 gilt für eine 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 Paysera Kunden auf der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsmethode ist nicht verfügbar. Bitte wählen Sie eine andere. Angemeldete Shopbetreiber sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf den WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt.

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

Fehlerbehebung

Paysera erscheint nicht auf der Kasse: 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.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Pending payment: Die Bestellung wird durch den Paysera-Callback bezahlt, nicht durch die Rückkehr des Kunden. Prüfen Sie, ob Ihre Website unter der in den Einstellungen angezeigten Callback-URL aus dem Internet erreichbar ist (nicht hinter einem Login, Wartungsmodus oder einer Firewall), und sehen Sie unter WooCommerce > Status > Logs, Quelle wcp_paysera_payment, nach.

Der Callback antwortet mit „Invalid signature“: Das Project password passt nicht zum Projekt, oder der Callback stammt nicht von Paysera. Kopieren Sie das Projektpasswort erneut.

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

Der Callback antwortet mit „Gateway not configured“ oder „Busy“: Projekt-ID oder Passwort sind leer, oder ein anderer Callback für dieselbe Bestellung läuft noch. Paysera wiederholt den Callback.

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 TESTZAHLUNG bezahlt eine Bestellung nur, solange Test payments aktiv ist. Andernfalls wird die Bestellung mit einem Hinweis auf „wartend“ gesetzt, dass kein Geld abgebucht wurde. Aktivieren Sie außerdem Allow test payments im Paysera-Projekt.

Kein Symbol auf der Kasse: Das Plugin zeigt standardmäßig kein Symbol an. Entwickler können eines mit dem Filter wc_psr_gateway_icon festlegen.

Eine Bestellung ist On hold mit einem Hinweis auf eine Abweichung bei Betrag oder Währung: Paysera hat eine Zahlung bestätigt, deren Betrag oder Währung nicht zur Bestellsumme passt, zum Beispiel weil die Bestellung bearbeitet wurde, nachdem der Kunde mit der Zahlung begonnen hatte. Vergleichen Sie die Zahlung in Ihrem Paysera-Konto und schließen Sie die Bestellung manuell ab oder erstatten Sie die Zahlung.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel etwa 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 Einstellungen des Zahlungsgateways und die Protokolle werden nur entfernt, wenn Delete data aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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