VibeFox PayU India 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.

Währung: Indische Rupie (INR). PayU India rechnet ausschließlich in Rupien ab. Ihr Shop benötigt die Währung INR (System > Localisation > Currencies). Für Bestellungen in anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet.

Telefonnummer: PayU verlangt für jede Zahlung eine Telefonnummer. Lassen Sie das Feld Telephone in Ihrer Kasse eingeblendet, damit die Bestellung eine Telefonnummer hat. Auf OpenCart 4 fragt die Kasse standardmäßig nicht nach einer Telefonnummer: Hat die Bestellung keine Telefonnummer, zeigt die Erweiterung im Bestätigungsschritt ihr eigenes Feld Phone (siehe Kasse).

PayU-India-Konto: Sie benötigen den Merchant Key und den Merchant Salt (v1) aus PayU Dashboard > Payment Gateway > Key Salt Details. Schalten Sie das Dashboard in den Test Mode, um das Testpaar zu sehen. Verwenden Sie Salt v1, nicht Salt v2.

Internetzugang für Ihren Shop: wird für den optionalen Webhook benötigt. Ohne ihn werden Bestellungen bestätigt, wenn der Kunde von PayU zurückkehrt.

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_india_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_payu_india_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_india_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 India Payment Gateway 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 den Test-Merchant-Key und Salt sowie den Live-Merchant-Key und Salt ein (siehe Konfiguration).

5. Empfohlen: Fügen Sie im PayU Dashboard > Webhooks die auf der Einstellungsseite angezeigte Webhook-URL für erfolgreiche und fehlgeschlagene Zahlungen hinzu.

6. Wählen Sie den Mode, aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung im Testmodus und wechseln Sie dann auf Live.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_payu_india_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 India Payment Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die PayU-Zugangsdaten und den Webhook wie in den Schritten 3 bis 6 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Rücksprung- und Webhook-URLs sind unterschiedlich (siehe Rücksprung- und Webhook-URLs).

Eine neue Installation startet mit deaktivierter Zahlungsmethode und ausgewähltem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, wenn der Schlüssel oder der Salt des aktuellen Modus fehlt, zeigt im Testmodus Der Testmodus ist aktiv: Zahlungen gehen an test.payu.in, und es wird kein echtes Geld belastet. an und zeigt einen Fehler, wenn die Standardwährung Ihres Shops nicht INR ist: Das Gateway wird dann an der Kasse nur angezeigt, wenn der Kunde in INR bezahlt. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title ausgefüllt und darf höchstens 128 Zeichen lang sein, 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. Leerzeichen und Zeilenumbrüche werden aus Schlüsseln und Salts entfernt, denn ein eingefügtes Leerzeichen im Salt würde jede Antwort von PayU bei der Prüfung scheitern lassen. Ist die Zahlungsmethode ohne Schlüssel und Salt des aktuellen Modus aktiviert, warnt Sie die Seite nach dem Speichern.

PayU India

Der Abschnitt beginnt mit einem kurzen Hinweis: Karten, NetBanking, UPI und Wallets auf der gehosteten Zahlungsseite von PayU; Ergebnisse werden nur mit einer gültigen PayU-Signatur akzeptiert; ausschließlich Rupien.

Enable/Disable: Enable PayU India Payment Gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.

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

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely via Credit/Debit Card, NetBanking, UPI, or Wallets through PayU.

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

Geo Zone: PayU India 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 India angeboten wird. Lassen Sie das Feld leer, um PayU India bei jedem Betrag anzubieten.

API-Zugangsdaten

Kopieren Sie den Merchant Key und den Merchant Salt (v1) aus PayU Dashboard > Payment Gateway > Key Salt Details. Schalten Sie das Dashboard für das Testpaar in den Test Mode. Der Abschnitt enthält den Link Open the PayU Dashboard.

Mode: die PayU-Umgebung, die neue Zahlungen verwenden.

Bereits begonnene Zahlungen behalten den Modus, in dem sie gestartet wurden: Ihre Ergebnisse werden mit Schlüssel und Salt dieses Modus geprüft und ihre Erstattungen damit gesendet, auch nachdem Sie den Modus gewechselt haben.

Live Merchant Key: Ihr Live-Merchant-Key von PayU.

Live Merchant Salt (v1): Ihr Live-Merchant-Salt (v1) von PayU. Er signiert Anfragen und prüft Antworten von PayU. Halten Sie ihn geheim.

Test Merchant Key: Ihr Test-Merchant-Key von PayU, nur im Testmodus verwendet.

Test Merchant Salt (v1): Ihr Test-Merchant-Salt (v1) von PayU, nur im Testmodus verwendet.

Gespeicherte Salts 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. Um einen gespeicherten Salt zu entfernen, markieren Sie unter dem Feld Clear the saved salt on save und klicken Sie auf Save.

Rücksprung- und Webhook-URLs

Return URL: sieht etwa so aus: https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/back; auf OpenCart 4 https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.back. Sie wird bei jeder Zahlung automatisch an PayU übergeben; es muss nichts eingerichtet werden.

Webhook URL: sieht etwa so aus: https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/webhook; auf OpenCart 4 https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.webhook. Optional, aber empfehlenswert: Sie bestätigt Zahlungen auch dann, wenn der Kunde den Browser schließt, bevor er zurückkehrt. Fügen Sie sie unter PayU Dashboard > Webhooks für erfolgreiche und fehlgeschlagene Zahlungen hinzu. Kopieren Sie die URL genau so, wie die Einstellungsseite sie anzeigt. Sie muss aus dem Internet erreichbar sein (keine Basisauthentifizierung und keine Firewall-Sperre). Der Wartungsmodus des Shops blockiert sie nicht.

Der Webhook enthält dasselbe signierte Ergebnis wie die Rückkehr des Kunden. Webhooks ohne gültigen PayU-Hash werden abgelehnt.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn PayU ein korrekt signiertes Ergebnis gesendet hat. Eine fehlgeschlagene oder stornierte Zahlung lässt die Bestellung ohne Status, und der Kunde kehrt mit erhaltenem Warenkorb zur Kasse zurück. Jedes der folgenden Felder listet Ihre Bestellstatus in OpenCart auf.

Order Status After Payment: eine erfolgreiche Zahlung mit dem erwarteten Betrag in INR, bestätigt durch verify_payment, wenn Verify Payment aktiviert ist. Standard: Processing.

Awaiting PayU Payment Status: PayU meldet die Zahlung als ausstehend (UPI-Collect, NetBanking läuft). Die Bestellung erhält den Status nach der Zahlung, sobald PayU sie bestätigt. Standard: Pending.

On Hold (Review) Status: PayU hat eine erfolgreiche Zahlung gemeldet, die eine manuelle Prüfung benötigt (siehe Bestellstatus). Standard: Pending, da OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment Error Status: eine ausstehende Zahlung, die PayU anschließend als fehlgeschlagen gemeldet hat. Standard: Failed.

Refunded Status: wird gesetzt, wenn alles Bezahlte von der Bestellseite aus erstattet wurde. Standard: Refunded.

Cancelled Order Status: der Status, den Ihr Shop für stornierte Bestellungen verwendet. Eine für eine solche Bestellung eingegangene Zahlung setzt sie auf Prüfung, statt sie als bezahlt zu markieren. Die Erweiterung setzt diesen Status nie. Standard: Canceled.

Erweitert

Verify Payment: prüft jede erfolgreiche Zahlung nochmals über die PayU-verify_payment-API. Empfohlen. Kann die Prüfung nicht abgeschlossen werden, wird die Bestellung auf Prüfung gesetzt, statt als bezahlt markiert zu werden. Standard: aktiviert.

Enable Logging: protokolliert Gateway-Ereignisse zur Fehlersuche in payu_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler und Warnungen werden immer protokolliert; diese Option ergänzt die übrigen Ereignisse, etwa jedes Zahlungsformular und jedes PayU-Ergebnis. Schlüssel, Salts und personenbezogene Daten der Kunden werden nie protokolliert. 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: löscht beim Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Bestellungen und PayU-Transaktionsdatensätze werden nie gelöscht. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig PayU India). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung; 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. Hat die Bestellung keine Telefonnummer, zeigt der Bestätigungsblock von OpenCart 4 außerdem das Feld Phone mit dem Hinweis PayU India benötigt die Telefonnummer des Zahlers. Die dort eingegebene Nummer wird an PayU gesendet und für den nächsten Versuch gespeichert; eine Telefonnummer der Bestellung hat Vorrang. Klickt der Kunde auf Confirm Order, prüft die Erweiterung die Währung, die Zugangsdaten des aktuellen Modus und die Telefonnummer der Bestellung. Ohne Telefonnummer bleibt der Kunde im Schritt mit PayU India benötigt eine Telefonnummer. Bitte geben Sie Ihre Telefonnummer ein und versuchen Sie es erneut. Andernfalls erstellt die Erweiterung eine signierte Zahlungsanfrage über den Bestellbetrag in INR, und der Browser sendet sie sofort an die gehostete Zahlungsseite von PayU. Die Seite zeigt Sie werden zu PayU weitergeleitet, um Ihre Zahlung abzuschließen. und eine Schaltfläche Pay with PayU, falls der Browser nicht von selbst weiterleitet. Auf der PayU-Seite zahlt der Kunde mit Karte, NetBanking, UPI oder Wallet.

Jeder Klick auf Confirm Order startet einen neuen Versuch mit einer eigenen PayU-Transaktions-ID (txnid), die mit der Bestellnummer beginnt und mit Betrag und Modus gespeichert wird. OpenCart 3 erstellt bei jeder Anzeige des Schritts Confirm Order eine neue Bestellung, OpenCart 4 aktualisiert die Bestellung der Kasse, daher bezahlt dort ein neuer Versuch dieselbe Bestellung. Eine Zahlung auf einer älteren, noch offenen Zahlungsseite derselben Bestellung wird weiterhin akzeptiert. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, wartet auf PayU oder steht auf Prüfung, gelangt der Kunde direkt zur Erfolgsseite, und es wird kein neues Zahlungsformular erstellt. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt.

PayU sendet das Ergebnis mit dem Kunden zurück und, falls konfiguriert, zusätzlich per Webhook. Ein Ergebnis wird nur mit einem gültigen PayU-Hash akzeptiert, der mit Schlüssel und Salt des Modus erstellt wurde, in dem die Zahlung begonnen wurde, und nur für eine Transaktions-ID, die für diese Bestellung ausgegeben wurde. Ist Verify Payment aktiv, wird ein erfolgreiches Ergebnis zusätzlich über die PayU-verify_payment-API geprüft. Der gezahlte Betrag muss dem Betrag des Versuchs und dem Bestellbetrag entsprechen, auf den letzten Paisa genau, in INR. Die Bestellung wird erst als bezahlt markiert, nachdem PayU dies so bestätigt hat, und erhält dann ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Die Erweiterung verarbeitet diese PayU-Ergebnisse:

Nach einer erfolgreichen oder ausstehenden Zahlung sieht der Kunde die Erfolgsseite der OpenCart-Bestellung. Eine ausstehende Zahlung ergänzt Ihre PayU-Zahlung ist ausstehend. Die Bestellung wird aktualisiert, sobald PayU das Ergebnis bestätigt — eine erneute Zahlung ist nicht nötig., eine Bestellung auf Prüfung ergänzt Ihre Zahlung wird geprüft. Wir melden uns, falls noch etwas benötigt wird., und eine unbezahlte Bestellung im Status Zahlungsfehler oder storniert zeigt Ihre PayU-Zahlung wurde nicht abgeschlossen. Bitte kontaktieren Sie uns zu dieser Bestellung.

Nach einer nicht erfolgreichen Zahlung kehrt der Kunde mit einer Meldung zur Kasse zurück: Die Zahlung wurde nicht abgeschlossen. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsmethode., Die Zahlung wurde storniert. Sie können es erneut versuchen. oder, wenn das Ergebnis nicht geprüft werden konnte, Wir konnten das Zahlungsergebnis nicht bestätigen. Wurde Ihr Konto belastet, kontaktieren Sie uns bitte, bevor Sie erneut bezahlen. Wird das Ergebnis bei der Rückkehr des Kunden noch verarbeitet, zeigt eine Seite Wir bestätigen Ihre PayU-Zahlung. Wenn Sie die Zahlung abgeschlossen haben, wird Ihre Bestellung in Kürze aktualisiert — bitte zahlen Sie nicht erneut. mit Check again und Back to checkout. Auf OpenCart 4 werden die Meldungen der Kasse 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 ausstehende Zahlung fehlgeschlagen ist oder Sie sie storniert haben), wird der Kunde mit der Meldung Ihre vorherige Bestellung wurde storniert oder die Zahlung ist fehlgeschlagen. Bitte bestätigen Sie die Bestellung erneut. zur Kasse zurückgeschickt. Wurde die Bestellung bezahlt und danach vom Shop storniert oder erstattet, lautet die Meldung Ihre vorherige Bestellung wurde vom Shop storniert oder erstattet. Bitte bestätigen Sie die Bestellung erneut, um mit einer neuen Bestellung zu bezahlen. War diese Bestellung für einen früheren Warenkorb bereits bezahlt und hat sich der Warenkorb seitdem geändert, lautet die Meldung Ihre vorherige Bestellung wurde bereits bezahlt. Ihr Warenkorb hat sich seitdem geändert. Bitte bestätigen Sie die Bestellung erneut, um den aktuellen Warenkorb zu bezahlen. Das nächste Confirm Order bezahlt eine neue Bestellung. Eine geschlossene Bestellung wird nie als bezahlt angezeigt.

Der Webhook funktioniert auch im Wartungsmodus des Shops, da OpenCart Anfragen von Zahlungserweiterungen durchlässt (auf OpenCart 4 fügt die Erweiterung dafür eine eigene Startaktion hinzu, die außerdem die Rückkehr des Kunden von PayU zulässt).

Die Erweiterung rechnet nur in INR ab und bietet keine Mehrwährungsverarbeitung (MCP). Sie bietet keine gespeicherten Karten oder Tokenisierung, keine Abonnements, kein eingebettetes (Seamless-)Kartenformular im Shop, keine EMI- oder Angebotsverwaltung und kein PayU-Ein-Klick-Checkout.

Bestellungen und Erstattungen

Bestellstatus

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

Order Status After Payment (Standard Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt PayU payment successful. Transaction ID: …, Mode: …, Bank: …

Awaiting PayU Payment Status (Standard Pending): eine UPI- oder NetBanking-Zahlung ist bei PayU noch ausstehend. Die Bestellung erhält den Bezahlt-Status, sobald PayU die Zahlung bestätigt.

On Hold (Review) Status (Standard Pending): der gezahlte Betrag oder die Währung weicht von der Bestellung ab, die verify_payment-API war nicht erreichbar oder hat die Zahlung noch nicht bestätigt, oder eine Zahlung ist für eine Bestellung im Status Cancelled Order Status eingegangen. Die Notiz nennt den Grund. Prüfen Sie die Transaktion im PayU Dashboard und setzen Sie dann den Bezahlt-Status oder stornieren Sie die Bestellung und erstatten Sie die Zahlung. War nur die Prüfung fehlgeschlagen, wird die Bestellung beim nächsten Eingang des Ergebnisses automatisch als bezahlt markiert.

Payment Error Status (Standard Failed): eine ausstehende Zahlung wurde später abgelehnt oder storniert. Ein späteres erfolgreiches Ergebnis bezahlt die Bestellung dennoch.

Refunded Status (Standard Refunded): alles Bezahlte wurde über die Erweiterung erstattet.

Meldet PayU eine weitere erfolgreiche Zahlung für eine bereits bezahlte Bestellung, bleibt die Bestellung unverändert, und eine Notiz bittet Sie, das Duplikat im PayU Dashboard zu erstatten. Eine Zahlung für eine andere Bestellung desselben Warenkorbs, der bereits bezahlt ist, lässt diese Bestellung ohne Status, mit einer Notiz an der bezahlten Bestellung. Eine PayU-Zahlung für eine Bestellung, die auf eine andere Zahlungsmethode umgestellt wurde, erhält nur eine Notiz.

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

Reiter VibeFox PayU India Payment Gateway

Öffnen Sie unter Sales > Orders eine mit PayU India bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox PayU India Payment Gateway die PayU transaction ID (mihpayid), die Store transaction ID (txnid), die Environment mit einem Hinweis Test mode bei Testzahlungen, den PayU-Status, den Mode / bank der Zahlung, die Beträge Paid / refund requested (INR), das Erstattungsformular, den Erstattungsverlauf und die PayU notes der Bestellung. Bei einer Bestellung auf Prüfung zeigt er eine Erinnerung, die Zahlung zu prüfen. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox PayU India Payment Gateway 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; der Betrag muss größer als null und darf nicht höher sein als der noch nicht erstattete Rest der Zahlung bei PayU. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Die Erstattung wird über die PayU-Refund-API mit Schlüssel und Salt des Modus gesendet, in dem die Zahlung erfolgte; diese Zugangsdaten müssen daher gesetzt sein. Pro Bestellung läuft immer nur eine PayU-Anfrage gleichzeitig. Lehnt PayU die Erstattung ab, zeigt der Reiter PayU refund failed: mit der Meldung von PayU, und es wird keine Erstattung erfasst.

PayU stellt Erstattungen in eine Warteschlange und führt sie asynchron aus; der Kunde erhält das Geld in der Regel innerhalb von 5–7 Werktagen. Der Erstattungsverlauf und die Notizen zeigen Betrag, PayU-Anfrage-ID und Grund. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Lagerbestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald PayU die Transaktions-ID der Zahlung gemeldet hat. Die Erweiterung prüft den Erstattungsstatus später nicht.

Produktrücksendungen unter Sales > Returns zahlen kein Geld über PayU zurück. Im PayU Dashboard vorgenommene Erstattungen werden nicht zurück nach OpenCart synchronisiert.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayU India Payment Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > 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-india 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 India 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 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 India wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und Schlüssel und Salt des gewählten Mode ausgefüllt sind. Prüfen Sie, ob der Kunde in INR bezahlt, 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 bei fehlenden Zugangsdaten und bei einer Shop-Währung, die nicht INR ist.

Die Zahlung war erfolgreich, aber die Bestellung bleibt ohne Status: Der Kunde ist nicht in den Shop zurückgekehrt, und kein Webhook ist eingegangen. Fügen Sie die Webhook-URL von der Einstellungsseite unter PayU Dashboard > Webhooks für erfolgreiche und fehlgeschlagene Zahlungen hinzu und stellen Sie sicher, dass sie aus dem Internet erreichbar ist.

Webhook antwortet invalid_signature: der PayU-Hash stimmte nicht überein. Prüfen Sie, ob Schlüssel und Salt des Modus der Zahlung korrekt sind und ob Salt v1 statt Salt v2 verwendet wird. Ein Ergebnis einer Live-Zahlung, das mit dem Test-Salt signiert wurde, oder umgekehrt, wird ebenfalls abgelehnt. Es wird nichts geändert.

Webhook antwortet not_configured: Schlüssel oder Salt des Modus, in dem die Zahlung begonnen wurde, fehlen. Tragen Sie sie ein; PayU wiederholt den Webhook.

Webhook antwortet verify_unavailable: die verify_payment-API konnte die Zahlung noch nicht bestätigen. Die Bestellung steht auf Prüfung, und die nächste Zustellung prüft erneut.

Webhook antwortet busy oder retry: die Rückkehr des Kunden mit demselben Warenkorb wurde im selben Moment verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. PayU wiederholt den Webhook. Der Grund wird ins Protokoll geschrieben.

Webhook antwortet ignored_unknown_txnid: die Transaktion wurde nicht von diesem Shop gestartet, etwa von einem anderen Shop, der dasselbe PayU-Konto nutzt. Es wird nichts geändert.

Der Kunde sieht PayU India benötigt eine Telefonnummer: Die Bestellung hat keine Telefonnummer. Lassen Sie das Feld Telephone in Ihrer Kasse eingeblendet. Auf OpenCart 4 kann der Kunde die Nummer im Feld Phone des Bestätigungsblocks eingeben.

Der Kunde sieht This payment method is not available. Please reload the checkout page.: Die Zahlungsmethode wurde inzwischen ausgeschaltet, die Zugangsdaten fehlen, oder die Kasse passt nicht mehr zur Bestellung. Der Kunde lädt die Kasse neu.

Die Bestellung steht im Prüfstatus: Lesen Sie die Notizen im Reiter VibeFox PayU India Payment Gateway. Der Grund ist eine Abweichung von Betrag oder Währung, eine fehlgeschlagene oder ausstehende Prüfung oder eine Zahlung für eine stornierte Bestellung.

Erstattung schlägt fehl: PayU transaction ID not found for this order. bedeutet, dass die Bestellung noch keine PayU-Zahlung hat. This payment was made in Test mode, but the Merchant Key/Salt of that mode are not set. (bzw. Live mode) bedeutet, dass Sie zuerst die Zugangsdaten dieses Modus eintragen müssen. Invalid refund amount: at most … INR can be refunded. bedeutet, dass der Betrag größer ist als der Rest der Zahlung.

Zu wenig im Protokoll: Fehler und Warnungen werden immer geschrieben; aktivieren Sie Enable Logging, um außerdem jedes Zahlungsformular und jedes PayU-Ergebnis zu sehen.

Für Entwickler: Bevor die Zahlungsanfrage signiert wird, löst die Erweiterung das OpenCart-Ereignis payu_p_request_fields mit den Anfragefeldern und der Bestellung aus. Schlüssel, Transaktions-ID, Betrag und Rücksprung-URLs können dadurch nicht verändert werden.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox PayU India Payment Gateway 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 Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 werden seine Ereignisse und seine Startaktion entfernt, die Webhook und Rückkehr des Kunden im Wartungsmodus durchlassen). Ist Delete data on uninstall aktiv, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Modus, Schlüssel, Salts, Zahlungsprüfung, Protokollierung) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die PayU-Transaktionsdatensätze und Erstattungsanfragen 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 India Payment Gateway 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.