VibeFox PayU for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer, mit der cURL-Erweiterung.

Währung: Die Checkout-Währung des Kunden muss eine der Währungen PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH sein. Die Währung muss außerdem für Ihren PayU-Verkaufsstandort aktiviert sein. Bei anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet.

Internetzugang für Ihren Shop: PayU sendet Zahlungsbenachrichtigungen an Ihren Shop, daher muss er aus dem Internet erreichbar sein (nicht hinter einer HTTP-Authentifizierung oder einer Firewall). Ohne Benachrichtigungen werden Zahlungen trotzdem geprüft, wenn der Kunde von PayU zurückkehrt.

PayU-Konto: Sie benötigen vier Schlüssel Ihres Verkaufsstandorts (POS): POS ID, Second key (MD5), OAuth client_id und OAuth client_secret. Sie finden sie im PayU-Händlerpanel 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: Erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_payu_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_payu_payment.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_payu_payment-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie den Inhalt des Ordners upload dieses Pakets auch in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox PayU Payment und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Administrationsbenutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (die Schaltfläche mit dem Stift), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in das Feld License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

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

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Lassen Sie Test Mode aktiviert, bis Sie eine Testzahlung durchgeführt haben, und schalten Sie es dann aus, um echte Zahlungen mit den Live-Schlüsseln anzunehmen.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_payu_payment.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox PayU Payment, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die PayU-Schlüssel wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist unterschiedlich (siehe Zahlungsbenachrichtigungen).

Eine neue Installation startet mit deaktivierter Zahlungsmethode und aktiviertem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox PayU Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, solange der Sandbox-Modus aktiv ist (Der Sandbox-Modus (Test) ist aktiv: Zahlungen gehen an die PayU-Sandbox, und es wird kein echtes Geld belastet. Versenden Sie keine im Testmodus bezahlten Bestellungen.), wenn einer der vier Schlüssel des aktuellen Modus fehlt (PayU wird dann nicht an der Kasse angezeigt) und wenn PayU die Standardwährung des Shops nicht akzeptiert (PayU wird dann für Bestellungen in dieser Währung ausgeblendet). Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern werden Leerzeichen und Zeilenumbrüche aus allen Schlüsseln entfernt, weil beim Kopieren aus dem PayU-Panel oft welche mitkopiert werden. Title darf nicht leer sein und nicht länger als 128 Zeichen sein (die Seite zeigt Geben Sie einen Titel für die Zahlungsmethode ein (maximal 128 Zeichen).), Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl sein, 0 oder größer, und die Geozone und Bestellstatus müssen vorhanden sein. Andernfalls wird nichts gespeichert. Beim Speichern der Einstellungen werden außerdem die zwischengespeicherten PayU-Zugriffstoken gelöscht.

PayU

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: PayU. Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, der Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely via PayU.

Sort Order: die Position von PayU unter den Zahlungsmethoden an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: PayU nur für Zahlungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Kassenbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor PayU angeboten wird. Lassen Sie das Feld leer, um PayU bei jedem Betrag anzubieten.

API-Zugangsdaten

Die Schlüssel finden Sie im PayU-Händlerpanel: 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. Der Abschnitt enthält Links zur PayU-Entwicklerdokumentation.

Test Mode: verwendet die PayU-Sandbox und die unten stehenden Sandbox-Schlüssel. Es wird kein echtes Geld belastet. Solange dies aktiv ist, sehen Kunden im Schritt Confirm Order den Hinweis Sandbox-Modus: Es wird keine echte Zahlung eingezogen. Schalten Sie es aus, um echte Zahlungen mit den Live-Schlüsseln anzunehmen. Standard: aktiviert.

Live POS ID: die POS ID (merchantPosId) Ihres Produktiv-Verkaufsstandorts.

Live Second Key (MD5): wird verwendet, um die Signatur von PayU-Benachrichtigungen zu prüfen.

Live OAuth Client ID: die OAuth-client_id des Verkaufsstandorts.

Live OAuth Client Secret: das OAuth-client_secret des Verkaufsstandorts.

Sandbox POS ID: die POS ID Ihres PayU-Sandbox-Verkaufsstandorts.

Sandbox Second Key (MD5): wird verwendet, um die Signatur von PayU-Sandbox-Benachrichtigungen zu prüfen.

Sandbox OAuth Client ID: die OAuth-client_id des Sandbox-Verkaufsstandorts.

Sandbox OAuth Client Secret: das OAuth-client_secret des Sandbox-Verkaufsstandorts.

Gespeicherte Second Keys und Client Secrets werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — leer lassen, um ihn zu behalten. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. POS IDs und Client IDs werden so angezeigt, wie sie gespeichert wurden.

Clear saved secrets: Markieren Sie ein Geheimnis und klicken Sie auf Save, um es zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Jede Zahlung merkt sich ihre Umgebung. Benachrichtigungen, Statusprüfungen, das Empfangen oder Stornieren einer Zahlung sowie Erstattungen verwenden immer die Schlüssel dieser Umgebung, sodass ältere Zahlungen auch nach einem Moduswechsel weiter funktionieren. Eine mit dem Sandbox-Schlüssel signierte Benachrichtigung wird nie für eine Live-Zahlung akzeptiert, und umgekehrt.

Bestellstatus

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn PayU die Zahlung bestätigt hat, entweder durch eine signierte Benachrichtigung oder durch die Statusprüfung, wenn der Kunde zurückkehrt. OpenCart hat keinen Status „On hold“: Wartestatus stehen standardmäßig auf Pending, und der Reiter PayU der Bestellung sowie deren Notizen erklären den Grund. Jedes der folgenden Felder listet Ihre Bestellstatus in OpenCart auf; eigene Status können Sie unter System > Localisation > Order Statuses anlegen.

Order Status After Payment: wird gesetzt, wenn PayU die Zahlung bestätigt (COMPLETED) und Betrag und Währung übereinstimmen. Standard: Processing.

Awaiting PayU Payment Confirmation: die Zahlung ist autorisiert und wartet darauf, empfangen zu werden (automatisches Empfangen aus oder fehlgeschlagen). Verwenden Sie Receive PayU payment oder Cancel PayU payment im Reiter PayU der Bestellung. Standard: Pending.

PayU Payment On Hold: der gezahlte Betrag oder die Währung passt nicht zur Bestellung, oder eine Zahlung wurde für eine stornierte Bestellung abgeschlossen. Die Bestellung wird nicht als bezahlt markiert; die Notiz nennt den Grund. Standard: Pending.

Payment Error Status: die Zahlung einer Bestellung, die auf Bestätigung wartete, wurde storniert oder abgelehnt. Standard: Failed.

Cancelled Order Status: eine von PayU abgeschlossene Zahlung für eine Bestellung in diesem Status setzt die Bestellung auf Halten, statt sie stillschweigend wieder zu öffnen. Die Erweiterung setzt diesen Status nie. Standard: Canceled.

Refunded Status: wird gesetzt, nachdem die Zahlung im Reiter PayU der Bestellung vollständig erstattet wurde. Standard: Refunded.

Zahlungsbenachrichtigungen

Notification URL: zeigt die Adresse, an die PayU Benachrichtigungen sendet. Auf OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_payu_payment/notify, auf OpenCart 4 https://your-store/index.php?route=extension/wcp_payu_payment/payment/wcp_payu_payment.notify. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation erzeugt. Die Erweiterung übermittelt sie bei jeder Zahlung an PayU, daher muss im PayU-Panel nichts eingerichtet werden. Stellen Sie sicher, dass sie aus dem Internet erreichbar ist (nicht durch eine Firewall oder HTTP-Authentifizierung blockiert). Benachrichtigungen funktionieren auch, wenn der Shop im Wartungsmodus ist (auf OpenCart 4 über die Startaktion der Erweiterung, die außerdem die Rückkehr des Kunden von PayU zulässt). Benachrichtigungen ohne gültige Signatur werden abgelehnt.

Erweitert

Receive payments automatically: nimmt Zahlungen, die auf Bestätigung warten, automatisch entgegen. Das ist nur relevant, wenn das automatische Empfangen für Ihren Verkaufsstandort im PayU-Panel ausgeschaltet ist: Zahlungen warten dann auf Bestätigung (WAITING_FOR_CONFIRMATION). Ist diese Option aktiviert, nimmt die Erweiterung solche Zahlungen sofort entgegen, und die Bestellung erhält ihren Bezahlt-Status, sobald PayU die Zahlung als abgeschlossen meldet. Ist sie ausgeschaltet oder schlägt das Empfangen fehl, erhält die Bestellung Awaiting PayU Payment Confirmation, und Sie empfangen oder stornieren die Zahlung mit den Schaltflächen im Reiter PayU der Bestellung. Standard: aktiviert.

Logging: schreibt technische Ereignisse (Bestellnummern, PayU-Bestell-IDs, Status, Fehler, keine Schlüssel oder personenbezogenen Daten) in die Datei wc_pu_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert; die anderen Ereignisse nur, solange diese Option aktiv ist. Standard: aus.

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: ist die Option aktiv, entfernt das Deinstallieren der Erweiterung die Einstellungen des Gateways und das Protokoll. Bestellungen und ihre Zahlungsdaten (PayU-Transaktionen, Erstattungen) werden nie gelöscht. Zwischengespeicherte PayU-Zugriffstoken werden immer entfernt. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die Geheimnisse werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten Geheimnisse bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig PayU). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis Sie werden zu PayU weitergeleitet, um die Zahlung abzuschließen (BLIK, Banküberweisung, Karte und andere Methoden). OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Auf OpenCart 4 wählt der Kunde die Zahlungsmethode mit der Schaltfläche Choose im Block der Zahlungsmethode im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine PayU-Bestellung für den Bestellbetrag in der Bestellwährung, mit der Beschreibung Order #, der Bestellnummer und dem Namen Ihres Shops, sowie mit den Produkten, der Versandart und den übrigen Summenzeilen der Bestellung zur Anzeige auf der PayU-Seite. Die E-Mail-Adresse, der Name und die Telefonnummer des Kunden werden an PayU übergeben, und die Sprache der PayU-Seite richtet sich nach der Shop-Sprache. Der Kunde wird zur PayU-Seite weitergeleitet, wählt dort eine Methode und bezahlt.

Jeder Versuch erhält eine eigene PayU-Bestellung. Wenn der Kunde es erneut versucht (OpenCart 3 erstellt bei jeder Anzeige des Schritts Confirm Order eine neue Bestellung, OpenCart 4 aktualisiert die Bestellung der Kasse), werden die offenen PayU-Zahlungen früherer Versuche derselben Bestellung und desselben Warenkorbs bei PayU storniert, damit ein alter Zahlungslink nicht zweimal bezahlt werden kann. Stellt sich heraus, dass eine frühere Zahlung bereits bezahlt wurde, wird diese stattdessen übernommen, und eine Bestellung oder ein Warenkorb, die bereits bezahlt sind, auf Halten stehen oder auf Bestätigung warten, führt direkt zur Erfolgsseite, ohne eine zweite Zahlung. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

Die Rückkehr des Kunden in Ihren Shop allein bezahlt nie eine Bestellung. Die Bestellung wird erst als bezahlt markiert, nachdem PayU sie bestätigt hat: durch eine mit dem Second Key der Umgebung der Zahlung signierte Benachrichtigung oder durch eine serverseitige Statusprüfung der PayU-Bestellung, wenn der Kunde zurückkehrt (höchstens einmal alle 10 Sekunden pro Zahlung). Betrag und Währung müssen übereinstimmen. Die Bestellung erhält dann ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Die Erweiterung verarbeitet diese PayU-Status:

Nach einer bestätigten Zahlung sieht der Kunde die Erfolgsseite der OpenCart-Bestellung. Bei einer Bestellung, die auf Bestätigung wartet oder auf Halten steht, ergänzt die Seite Ihre Zahlung wird geprüft. Wir senden Ihnen eine E-Mail, sobald sie bestätigt ist. Wird eine solche Bestellung später bezahlt oder schlägt ihre Zahlung fehl, benachrichtigt OpenCart den Kunden über den neuen Status. Ist die Zahlung der Bestellung fehlgeschlagen, zeigt die Seite Ihre PayU-Zahlung wurde nicht abgeschlossen. Bitte kontaktieren Sie uns zu dieser Bestellung.

Hat PayU die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt, zeigt eine Seite Payment confirmation den Hinweis Wir haben die Zahlungsbestätigung von PayU noch nicht erhalten. Falls die Zahlung unterbrochen wurde, können Sie es erneut versuchen: (oder, wenn PayU einen Fehler gemeldet hat, Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen:) mit den Schaltflächen Pay again (zurück zur Kasse) und Check again. Die Benachrichtigung setzt den Bestellstatus, sobald sie eintrifft. Wurde die Zahlung storniert, kehrt der Kunde mit Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen. zur Kasse zurück. Der Warenkorb bleibt erhalten. Auf OpenCart 4 wird diese Meldung oberhalb der Kassenseite angezeigt.

Auf OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil ihre auf Bestätigung wartende Zahlung storniert wurde oder weil Sie sie storniert oder erstattet haben), wird der Kunde mit der Meldung Ihre vorherige Bestellung wurde geschlossen (nicht bezahlt, storniert oder erstattet). Bitte bestätigen Sie die Bestellung erneut, um mit einer neuen Bestellung zu bezahlen. zur Kasse zurückgeschickt. Kehrt der Kunde von PayU zu einer ohne Zahlung geschlossenen Bestellung zurück, lautet die Meldung Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen. War diese Bestellung bereits für einen früheren Warenkorb bezahlt und hat sich der Warenkorb seitdem geändert, wird der Kunde zur Kasse zurückgeführt. In jedem Fall bezahlt das nächste Confirm Order eine neue Bestellung des aktuellen Warenkorbs. Eine geschlossene Bestellung wird nie als bezahlt angezeigt.

Kann PayU die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit Zahlungsfehler. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsmethode. Der technische Grund wird ins Protokoll geschrieben. Fehlen die Schlüssel des aktuellen Modus, lautet die Meldung Das Zahlungsgateway ist nicht ordnungsgemäß konfiguriert. Bitte wenden Sie sich an den Administrator.

Der Kunde wählt die Zahlungsmethode auf der PayU-Seite, nicht in Ihrer Kasse. Die Erweiterung hat auf Ihrer Website kein Kartenformular, keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements und keine Ratenzahlungs- oder Kreditangebote von PayU. Sie verwendet pro Umgebung einen Verkaufsstandort.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): der Kunde wurde zu PayU weitergeleitet und hat nicht bezahlt, die Zahlung wurde storniert, oder PayU hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur angezeigt, wenn der Filter Order Status auf Missing Orders gesetzt ist.

Order Status After Payment (Standard Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt die PayU-Bestell-ID, den Betrag und die Umgebung (Sandbox oder Live).

Awaiting PayU Payment Confirmation (Standard Pending): die Zahlung ist autorisiert und wartet auf Sie (automatisches Empfangen aus oder Empfang fehlgeschlagen).

PayU Payment On Hold (Standard Pending): der gezahlte Betrag oder die Währung passte nicht zur Bestellung, eine auf Bestätigung wartende Zahlung hatte einen anderen Betrag, oder eine Zahlung wurde für eine stornierte Bestellung abgeschlossen. Die Notiz nennt den Fall. Prüfen Sie die Bestellung und führen Sie sie aus oder erstatten Sie die Zahlung.

Payment Error Status (Standard Failed): die Zahlung einer Bestellung, die auf Bestätigung wartete, wurde storniert oder abgelehnt.

Refunded Status (Standard Refunded): die Zahlung wurde über die Erweiterung vollständig erstattet.

Jede Benachrichtigung wird genau einmal verarbeitet: wiederholte Benachrichtigungen fügen keine Notizen hinzu und ändern die Bestellung nicht erneut. Wird für eine bereits bezahlte oder erstattete Bestellung oder für eine andere Bestellung eines bereits bezahlten Warenkorbs eine weitere Zahlung abgeschlossen, bittet Sie eine Notiz an der bezahlten Bestellung, sie im PayU-Panel zu erstatten. Eine auf Bestätigung wartende Zahlung für eine bereits bezahlte oder abgeschlossene Bestellung wird automatisch storniert, damit das Geld nicht doppelt eingezogen wird.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Reiter VibeFox PayU Payment

Öffnen Sie unter Sales > Orders eine mit PayU bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox PayU Payment die PayU order ID mit einem Hinweis Sandbox bei Sandbox-Zahlungen, die extOrderId, den PayU status, den Payment amount, die Beträge Paid / refunded, das Erstattungsformular, den Verlauf der Refunds, die PayU payment attempts der Bestellung und die PayU notes. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben; seine Aktionen erfordern das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups).

Zahlungen, die auf Bestätigung warten

Bei einer Bestellung mit einer auf Bestätigung wartenden Zahlung zeigt der Reiter Receive PayU payment und Cancel PayU payment. Nachdem Sie die Rückfrage bestätigt haben, wird die Aktion mit den Schlüsseln der Umgebung der Zahlung an PayU gesendet, mit Ihrem Benutzernamen zu den Notizen hinzugefügt, und der neue PayU-Status wird sofort angewendet: Eine empfangene Zahlung setzt Order Status After Payment, eine stornierte Payment Error Status.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via PayU. Bestätigen Sie die Rückfrage Refund this amount through PayU? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Erstattungen sind verfügbar, sobald PayU die Zahlung abgeschlossen hat. Die Erstattung wird für die tatsächlich bezahlte PayU-Bestellung mit den Schlüsseln der Umgebung der Zahlung gesendet; diese Schlüssel müssen daher eingerichtet sein. Erstattungen erfolgen in dem Betrag und der Währung, die PayU belastet hat. Nach einer Abweichung von Betrag oder Währung können Sie deshalb bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Der Grund wird als Erstattungsbeschreibung übermittelt. Lehnt PayU die Erstattung ab, zeigt der Reiter den Fehler von PayU, und es wird keine Erstattung erfasst. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Lagerbestand zurückzubuchen. Eine teilweise Erstattung ändert den Status nicht.

Erstattungen laufen bei PayU asynchron ab. Die Erweiterung fügt sofort eine Notiz mit der PayU-Erstattungs-ID und dem Status hinzu; der endgültige Status kommt später als PayU-Benachrichtigung und wird den Notizen und dem Erstattungsverlauf hinzugefügt. Storniert PayU eine Erstattung, weist die Notiz darauf hin, dass das Geld nicht an den Kunden zurückgegeben wurde, und der Betrag kann erneut erstattet werden.

Produktrücksendungen unter Sales > Returns zahlen kein Geld über PayU zurück.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayU Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox PayU Payment > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Prüfung des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-payu und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Administratoren mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Administrationssprache (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. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-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 aktiven Schlüssel wird PayU Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Administrator, der im selben Browser im Administrationsbereich angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Die Shop-Seite sieht die Admin-Anmeldung nicht, daher wird die Zahlungsmethode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Administrations-Dashboard eine Erinnerung. Schließen Sie sie mit ×, um sie für 7 Tage auszublenden. Bestehende Bestellungen sind nicht betroffen: bereits begonnene Zahlungen werden weiterhin durch Benachrichtigungen bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Administrations-Dashboard oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

PayU wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet 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 Währung des Kunden zu den unterstützten Währungen gehört, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Betrag erreicht. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel fehlen oder die Shop-Währung nicht unterstützt wird.

Die Zahlung war erfolgreich, aber die Bestellung bleibt ohne Status: PayU hat die Benachrichtigung noch nicht zugestellt, und die Statusprüfung auf der Rückkehrseite hat keine abgeschlossene Zahlung erkannt. Prüfen Sie, ob die auf der Einstellungsseite angezeigte Benachrichtigungs-URL aus dem Internet erreichbar ist. Aktivieren Sie Logging, um zu sehen, was eingeht. Der Kunde kann auch auf der Seite Payment confirmation auf Check again klicken.

Benachrichtigung antwortet Invalid signature: die Benachrichtigung wurde weder mit dem Second Key der einen noch der anderen Umgebung signiert. Prü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 anderen Umgebung signiert wurde als der Zahlung.

Benachrichtigung antwortet Ignored: unknown PayU order: die PayU-Bestellung wurde nicht von diesem Shop erstellt, etwa von einem anderen Shop am selben Verkaufsstandort. PayU versucht es nicht erneut.

Benachrichtigung antwortet Busy, retry later: der Warenkorb wurde im selben Moment von einer anderen Anfrage bestätigt. PayU wiederholt die Benachrichtigung. Aktivieren Sie Logging, um den Grund zu sehen.

Die Benachrichtigungs-URL zeigt im Browser POST expected: das ist normal. Die URL akzeptiert nur Benachrichtigungen von PayU.

Der Kunde sieht Payment error nach Confirm Order: Aktivieren Sie Logging und sehen Sie im Feld Log auf der Seite der Erweiterung nach. Das Protokoll zeigt den HTTP-Code und den PayU-Status. Could not authenticate with PayU (check the OAuth client ID / secret). bedeutet falsche OAuth-Schlüssel des aktuellen Modus. This payment method is not available. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsmethode inzwischen ausgeschaltet wurde: Der Kunde lädt die Kasse neu.

Die Bestellung steht auf PayU Payment On Hold: Lesen Sie die Notizen im Reiter VibeFox PayU Payment (siehe Bestellstatus) und führen Sie danach die Bestellung aus oder erstatten Sie die Zahlung.

Die Bestellung steht auf Awaiting PayU Payment Confirmation: das automatische Empfangen ist für Ihren Verkaufsstandort ausgeschaltet, und die Zahlung wartet auf Sie. Verwenden Sie Receive PayU payment oder Cancel PayU payment im Reiter.

Erstattung schlägt fehl oder es gibt kein Erstattungsformular: Der Reiter nennt den Grund. Refunds are available once PayU has completed the payment. bedeutet, dass PayU für die Bestellung noch keine Zahlung abgeschlossen hat. Eine Meldung, dass die Sandbox- oder Live-Schlüssel fehlen, bedeutet, dass die Zahlung in dieser Umgebung erfolgte und deren Schlüssel nicht gesetzt sind. Tragen Sie sie ein und versuchen Sie es erneut. Ohne das Recht, die Erweiterung zu ändern, zeigt der Reiter You do not have permission to refund (modify this extension).

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox PayU Payment auf Uninstall (die rote −-Schaltfläche). Lizenzschlüssel und Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus im Abschnitt Order statuses, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Außerdem werden das OpenCart-Ereignis der Erweiterung und die zwischengespeicherten PayU-Zugriffstoken entfernt (auf OpenCart 4 außerdem seine Ereignisse und seine Startaktion, die Benachrichtigungen und die Rückkehr des Kunden im Wartungsmodus durchlassen). Ist Delete data on uninstall aktiv, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, automatisches Empfangen, Protokollierung) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die PayU-Transaktionen und Erstattungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auch die Dateien der Erweiterung zu entfernen, gehen Sie auf OpenCart 4 nach der Deinstallation zu Extensions > Installer und klicken neben VibeFox PayU Payment in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

PayU ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit PayU verbunden und wird nicht von PayU unterstützt.