VibeFox PayU LATAM for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Currency: Die Bestellung muss in ARS, BRL, CLP, COP, MXN, PEN oder USD vorliegen, den von PayU Latam in Argentinien, Brasilien, Chile, Kolumbien, Mexiko, Panama und Peru verarbeiteten Währungen. Bei anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet.

PayU Latam account: Sie benötigen drei Werte Ihres PayU-Händlerkontos: die Händler-ID, die Konto-ID des Landes, in dem Sie verkaufen, und den API-Schlüssel. Diese finden Sie im PayU-Modul (dem PayU-Händlerbereich) unter Settings > Technical configuration (Händler-ID, API-Schlüssel) und Accounts (Konto-ID). Für Tests veröffentlicht PayU öffentliche Sandbox-Zugangsdaten und Testkarten auf der Seite „Test your solution“ seiner Entwicklerdokumentation. API Login und weitere API-Zugangsdaten sind nicht erforderlich, da die Zahlung auf der von PayU gehosteten Seite erfolgt.

Internet access to your site: PayU übermittelt das Zahlungsergebnis von seinen Servern an Ihren Shop. Die Website muss daher aus dem Internet erreichbar sein (keine lokale Website, kein Passwortschutz und keine Wartungsseite).

VibeFox license key: auf vibefox.net erworben. Ein Schlüssel gilt für eine Domain.

Installation

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

2. Klicken Sie auf Activate.

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

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

5. Geben Sie die Sandbox- und Ihre Live-Zugangsdaten ein (siehe Konfiguration). In PayU muss keine Bestätigungs-URL eingerichtet werden.

6. Aktivieren Sie Enable/Disable und speichern Sie. Lassen Sie Sandbox aktiviert, bis Sie eine Testzahlung durchgeführt haben. Entfernen Sie anschließend das Häkchen, um mit den Live-Zugangsdaten echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > PayU LATAM. Oberhalb der Felder warnt die Seite bei aktivem Sandbox-Modus (Sandbox mode. Zahlungen gehen an die PayU-Sandbox und es wird kein echtes Geld belastet.), bei fehlender Händler-ID, Konto-ID oder fehlendem API-Schlüssel der aktuellen Umgebung und wenn PayU LATAM die Shop-Währung nicht verarbeitet. In den letzten beiden Fällen wird PayU LATAM an der Kasse nicht angezeigt. In der Liste der Zahlungsmethoden wird PayU LATAM als einrichtungsbedürftig markiert, bis alle drei Zugangsdaten der aktuellen Umgebung ausgefüllt sind. Leerzeichen am Anfang oder Ende eines Zugangswerts werden ignoriert.

Allgemein

Enable/Disable: Enable PayU LATAM schaltet die Zahlungsmethode ein oder aus. Standard: off.

Title: der Titel der Zahlungsmethode, den der Kunde an der Kasse sieht. Standard: PayU LATAM.

Description: die Beschreibung der Zahlungsmethode, die der Kunde an der Kasse sieht. Standard: Pay with a card, cash or bank transfer on the secure PayU page. You will be redirected to PayU to complete your payment.

Umgebung

Sandbox: Enable the PayU sandbox (test mode). Zahlungen gehen mit den unten angegebenen Sandbox-Zugangsdaten an die PayU-Sandbox, ohne echtes Geld zu belasten. Bei deaktivierter Option werden die Live-Zugangsdaten und die Live-Kasse von PayU verwendet. Standard: on.

Live-Zugangsdaten

Sie finden sie im PayU-Modul: Settings > Technical configuration (Händler-ID, API-Schlüssel) und Accounts (Konto-ID des Landes, in dem Sie verkaufen). Der Abschnitt verlinkt auf den PayU-Händlerbereich.

Merchant ID: die numerische Kennung Ihres PayU-Händlerkontos.

Account ID: die Kennung des PayU-Kontos. Es gibt ein Konto pro Land.

API Key: der geheime Schlüssel zum Signieren von Zahlungen und Überprüfen von PayU-Benachrichtigungen.

Sandbox-Zugangsdaten

PayU veröffentlicht öffentliche Testzugangsdaten und Testkarten für seine Sandbox. Der Abschnitt verlinkt auf die Seite „Test your solution“ der PayU-Dokumentation.

Sandbox merchant ID: die Händler-ID für die PayU-Sandbox.

Sandbox account ID: die Konto-ID für die PayU-Sandbox.

Sandbox API key: der API-Schlüssel für die PayU-Sandbox.

Jeder Zahlungsversuch speichert seine Umgebung. Die Bestätigung einer Sandbox-Zahlung wird mit dem Sandbox-API-Schlüssel und der Sandbox-Händler-ID geprüft, die einer Live-Zahlung mit den Live-Werten. So funktionieren ausstehende Zahlungen auch nach einem Wechsel weiter. Bei einem Update von Version 1.0, die nur einen Zugangsdaten-Satz hatte, werden die alten Werte in die Sandbox-Felder kopiert, sofern die Sandbox aktiviert war. Prüfen Sie die Einstellungen nach dem Update.

Bestätigungs-URL

Dieser Abschnitt zeigt die URL, an die PayU jedes Zahlungsergebnis meldet. Sie sieht so aus: https://your-site/wc-api/payu_lp/. Das Plugin sendet sie bei jeder Zahlung an PayU, daher ist in PayU keine Konfiguration erforderlich. Die Seite muss aus dem Internet erreichbar sein. PayU signiert die Bestätigung mit Ihrem API-Schlüssel. Bestätigungen ohne gültige Signatur, mit einer anderen Händler-ID oder mit einer Zahlungsreferenz, die dieser Shop nicht für die Bestellung vergeben hat, werden abgelehnt. Das Plugin verarbeitet diese PayU-Transaktionszustände:

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

6 (declined), 5 (expired), 104 (error): Die Zahlung ist fehlgeschlagen. Eine unbezahlte Bestellung des letzten Versuchs wird auf Fehlgeschlagen gesetzt.

7 and other pending states: Die Zahlung steht aus, etwa eine vom Kunden noch nicht abgeschlossene Bar- oder Bankzahlung. Die Bestellung wird auf Wartend gesetzt.

Andere Zustände werden nur als Bestellnotiz hinzugefügt. Ohne Bestätigung wird eine Bestellung niemals als bezahlt markiert: Sie bleibt auf Zahlung ausstehend.

Erweitert

Debug log: Log payment requests and PayU notifications schreibt Details unter WooCommerce > Status > Logs, Quelle wcp_payu_latam_payment, ohne Schlüssel oder personenbezogene Daten. Fehler und abgelehnte Benachrichtigungen werden immer protokolliert. Standard: off.

Delete data: Delete the settings and logs when the plugin is deleted. Beim Deaktivieren des Plugins wird niemals etwas gelöscht. In Bestellungen gespeicherte PayU-Daten bleiben erhalten. Standard: off.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig PayU LATAM) und gibt die Bestellung auf. Im Kassen-Block sieht er im Sandbox-Modus Sandbox mode: no real payment is made. Die Bestellung bleibt auf Zahlung ausstehend, und der Kunde gelangt auf eine Zahlungsseite Ihres Shops mit dem Text Thank you for your order. You are being redirected to PayU LATAM to complete the payment… Die Seite sendet automatisch ein signiertes Formular an PayU WebCheckout. Geschieht dies nicht, klickt der Kunde auf Pay with PayU LATAM oder zum Stornieren der Bestellung auf Cancel order.

Das Formular enthält Bestellsumme und Währung, Steuer und Steuerbemessungsgrundlage der Bestellung (beide 0 bei steuerfreien Bestellungen, damit PayU keine standardmäßige Mehrwertsteuer hinzufügt), die Beschreibung Order # mit Bestellnummer und Shop-Namen sowie E-Mail-Adresse, Name, Telefonnummer und Rechnungsadresse des Kunden. Die PayU-Seite öffnet sich je nach Shop-Sprache auf Spanisch, Portugiesisch oder Englisch. Dort zahlt der Kunde mit einer in Ihrem PayU-Konto aktivierten Methode.

Jeder Besuch der Zahlungsseite startet einen neuen Zahlungsversuch mit eigener Referenz (Bestellnummer und Zeitstempel). Die letzten 30 Versuche der Bestellung werden gespeichert: Zahlt der Kunde in einem älteren PayU-Tab, wird die Zahlung weiterhin angenommen.

Die Bestellung wird erst als bezahlt markiert, wenn PayU dies mit der signierten Bestätigung bestätigt. Die Rückkehr des Kunden von PayU markiert eine Bestellung niemals als bezahlt. Wenn der Kunde zurückkehrt:

Nach einer signierten Ablehnung, einem Ablauf oder Fehler: Die Bestellung wird sofort auf Fehlgeschlagen gesetzt, und WooCommerce zeigt seine Standardseite für fehlgeschlagene Zahlungen mit der Möglichkeit, erneut zu bezahlen.

Ohne PayU-Transaktion (der Kunde hat die PayU-Seite verlassen): Der Kunde gelangt auf die Seite Pay for order mit der Meldung Your PayU LATAM payment was not completed. You can try again or choose another payment method.

Andernfalls: Der Kunde sieht die Bestelleingangsseite. Solange die Bestellung auf Zahlung ausstehend steht, erscheint We are waiting for PayU LATAM to confirm your payment. You will receive an e-mail as soon as it is confirmed. Bei einer wartenden Bestellung erscheint Your PayU LATAM payment is pending (for example, a cash or bank payment that has not been completed yet). We will process the order as soon as PayU confirms the payment.

Fehlen die Zugangsdaten der aktuellen Umgebung, sieht der Kunde PayU LATAM is not available right now. Please choose another payment method. Bei einer nicht unterstützten Bestellwährung lautet die Meldung PayU LATAM does not accept payments in, gefolgt von der Währung. Eine bereits bezahlte Bestellung wird nicht erneut bezahlt: Die Zahlungsseite zeigt This order has already been paid.

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

Das Plugin bietet kein Zahlungsformular im Shop, keine Erstattungen über WooCommerce, keine gespeicherten Karten, keine Abonnements und keine Ratenzahlungseinstellungen (PayU zeigt Raten auf seiner Seite an). Es fragt den Zahlungsstatus nicht über die PayU-API ab: Nur die signierte Bestätigung aktualisiert die Bestellung.

Bestellungen

Bestellstatus

Pending payment: Der Kunde wurde zu PayU weitergeleitet und hat noch nicht bezahlt, oder PayU hat noch keine Bestätigung gesendet.

Processing: PayU hat die Zahlung bestätigt, Betrag und Währung stimmen überein. Die Bestellnotiz zeigt die PayU-Transaktion, den Betrag, die Zahlungsmethode und bei Sandbox-Zahlungen [sandbox]. Die Transaktions-ID der Bestellung ist die PayU-Transaktions-ID. Bestellungen, die ausschließlich virtuelle herunterladbare Produkte enthalten, werden auf Abgeschlossen gesetzt, wie es WooCommerce standardmäßig vorsieht.

On hold: PayU meldet die Zahlung als ausstehend (Bar- oder Bankzahlung), der gezahlte Betrag oder die Währung passt nicht zur Bestellsumme, oder eine Zahlung für eine stornierte Bestellung wurde genehmigt. Die Bestellnotiz nennt den Grund: Prüfen Sie die Zahlung im PayU-Modul und bearbeiten Sie anschließend die Bestellung, stellen Sie sie wieder her oder erstatten Sie die Zahlung.

Failed: Der letzte Zahlungsversuch wurde abgelehnt, ist abgelaufen oder endete mit einem Fehler. Die Notiz zeigt die PayU-Meldung. Der Kunde kann erneut bezahlen. Die Ablehnung eines älteren Versuchs oder einer Bestellung mit bereits genehmigter Zahlung wird nur als Notiz hinzugefügt.

Jede Benachrichtigung wird unter einer Sperre pro Bestellung einmal verarbeitet: Wiederholte PayU-Benachrichtigungen erzeugen keine doppelten Notizen, Bestandsreduzierungen oder E-Mails. Wird die Bestellung zu lange durch eine andere Anfrage aktualisiert, erhält die Bestätigung eine Fehlerantwort, und PayU sendet sie später erneut. Eine bezahlte, abgeschlossene oder erstattete Bestellung wird niemals wieder geöffnet. Trifft für eine bereits bezahlte Bestellung eine weitere genehmigte Zahlung ein, weist eine Notiz darauf hin: Hat der Kunde zweimal bezahlt, erstatten Sie die doppelte Zahlung im PayU-Modul.

Erstattungen

Erstattungen erfolgen nicht über WooCommerce. Erstatten Sie die Transaktion im PayU-Modul und erfassen Sie die Erstattung bei Bedarf manuell in WooCommerce.

Lizenzschlüssel

Das Plugin verwendet einen VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > PayU LATAM. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, etwa das Gültigkeitsdatum der Lizenz und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein, und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel gilt für eine Domain. Das Entfernen des Schlüssels von einer Website gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird PayU LATAM 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 der Kennzeichnung (unlicensed — visible to admins only), damit Sie das Plugin vor dem Schlüsselkauf einrichten und testen können. Auf der Plugin-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt.

Nach Ablauf einer Lizenz funktioniert das Plugin weiter, aber für Updates und Support ist eine Verlängerung erforderlich. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

PayU LATAM erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv und Enable/Disable eingeschaltet ist und Händler-ID, Konto-ID sowie API-Schlüssel der aktuellen Umgebung ausgefüllt sind: die Sandbox-Zugangsdaten bei aktiviertem Sandbox, die Live-Zugangsdaten bei deaktivierter Option. Prüfen Sie, ob die Shop-Währung (oder die Bestellwährung auf der Seite zum Bezahlen der Bestellung) ARS, BRL, CLP, COP, MXN, PEN oder USD ist. Die Einstellungsseite zeigt für jedes dieser Probleme eine Warnung.

Die Zahlung war erfolgreich, aber die Bestellung bleibt auf Pending payment: Die PayU-Bestätigung hat Ihren Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie, ob die in den Einstellungen angezeigte Bestätigungs-URL aus dem Internet erreichbar ist (keine lokale Website, kein Wartungsmodus, keine Firewall und kein Passwortschutz). Prüfen Sie WooCommerce > Status > Logs, Quelle wcp_payu_latam_payment, auf abgelehnte Bestätigungen. Nach jeder Fehlerantwort sendet PayU die Bestätigung erneut.

Bestätigung antwortet mit Invalid signature: Die Bestätigung wurde nicht mit dem API-Schlüssel der Zahlungsumgebung signiert. Prüfen Sie API Key für Live-Zahlungen und Sandbox API key für Sandbox-Zahlungen.

Bestätigung antwortet mit Merchant mismatch: Die Händler-ID der Bestätigung weicht von Merchant ID oder Sandbox merchant ID der Zahlungsumgebung ab. Geben Sie die Händler-ID des PayU-Kontos ein, das die Zahlungen verarbeitet.

Bestätigung antwortet mit Gateway not configured: API-Schlüssel oder Händler-ID der Zahlungsumgebung fehlen, etwa weil die Sandbox-Zugangsdaten während einer ausstehenden Sandbox-Zahlung entfernt wurden. Geben Sie sie erneut ein; PayU wiederholt die Bestätigung.

Bestätigung antwortet mit Busy, retry later: Die Bestellung wurde gleichzeitig durch eine andere Anfrage aktualisiert. Es wurde nichts geändert, und PayU sendet die Bestätigung erneut.

Bestätigung antwortet mit Unknown reference: Die Zahlungsreferenz gehört zu keiner PayU LATAM-Bestellung dieses Shops, etwa weil die Bestellung auf eine andere Zahlungsmethode umgestellt oder gelöscht wurde.

Die Bestellung steht auf On hold: Lesen Sie die Bestellnotiz. Die Zahlung steht bei PayU noch aus (Bar- oder Bankzahlung), der gezahlte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung traf nach der Stornierung der Bestellung ein. Prüfen Sie die Transaktion im PayU-Modul.

Andere Währungen oder Formularfelder: Entwickler können die Währungsliste mit dem Filter payu_lp_supported_currencies, das Kassensymbol mit dem Filter payu_lp_icon und die WebCheckout-Formularfelder mit dem Filter payu_lp_payment_fields ändern.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Wird der Schlüssel etwa bereits auf einer anderen Domain verwendet, 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

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Um es zu entfernen, deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen und Protokolle dieses Plugins werden nur entfernt, wenn Delete data aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten Zahlungsnotizen, PayU-Referenzen und Transaktions-IDs.

PayU ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit PayU verbunden noch von PayU unterstützt.