VibeFox PayU for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren; wird WooCommerce später deaktiviert, führt das Plugin keine Aktionen aus und zeigt einen Hinweis im Administrationsbereich an.

PHP: 8.0 oder neuer.

Shop-Währung: eine der Währungen PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH. Die Währung muss zudem für Ihre Verkaufsstelle bei PayU freigeschaltet sein. Bei anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet.

Internetzugriff auf Ihre Website: PayU sendet Zahlungsbenachrichtigungen an Ihren Shop, daher muss die Website über das Internet erreichbar sein (nicht hinter einer HTTP-Authentifizierung oder einer Wartungsseite). Ohne Benachrichtigungen werden Bestellungen dennoch geprüft, sobald der Kunde von PayU zurückkehrt.

PayU-Konto: Sie benötigen vier Schlüssel Ihrer Verkaufsstelle (POS): POS ID, Second Key (MD5), OAuth client_id und OAuth client_secret. Diese finden Sie im PayU-Händlerbereich unter Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Sandbox-Schlüssel stammen aus einem separaten PayU-Sandbox-Konto.

VibeFox-Lizenzschlüssel: auf vibefox.net erworben. 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_payu_payment per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

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

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

5. Geben Sie die vier Sandbox-Schlüssel und die vier Live-Schlüssel ein (siehe Konfiguration). In PayU muss keine Benachrichtigungs-URL hinterlegt werden.

6. Aktivieren Sie Enable/Disable. Lassen Sie Test Mode aktiviert, bis Sie eine Testzahlung durchgeführt haben, und deaktivieren Sie ihn anschließend, um echte Zahlungen mit den Live-Schlüsseln anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > PayU. Oberhalb der Felder warnt die Seite, solange der Sandbox-Modus aktiv ist, wenn einer der vier Schlüssel des aktuellen Modus fehlt oder wenn PayU die Shop-Währung nicht unterstützt. In den beiden letztgenannten Fällen wird PayU an der Kasse nicht angezeigt.

Beim Speichern werden Leerzeichen und Zeilenumbrüche aus allen Schlüsseln entfernt, da diese beim Kopieren aus dem PayU-Panel häufig unbeabsichtigt mitkopiert werden.

Allgemein

Enable/Disable: Enable PayU payment gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der dem Kunden angezeigte Titel der Zahlungsmethode. Standard: PayU.

Description: die dem Kunden angezeigte Beschreibung der Zahlungsmethode. Standard: Pay securely via PayU.

API-Zugangsdaten

Die Schlüssel finden Sie im PayU-Händlerbereich: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Sandbox-Schlüssel stammen aus einem separaten PayU-Sandbox-Konto. Alle vier Schlüssel eines Modus müssen ausgefüllt sein.

Test Mode: Enable sandbox (test) mode. Verwendet die PayU-Sandbox und die untenstehenden Sandbox-Schlüssel. Es wird kein echtes Geld abgebucht. In der klassischen Kasse und im Kassen-Block sieht der Kunde Sandbox mode — no real money is charged. Deaktivieren Sie ihn, um echte Zahlungen mit den Live-Schlüsseln anzunehmen. Standard: an.

Live POS ID: die POS ID (merchantPosId) Ihrer produktiven Verkaufsstelle.

Live Second Key (MD5): wird zur Überprüfung der Signatur von PayU-Benachrichtigungen verwendet.

Live OAuth Client ID: die OAuth client_id der Verkaufsstelle.

Live OAuth Client Secret: das OAuth client_secret der Verkaufsstelle.

Sandbox POS ID: die POS ID Ihrer PayU-Sandbox-Verkaufsstelle.

Sandbox Second Key (MD5): wird zur Überprüfung der Signatur von PayU-Sandbox-Benachrichtigungen verwendet.

Sandbox OAuth Client ID: die OAuth client_id der Sandbox-Verkaufsstelle.

Sandbox OAuth Client Secret: das OAuth client_secret der Sandbox-Verkaufsstelle.

Jede Zahlung speichert ihre Umgebung. Benachrichtigungen, Statusprüfungen und Erstattungen einer Zahlung verwenden stets die Schlüssel dieser Umgebung, sodass ältere Zahlungen auch nach einem Wechsel weiter funktionieren. Eine mit dem Sandbox-Schlüssel signierte Benachrichtigung wird für eine Live-Zahlung niemals akzeptiert.

Zahlungsbenachrichtigungen

Dieser Abschnitt zeigt die Benachrichtigungs-URL, die wie folgt aussieht: https://your-site/wc-api/wc_pu_payment/. Das Plugin sendet sie bei jeder Zahlung an PayU, sodass im PayU-Panel nichts eingerichtet werden muss. Stellen Sie sicher, dass sie über das Internet erreichbar ist (nicht durch eine Firewall, den Wartungsmodus oder eine HTTP-Authentifizierung blockiert).

Erweitert

Receive payments automatically: Automatically receive payments waiting for confirmation. Dies ist nur von Bedeutung, wenn die automatische Annahme für Ihre POS im PayU-Panel deaktiviert ist: Zahlungen warten dann auf Bestätigung (WAITING_FOR_CONFIRMATION). Wenn diese Option aktiviert ist, nimmt das Plugin solche Zahlungen sofort an. Wenn sie deaktiviert ist, werden solche Bestellungen auf „In Wartestellung“ gesetzt, und Sie nehmen die Zahlung über die Bestellaktionen Receive PayU payment und Cancel PayU payment an oder stornieren sie. Standard: an.

Logging: Enable logging schreibt technische Ereignisse (Bestellnummern, PayU-Bestell-IDs, Statuswerte, Fehler; keine Schlüssel oder personenbezogenen Daten) nach WooCommerce > Status > Logs, Quelle wcp_payu_payment. Standard: aus.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Bestellungen und deren Zahlungsdaten werden niemals gelöscht. Beim Deaktivieren des Plugins bleibt alles erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig PayU) und gibt die Bestellung auf. Das Plugin erstellt eine PayU-Bestellung über den Gesamtbetrag in der Bestellwährung mit der Beschreibung Order #, der Bestellnummer und Ihrem Shop-Namen sowie mit den Bestellpositionen, Versandkosten und Gebühren zur Anzeige auf der PayU-Seite. Die Sprache der PayU-Seite richtet sich nach der Shopsprache, sofern PayU diese unterstützt, andernfalls Englisch. Der Kunde wird auf die PayU-Zahlungsseite geleitet, wählt dort eine Methode und zahlt.

Jeder Zahlungsversuch erhält eine eigene PayU-Bestellung. Zahlt der Kunde erneut (nach einer fehlgeschlagenen oder stornierten Zahlung oder über die Seite Pay for order), wird die vorherige unvollendete PayU-Zahlung der Bestellung bei PayU storniert, sodass ein alter Zahlungslink nicht zweimal bezahlt werden kann.

Die bloße Rückkehr zu Ihrem Shop bezahlt eine Bestellung niemals. Eine Bestellung wird erst als bezahlt markiert, wenn PayU dies bestätigt: über eine mit dem Second Key der Zahlungsumgebung signierte Benachrichtigung oder über eine serverseitige Statusprüfung der PayU-Bestellung bei der Rückkehr des Kunden (hilfreich bei verzögerten Benachrichtigungen). Die PayU-Bestellung muss für diese Bestellung erstellt worden sein, und Betrag sowie Währung müssen übereinstimmen. Das Plugin verarbeitet folgende PayU-Statuswerte:

COMPLETED: Die Zahlung wurde durchgeführt. Die Bestellung wird als bezahlt markiert, wenn Betrag und Währung übereinstimmen.

WAITING_FOR_CONFIRMATION: Die Zahlung ist autorisiert und wartet auf Annahme. Sie wird automatisch oder über die Bestellaktionen angenommen, siehe Receive payments automatically.

CANCELED: Die Zahlung wurde storniert oder abgelehnt. Eine unbezahlte Bestellung des letzten Versuchs wird als Fehlgeschlagen markiert. Frühere Versuche und bezahlte Bestellungen werden nicht geändert.

NEW, PENDING: Die Zahlung wird bei PayU verarbeitet. Die Bestellung ändert sich nicht.

Auf der Bestellbestätigungsseite sieht der Kunde, solange die Bestellung noch im Status Ausstehende Zahlung ist, den Hinweis We have not received the payment confirmation from PayU yet. If the payment was interrupted, you can try again: oder nach einer fehlgeschlagenen Zahlung The payment was not completed. You can try again:, jeweils mit einer Schaltfläche Pay again. Bei einer Bestellung in Wartestellung lautet die Meldung Your payment is being verified. We will send you an e-mail as soon as it is confirmed.

Kann PayU die Zahlung nicht starten, sieht der Kunde die Meldung Payment error. Please try again or choose another payment method. Die technische Ursache (HTTP-Code und PayU-Status) wird im Protokoll und in einer Bestellnotiz PayU payment could not be started: festgehalten. Fehlen die Schlüssel des aktuellen Modus, lautet die Meldung Payment gateway is not configured properly. Please contact the administrator.

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

Der Kunde wählt die Zahlungsmethode auf der PayU-Seite, nicht in Ihrer Kasse. Das Plugin bietet kein Kartenformular in Ihrem Shop, keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements und keine PayU-Raten- oder Kredit-Widgets. Es verwendet eine Verkaufsstelle pro Umgebung (keine Verkaufsstelle pro Währung).

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu PayU weitergeleitet und hat noch nicht bezahlt. Die Bestellnotiz zeigt die PayU-Bestell-ID und die Umgebung (Sandbox oder Live).

Processing: Die Zahlung wurde bestätigt. Die Bestellnotiz zeigt die PayU-Bestell-ID, den Betrag und die Umgebung. Die Transaktions-ID entspricht der PayU-Bestell-ID, die bezahlt wurde. Bestellungen, die ausschließlich virtuelle, herunterladbare Produkte enthalten, erhalten wie in WooCommerce standardmäßig üblich den Status Fertiggestellt.

On hold: Der bezahlte Betrag oder die Währung stimmte nicht mit der Bestellung überein, eine Zahlung wurde für eine bereits stornierte Bestellung abgeschlossen oder eine Zahlung wartet auf Ihre Bestätigung (automatische Annahme aus oder Annahme fehlgeschlagen). Die Bestellnotiz erläutert den Fall und die erforderlichen Schritte.

Failed: Die letzte PayU-Zahlung wurde storniert oder abgelehnt. Der Kunde kann die Zahlung erneut versuchen.

Jede Benachrichtigung wird genau einmal unter einer Sperre pro Bestellung verarbeitet: Wiederholte Benachrichtigungen fügen keine Notizen hinzu, reduzieren den Lagerbestand nicht doppelt und versenden keine E-Mails mehrfach. Wird eine weitere Zahlung für eine bereits bezahlte oder erstattete Bestellung abgeschlossen, fordert eine Notiz dazu auf, diese im PayU-Panel zu erstatten. Eine auf Bestätigung wartende Zahlung für eine bereits bezahlte oder geschlossene Bestellung wird automatisch storniert, sodass das Geld nicht doppelt eingezogen wird.

Auf Bestätigung wartende Zahlungen

Bei einer unbezahlten Bestellung mit einer auf Bestätigung wartenden Zahlung stehen auf der Bestellseite zwei Bestellaktionen zur Auswahl: Receive PayU payment (waiting for confirmation) und Cancel PayU payment (release the funds). Wählen Sie eine Aktion aus und klicken Sie auf die Aktualisieren-Schaltfläche. Die Aktion wird mit Ihrem Benutzernamen in den Bestellnotizen protokolliert und der neue PayU-Status sofort angewendet.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via PayU (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung wird für die tatsächlich bezahlte PayU-Bestellung mit den Schlüsseln der Zahlungsumgebung gesendet, daher müssen diese Schlüssel hinterlegt sein. Der Erstattungsgrund wird als Erstattungsbeschreibung übermittelt. Lehnt PayU die Erstattung ab, zeigt WooCommerce den Fehler von PayU an und es wird keine Erstattung erfasst.

Erstattungen erfolgen bei PayU asynchron. Das Plugin fügt sofort eine Notiz mit der PayU-Erstattungs-ID und dem Status hinzu; der endgültige Status trifft später als PayU-Benachrichtigung ein und wird als Notiz ergänzt. Storniert PayU eine Erstattung, weist die Notiz darauf hin, dass das Geld nicht an den Kunden zurückgezahlt wurde.

Bestellungen, die wegen abweichender Beträge oder Währungen in Wartestellung gesetzt wurden, behalten die PayU-Bestell-ID als Transaktions-ID, sodass die Zahlung sowohl über WooCommerce als auch im PayU-Panel erstattet werden kann.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Payments > PayU. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich zeigt den Status an, beispielsweise das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Verwenden Sie Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um ihn von dieser Website zu entfernen. 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 den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird PayU den Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin mit dem Vermerk (unlicensed — visible to admins only), sodass Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Eine Erinnerung erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt und Erstattungen funktionieren.

Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, Aktualisierungen und Support erfordern jedoch eine Verlängerung. Der Status wird im Hintergrund automatisch erneut überprüft.

Fehlerbehebung

PayU erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable aktiviert ist und alle vier Schlüssel des aktuellen Modus ausgefüllt sind: die Sandbox-Schlüssel im Sandbox-Modus, die Live-Schlüssel im Live-Modus. Prüfen Sie, ob die Shop-Währung (oder die Bestellwährung auf der Seite Pay for order) zu den unterstützten Währungen gehört. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung an.

Die Zahlung war erfolgreich, aber die Bestellung bleibt auf Ausstehende Zahlung: PayU hat die Benachrichtigung noch nicht zugestellt und die Statusprüfung auf der Rückkehrseite hat keine abgeschlossene Zahlung vorgefunden. Prüfen Sie, ob die in den Einstellungen angezeigte Benachrichtigungs-URL über das Internet erreichbar ist. Aktivieren Sie Logging, um eingehende Daten einzusehen.

Benachrichtigung antwortet Invalid signature: Die Benachrichtigung wurde nicht mit dem Second Key einer der beiden Umgebungen signiert. Überprüfen Sie Live Second Key (MD5) und Sandbox Second Key (MD5). Die Antwort Invalid signature for this payment bedeutet, dass die Benachrichtigung mit dem Schlüssel der jeweils anderen Umgebung signiert wurde.

Benachrichtigung antwortet Ignored: Die PayU-Bestellung gehört zu keiner mit PayU bezahlten Bestellung dieses Shops, beispielsweise zu einem anderen Shop an derselben POS. PayU stellt weitere Versuche ein.

Die Zahlung wird nicht erstellt: Aktivieren Sie Logging und sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_payu_payment. Das Protokoll zeigt den HTTP-Code und den PayU-Status. Could not authenticate with PayU (check the OAuth client ID / secret). weist auf fehlerhafte OAuth-Schlüssel des aktuellen Modus hin.

Die Bestellung ist In Wartestellung: Lesen Sie die Bestellnotiz. Die Ursache ist eine Abweichung von Betrag oder Währung, eine Zahlung nach einer Stornierung oder eine auf Bestätigung wartende Zahlung. Im letztgenannten Fall nutzen Sie die Bestellaktionen Receive PayU payment oder Cancel PayU payment.

Erstattung schlägt fehl: This order has no completed PayU payment. Cannot process refund. bedeutet, dass die Bestellung keine bezahlte PayU-Bestellung aufweist. Ein Hinweis auf fehlende Sandbox- oder Live-Schlüssel bedeutet, dass die Zahlung in dieser Umgebung erfolgte und deren Schlüssel nicht hinterlegt sind. Geben Sie diese ein und versuchen Sie es erneut.

Andere Währungen: Entwickler können die Währungsliste über den Filter wc_pu_supported_currencies und das Kassen-Icon über den Filter wc_pu_icon anpassen.

Der Lizenzbereich zeigt einen Fehler an: Folgen Sie der Meldung im Bereich. Wenn der Schlüssel beispielsweise bereits auf einer anderen Domain verwendet wird, geben Sie einen Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Hat sich die Website-Adresse geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Kann der Lizenzserver nicht erreicht werden, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Einstellungen erhalten; lediglich zwischengespeicherte PayU-Zugriffstoken werden verworfen. Um das Plugin zu entfernen, deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden zusammen mit den zwischengespeicherten Token stets entfernt. Die Gateway-Einstellungen und das Protokoll dieses Plugins 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, PayU-Bestell-IDs und Transaktions-IDs.

PayU ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit PayU verbunden noch von PayU empfohlen.