VibeFox PayU India for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 6.0 oder neuer, installiert und aktiv. Das Plugin verweigert die Aktivierung ohne WooCommerce; wird WooCommerce später deaktiviert, tut das Plugin nichts und zeigt einen Hinweis im Administrationsbereich.

PHP: 8.0 oder neuer.

Store currency: Indische Rupie (INR). PayU India rechnet ausschließlich in Rupien ab. Bei anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet.

Phone number: PayU verlangt für jede Zahlung eine Telefonnummer. Machen Sie das Telefonnummernfeld an Ihrer Kasse zu einem Pflichtfeld oder zumindest sichtbar.

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

Internet access to your site: erforderlich für den optionalen Webhook. Ohne diesen werden Bestellungen bestätigt, wenn der Kunde von PayU zurückkehrt.

VibeFox license key: erworben auf vibefox.net. 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_payu_india_payment per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

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

4. Geben Sie Ihren VibeFox-Lizenzschlüssel in den Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie den Test Merchant Key und das Test Salt sowie den Live Merchant Key und das Live Salt ein (siehe Konfiguration).

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

7. Wählen Sie den Mode und aktivieren Sie Enable/Disable. Testen Sie eine Zahlung im Test-Modus und wechseln Sie dann auf Live.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > PayU India. Über den Feldern warnt die Seite, wenn der Schlüssel oder das Salt des aktuellen Modus fehlt, zeigt im Test-Modus Test mode is active: payments go to test.payu.in and no real money is charged. an und warnt Sie, wenn die Shop-Währung nicht INR ist (das Gateway wird dann an der Kasse ausgeblendet).

Beim Speichern werden Leerzeichen und Zeilenumbrüche aus Schlüsseln und Salts entfernt, da ein versehentlich mitkopiertes Leerzeichen dazu führen würde, dass jede PayU-Antwort die Prüfung nicht besteht.

Allgemein

Enable/Disable: Enable PayU India Payment Gateway aktiviert oder deaktiviert die Zahlungsmethode. Standard: deaktiviert.

Title: die Bezeichnung der Zahlungsmethode, die Kunden an der Kasse sehen. Standard: PayU India.

Description: die Beschreibung der Zahlungsmethode, die Kunden an der Kasse sehen. Standard: Pay securely via Credit/Debit Card, NetBanking, UPI, or Wallets through PayU.

API-Zugangsdaten

Kopieren Sie den Merchant Key und das Merchant Salt (v1) aus PayU Dashboard > Payment Gateway > Key Salt Details. Schalten Sie das Dashboard für das Test-Paar in den Test Mode.

Mode: welche PayU-Umgebung für neue Zahlungen verwendet wird.

Test (Sandbox): verwendet den Test-Schlüssel, das Test-Salt und test.payu.in. Es wird kein echtes Geld abgebucht. An der Kasse folgt auf die Beschreibung TEST MODE: no real money is charged. (Standard).

Live (Production): verwendet den Live-Schlüssel, das Live-Salt und secure.payu.in.

Erstattungen erfolgen immer in dem Modus, in dem die Zahlung getätigt wurde.

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

Live Merchant Salt (v1): Ihr Live-PayU-Merchant-Salt (v1). Es signiert Anforderungen und verifiziert Antworten von PayU. Halten Sie es geheim.

Test Merchant Key: Ihr PayU-Test-Merchant-Key, der nur im Test-Modus verwendet wird.

Test Merchant Salt (v1): Ihr PayU-Test-Merchant-Salt (v1), das nur im Test-Modus verwendet wird.

Return- und Webhook-URLs

Return URL: sieht aus wie https://your-site/wc-api/payu_p_callback/. Sie wird bei jeder Zahlung automatisch an PayU übermittelt; es muss nichts konfiguriert werden.

Webhook URL: sieht aus wie https://your-site/wc-api/payu_p_webhook/. Optional, aber empfohlen: bestätigt Zahlungen auch dann, wenn der Kunde den Browser vor der Rückkehr schließt. Fügen Sie sie in PayU Dashboard > Webhooks für erfolgreiche und fehlgeschlagene Zahlungen hinzu. Kopieren Sie die URL exakt so, wie sie auf der Einstellungsseite angezeigt wird.

Erweitert

Verify Payment: Double-check every successful payment with the PayU verify_payment API. Empfohlen. Kann die Überprüfung nicht abgeschlossen werden, wird die Bestellung auf „In Wartestellung“ gesetzt, statt als bezahlt markiert zu werden. Standard: aktiviert.

Enable Logging: Log gateway events for troubleshooting. Wird in WooCommerce > Status > Logs unter der Quelle wcp_payu_india_payment protokolliert. Fehler und Warnungen werden immer protokolliert; diese Option fügt die weiteren Ereignisse hinzu. Schlüssel, Salts und personenbezogene Daten von Kunden werden niemals protokolliert. Standard: deaktiviert.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted (orders are never deleted). Standard: deaktiviert.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig PayU India) und gibt die Bestellung auf. Fehlt bei der Bestellung die Rechnungs-Telefonnummer (oder die Versand-Telefonnummer), sieht der Kunde PayU India requires a phone number. Please enter your phone number and try again. Andernfalls gelangt der Kunde auf eine kurze Seite Thank you for your order. You will be redirected to PayU to complete your payment., die eine signierte Zahlungsanforderung an die gehostete PayU-Kasse sendet. Dort bezahlt der Kunde per Karte, NetBanking, UPI oder Wallet.

Jede Zahlungsseite erhält ihre eigene PayU-Transaktions-ID, die mit Betrag und Modus bei der Bestellung gespeichert wird. Eine Zahlung, die auf einer älteren, noch geöffneten Zahlungsseite derselben Bestellung getätigt wird, wird weiterhin akzeptiert. Eine bezahlte, in Wartestellung befindliche oder stornierte Bestellung erhält niemals ein neues Zahlungsformular, sodass die Zurück-Schaltfläche des Browsers keine zweite Zahlung auslösen kann.

PayU übermittelt das Ergebnis mit dem Kunden und, falls eingerichtet, per Webhook zurück. Ein Ergebnis wird nur mit einem gültigen PayU-Hash akzeptiert, der mit dem Schlüssel und dem Salt des Modus erstellt wurde, in dem die Zahlung gestartet wurde, und nur für eine für diese Bestellung ausgestellte Transaktions-ID. Ist Verify Payment aktiviert, wird ein erfolgreiches Ergebnis zusätzlich mit der PayU-API verify_payment geprüft. Der gezahlte Betrag muss der Bestellsumme auf die Paisa genau entsprechen, in INR. Erst nachdem PayU dies auf diesem Weg bestätigt hat, wird die Bestellung als bezahlt markiert. Das Plugin verarbeitet folgende PayU-Ergebnisse:

success: die Zahlung wurde geleistet. Die Bestellung wird als bezahlt markiert, wenn alle Prüfungen bestanden sind.

pending: eine UPI- oder NetBanking-Zahlung wird noch verarbeitet. Die Bestellung wird auf „In Wartestellung“ gesetzt; das endgültige Ergebnis trifft mit dem Webhook ein.

failure: die Zahlung wurde abgelehnt oder vom Kunden abgebrochen. Eine unbezahlte Bestellung, die auf diese Zahlung wartet, wird als Fehlgeschlagen markiert. Bezahlte Bestellungen werden niemals geändert.

Nach einer erfolgreichen oder ausstehenden Zahlung sieht der Kunde die Seite „Bestellung eingegangen“. Nach einer nicht erfolgreichen Zahlung kehrt der Kunde mit einer Nachricht zur Kasse zurück: Payment was not completed. Please try again or choose a different payment method., Payment was cancelled. You may try again. oder, wenn das Ergebnis nicht überprüft werden konnte, We could not confirm the payment result. If your account was charged, please contact us before paying again. Die Meldungen funktionieren auf der klassischen Kasse und im Kassen-Block.

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

Das Plugin rechnet ausschließlich in INR ab und bietet keine Mehrwährungsverarbeitung (MCP). Es bietet keine gespeicherten Karten oder Tokenisierung, keine WooCommerce Subscriptions, kein kartenbasiertes Formular auf der Website (seamless), keine Verwaltung von EMI oder Angeboten und keinen PayU-One-Click-Checkout.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: der Kunde wurde zu PayU weitergeleitet und hat noch nicht bezahlt.

Processing: die Zahlung wurde bestätigt. Die Bestellnotiz zeigt die PayU-Transaktions-ID (mihpayid), den Zahlungsmodus und den Bankcode. Die Transaktions-ID der Bestellung ist die PayU-mihpayid. Bestellungen, die nur virtuelle herunterladbare Produkte enthalten, werden auf Fertiggestellt gesetzt, wie es WooCommerce standardmäßig handhabt.

On hold: die Zahlung steht bei PayU noch aus (UPI oder NetBanking), der gezahlte Betrag oder die Währung weicht von der Bestellung ab, die API verify_payment konnte nicht erreicht werden oder hat die Zahlung noch nicht bestätigt, oder es ging eine Zahlung für eine bereits stornierte Bestellung ein. Die Bestellnotiz nennt den Grund. Überprüfen Sie die Transaktion im PayU Dashboard und schließen Sie sie ab oder erstatten Sie sie. Konnte die Überprüfung nicht durchgeführt werden, wird die Bestellung bei der nächsten Übermittlung des Ergebnisses automatisch bestätigt.

Failed: die Zahlung wurde abgelehnt oder abgebrochen. Der Kunde kann die Zahlung erneut versuchen.

Meldet PayU eine weitere erfolgreiche Zahlung für eine bereits bezahlte Bestellung, werden Sie in einer Notiz aufgefordert, das Duplikat im PayU Dashboard zu erstatten.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via PayU India (die Schaltfläche zeigt Ihren Title). Vollständige und teilweise Erstattungen werden unterstützt; der Betrag muss größer als null sein. Die Erstattung wird über die PayU-Erstattungs-API mit dem Schlüssel und dem Salt des Modus gesendet, in dem die Zahlung getätigt wurde; diese Zugangsdaten müssen daher hinterlegt sein. Lehnt PayU die Erstattung ab, zeigt WooCommerce die Meldung von PayU an und es wird keine Erstattung erfasst.

PayU reiht Erstattungen in eine Warteschlange ein und führt sie asynchron aus; der Kunde erhält das Geld in der Regel innerhalb von 5–7 Werktagen. Die Bestellnotiz zeigt den Betrag, die PayU-Anforderungs-ID und den Grund. Das Plugin prüft den Status der Erstattung später nicht erneut.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > PayU India. 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 aktiv ist, und Ihre Domain. Nutzen 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 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 PayU India 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, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen bleiben unberührt: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

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

Fehlerbehebung

PayU India does not appear at checkout: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und Schlüssel sowie Salt des gewählten Mode ausgefüllt sind. Prüfen Sie, ob die Shop-Währung (oder die Bestellwährung auf der Seite „Pay for order“) INR ist. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung an.

The payment went through, but the order stays Pending payment: der Kunde ist nicht zum Shop zurückgekehrt, und es ist kein Webhook eingegangen. Fügen Sie die Webhook-URL aus den Einstellungen in PayU Dashboard > Webhooks für erfolgreiche und fehlgeschlagene Zahlungen hinzu und stellen Sie sicher, dass sie über das Internet erreichbar ist.

Webhook answers invalid_signature: der PayU-Hash stimmt nicht überein. Prüfen Sie, ob Schlüssel und Salt des Zahlungsmodus korrekt sind und dass Salt v1 verwendet wird, nicht Salt v2. Die Bestellung wird nicht geändert.

Webhook answers not_configured: der Schlüssel oder das Salt des Modus, in dem die Zahlung gestartet wurde, fehlt. Tragen Sie diese ein; PayU wiederholt den Webhook.

Webhook answers verify_unavailable: die API verify_payment konnte die Zahlung noch nicht bestätigen. Die Bestellung befindet sich in Wartestellung, und die nächste Zustellung führt die Prüfung erneut durch.

The customer sees PayU India requires a phone number: machen Sie das Telefonnummernfeld an der Kasse zu einem Pflichtfeld oder sichtbar. Es wird die Rechnungs-Telefonnummer verwendet bzw. die Versand-Telefonnummer, wenn nur diese ausgefüllt ist.

The order is On hold: lesen Sie die Bestellnotiz. Der Grund ist eine ausstehende UPI- oder NetBanking-Zahlung, eine Abweichung bei Betrag oder Währung, eine fehlgeschlagene oder ausstehende Überprüfung oder eine Zahlung für eine stornierte Bestellung.

Refund fails: PayU transaction ID not found for this order. bedeutet, dass die Bestellung keine PayU-Zahlung aufweist. Eine Meldung, dass Merchant Key oder Salt des Zahlungsmodus nicht hinterlegt sind, bedeutet, dass Sie zuerst die Zugangsdaten für diesen Modus eingeben müssen.

Too little in the log: Fehler und Warnungen werden immer protokolliert; aktivieren Sie Enable Logging, um auch jede PayU-Anforderung und jedes Ergebnis zu sehen.

Developer hooks: der Filter payu_p_request_fields ändert die Felder der Zahlungsanforderung, bevor sie signiert werden; der Filter payu_p_icon ändert das Kassen-Icon.

The license block shows an error: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain in Verwendung, 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. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten bei. Um es vollständig zu entfernen, deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden dabei immer entfernt. Die Gateway-Einstellungen und die Protokolle dieses Plugins (Protokolldateien und Zeilen im WooCommerce-Datenbankprotokoll) werden nur gelöscht, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen, PayU-Transaktions-IDs und Erstattungs-Anforderungs-IDs.

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