VibeFox PayU LATAM 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: Die Kassenwährung des Kunden muss ARS, BRL, CLP, COP, MXN, PEN oder USD sein, also die Währungen, die PayU Latam in Argentinien, Brasilien, Chile, Kolumbien, Mexiko, Panama und Peru verarbeitet. Bei anderen Währungen wird die Zahlungsmethode an der Kasse ausgeblendet.

PayU-Latam-Konto: Sie benötigen drei Werte Ihres PayU-Händlerkontos: die Merchant ID, die Account ID des Landes, in dem Sie verkaufen, und den API-Schlüssel. Sie finden sie im PayU-Händlerpanel unter Settings > Technical configuration (merchant ID, API key) und Accounts (account ID). Zum Testen veröffentlicht PayU öffentliche Sandbox-Zugangsdaten und Testkarten auf der Seite „Test your solution“ seiner Entwicklerdokumentation. Die API Login und andere API-Zugangsdaten werden nicht benötigt, da die Zahlung auf der gehosteten PayU-Seite erfolgt und die Erweiterung die PayU-API nie aufruft.

Internetzugang für Ihren Shop: PayU sendet das Zahlungsergebnis von seinen Servern an Ihren Shop. Deshalb muss der Shop aus dem Internet erreichbar sein (kein lokales System und kein Passwortschutz).

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel gilt 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_latam_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_payu_latam_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 Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_payu_latam_payment-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox PayU LATAM Payment und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer braucht das Recht, die Liste der Zahlungserweiterungen zu ändern.

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

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

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Lassen Sie Sandbox eingeschaltet, bis Sie eine Testzahlung durchgeführt haben, und schalten Sie es danach aus, um mit den Live-Zugangsdaten echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_payu_latam_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 (der grüne +-Button).

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

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

Eine neue Installation startet mit ausgeschalteter Zahlungsmethode und eingeschalteter Sandbox.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox PayU LATAM Payment > Edit. Die Abschnitte stehen links; der Button Save unter der Liste speichert die gesamte Seite. Über den Einstellungen zeigt die Seite Sandbox mode. Payments go to the PayU sandbox and no real money is charged., solange die Sandbox eingeschaltet ist. Außerdem erscheint ein Fehler, wenn die Merchant ID, Account ID oder der API-Schlüssel der aktuellen Umgebung fehlt (dann wird PayU LATAM an der Kasse nicht angeboten), und eine Warnung, wenn PayU LATAM die Standardwährung des Shops nicht verarbeitet. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und nicht mehr als 128 Zeichen haben (die Seite zeigt Enter a title for the payment method (at most 128 characters).). Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl von 0 oder größer sein, und die Geozone und die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert. Leerzeichen am Anfang oder Ende eines Zugangsdatums werden ignoriert.

PayU LATAM

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

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

Description: der Text, den der Kunde im Schritt Confirm Order über dem Bestätigungsbutton 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.

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

Geo Zone: PayU LATAM nur für Zahlungsadressen in der ausgewählten Geozone anbieten. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

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

Umgebung

Sandbox: Zahlungen gehen mit den Sandbox-Zugangsdaten an die PayU-Sandbox, und es wird kein echtes Geld belastet. Ist die Option ausgeschaltet, werden die Live-Zugangsdaten und die Live-Kasse von PayU verwendet. Standard: eingeschaltet. Solange sie eingeschaltet ist, sieht der Kunde im Schritt Confirm Order den Hinweis Sandbox mode: no real money is charged.

Live-Zugangsdaten

Sie finden sie im PayU-Händlerpanel unter Settings > Technical configuration (merchant ID, API key) und Accounts (account ID des Landes, in dem Sie verkaufen). Der Abschnitt verlinkt auf das PayU-Händlerpanel.

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, mit dem Zahlungen signiert und PayU-Benachrichtigungen geprüft werden.

Sandbox-Zugangsdaten

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

Sandbox merchant ID: die Merchant ID für die PayU-Sandbox.

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

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

Gespeicherte API-Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear saved secret on save und klicken Sie auf Save.

Jeder Zahlungsversuch merkt sich seine Umgebung. Die Bestätigung einer Sandbox-Zahlung wird mit dem Sandbox-API-Schlüssel und der Sandbox-Merchant-ID geprüft, die Bestätigung einer Live-Zahlung mit den Live-Werten. So funktionieren ausstehende Zahlungen auch nach einem Umschalten weiter. Sandbox-Zahlungen werden in den Bestellnotizen als Sandbox gekennzeichnet.

Bestätigungs-URL

Dieser Abschnitt zeigt die URL, an die PayU jedes Zahlungsergebnis meldet. Auf OpenCart 3 hat sie das Format https://your-store/index.php?route=extension/payment/wcp_payu_latam_payment/confirmation, auf OpenCart 4 https://your-store/index.php?route=extension/wcp_payu_latam_payment/payment/wcp_payu_latam_payment.confirmation. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Die Erweiterung sendet sie bei jeder Zahlung an PayU, deshalb muss in PayU nichts konfiguriert werden. Die URL muss aus dem Internet erreichbar sein. Sie funktioniert 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). PayU signiert die Bestätigung mit Ihrem API-Schlüssel. Bestätigungen ohne gültige Signatur, mit einer anderen Merchant ID oder mit einer Zahlungsreferenz, die dieser Shop nicht ausgestellt hat, werden abgelehnt. Die Erweiterung verarbeitet diese PayU-Transaktionsstatus:

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

6 (abgelehnt), 5 (abgelaufen), 104 (Fehler): die Zahlung ist fehlgeschlagen. Eine Bestellung ohne Status bleibt ohne Status, und der Warenkorb bleibt erhalten.

7, 10, 12, 14, 15, 18 (ausstehend): die Zahlung wartet, zum Beispiel auf eine Bar- oder Banküberweisung, die der Kunde noch nicht abgeschlossen hat. Die Bestellung erhält Awaiting Payment Status.

Andere Status werden nur als Notiz hinzugefügt. Ohne die Bestätigung erhält die Bestellung keinen Status.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Die Bestellung erhält erst nach der signierten PayU-Bestätigung einen Status. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment (default Processing): eine genehmigte Zahlung (PayU-Status 4) mit dem erwarteten Betrag und der erwarteten Währung. Standard: In Bearbeitung.

Awaiting Payment Status (default Pending): eine ausstehende Zahlung (Status 7, 10, 12, 14, 15, 18, zum Beispiel eine noch nicht abgeschlossene Bar- oder Banküberweisung). Die Bestellung erhält Order Status After Payment, sobald PayU sie bestätigt. Standard: Ausstehend.

On Hold (Review) Status (default Pending): PayU hat eine Zahlung mit einem anderen Betrag oder einer anderen Währung als die Bestellung genehmigt oder für eine Bestellung, die storniert war. Eine Notiz zeigt die Details; die Bestellung wird nicht als bezahlt markiert. Standard: Ausstehend, da OpenCart keinen Status On hold hat. Sie können einen eigenen Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

Failed Payment Status (default Failed): eine ausstehende Zahlung des letzten Versuchs, die PayU danach als abgelehnt, abgelaufen oder fehlgeschlagen gemeldet hat. Standard: Fehlgeschlagen.

Cancelled Order Status: der Status, den Ihr Shop für stornierte Bestellungen verwendet. Eine genehmigte Zahlung für eine solche Bestellung setzt sie auf On Hold (Review) Status, statt sie als bezahlt zu markieren. Die Erweiterung setzt diesen Status nie. Standard: Storniert.

Erweitert

Debug log: protokolliert Zahlungsanfragen und PayU-Benachrichtigungen in payu_lp_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser öffnen, und bei 5 MB wird sie nach payu_lp_debug.old.log.php verschoben. Schlüssel und personenbezogene Daten werden nicht protokolliert. Fehler und abgelehnte Benachrichtigungen werden immer protokolliert, auch wenn dieser Schalter aus 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: wenn eingeschaltet, entfernt die Deinstallation der Erweiterung die Gateway-Einstellungen und das Protokoll. Bestellungen und die PayU-Zahlungsdatensätze (Zahlungsversuche) werden nie gelöscht. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die API-Schlüssel werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten API-Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig PayU LATAM). 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. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung ein signiertes Zahlungsformular. Die Seite zeigt You are being redirected to PayU LATAM to complete the payment... und sendet das Formular automatisch an die PayU-WebCheckout-Seite. Passiert das nicht, klickt der Kunde auf Pay with PayU LATAM.

Das Formular enthält den Bestellbetrag in der Bestellwährung, die Steuer und die Steuerbemessungsgrundlage der Bestellung (beide 0 bei Bestellungen ohne Steuer, damit PayU keine Standard-MwSt. hinzufügt), die Beschreibung Order # mit der Bestellnummer und dem Namen Ihres Shops sowie die E-Mail-Adresse, den Namen, die Telefonnummer und die Rechnungsadresse des Kunden. Die PayU-Seite öffnet sich auf Spanisch, Portugiesisch oder Englisch, je nach Sprache des Kunden. Auf der PayU-Seite zahlt der Kunde mit jeder Methode, die in Ihrem PayU-Konto aktiviert ist.

Jeder Klick auf Confirm Order startet einen neuen Zahlungsversuch mit eigener Referenz (OC, der Bestellnummer und einem Zeitstempel). Auf OpenCart 4 bezahlt ein neuer Versuch dieselbe Bestellung der Kasse. Ältere Versuche bleiben erhalten: Zahlt der Kunde in einem älteren PayU-Tab, wird die Zahlung trotzdem erkannt.

Die Bestellung wird erst als bezahlt markiert, wenn PayU sie mit der signierten Bestätigung bestätigt. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Ein Kunde, der von PayU zurückkommt, markiert eine Bestellung nie als bezahlt. Wenn der Kunde zurückkehrt:

Nach einer signierten Ablehnung, einem Ablauf oder einem Fehler: der Kunde ist wieder an der Kasse, mit Your PayU LATAM payment was not approved, dem PayU-Grund, falls vorhanden, und You can try again or choose another payment method. Der Warenkorb bleibt erhalten.

Ohne PayU-Transaktion (der Kunde hat die PayU-Seite verlassen): der Kunde ist wieder an der Kasse, mit Your PayU LATAM payment was not completed. You can try again or choose another payment method.

Die Bestellung hat bereits einen Status: der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Bei einer ausstehenden Zahlung steht dort außerdem 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. Bei einer Zahlung in Prüfung steht dort We have received your PayU LATAM payment and are reviewing it. We will contact you if anything is needed. Scheitert eine ausstehende Zahlung später, ist der Kunde wieder an der Kasse und sieht den Grund.

PayU hat noch nicht bestätigt: eine Seite zeigt We are waiting for PayU LATAM to confirm your payment. You will receive an e-mail as soon as it is confirmed. (oder den oben genannten ausstehenden Text bei einer Bar- oder Banküberweisung) mit einem Button Check again und einem Button Back to checkout. Die Bestätigung setzt den Bestellstatus, sobald sie eintrifft.

Auf OpenCart 4 werden die Meldungen der Kasse oberhalb der Kassenseite angezeigt.

OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird, OpenCart 4 aktualisiert die Bestellung der Kasse. Ein Warenkorb wird aber nur einmal bezahlt: Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, ausstehend oder in Prüfung, führt Confirm Order direkt zur Erfolgsseite. Fehlen die Zugangsdaten der aktuellen Umgebung, sieht der Kunde PayU LATAM is not available right now. Please choose another payment method.

Auf OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil die Barzahlung fehlgeschlagen ist oder Sie sie storniert haben), wird der Kunde mit Your PayU LATAM payment was not approved und dem Grund von PayU, falls vorhanden, zur Kasse zurückgeschickt. Wurde die Bestellung bezahlt und danach vom Shop geschlossen oder war sie für einen früheren Warenkorb bezahlt und der Warenkorb hat sich seitdem geändert, lautet die Meldung Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. Das nächste Confirm Order bezahlt eine neue Bestellung. Eine geschlossene Bestellung wird nie als bezahlt angezeigt.

Die Erweiterung hat kein Zahlungsformular auf Ihrer Website, keine Erstattungen aus OpenCart, keine gespeicherten Karten, keine Abonnements und keine Einstellungen für Ratenzahlungen (PayU zeigt Raten auf seiner Seite an). Sie fragt den Zahlungsstatus nicht über die PayU-API ab: Nur die signierte Bestätigung aktualisiert die Bestellung.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): der Kunde wurde zu PayU weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt, oder PayU hat die Bestätigung noch nicht gesendet. In Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (default Processing): PayU hat die Zahlung bestätigt, und Betrag und Währung stimmen überein. Eine Notiz zeigt die Transaktion, den Betrag, die Zahlungsmethode und ob es eine Sandbox-Zahlung war.

Awaiting Payment Status (default Pending): PayU meldet die Zahlung als ausstehend (Bar- oder Banküberweisung). Die Bestellung wechselt zu Order Status After Payment, wenn PayU die Zahlung bestätigt, oder zu Failed Payment Status, wenn sie fehlschlägt. OpenCart benachrichtigt den Kunden über diese Änderungen.

On Hold (Review) Status (default Pending): der bezahlte Betrag oder die Währung weicht von der Bestellung ab, oder eine Zahlung wurde für eine stornierte Bestellung genehmigt. Die Notiz sagt, welcher Fall vorliegt. Prüfen Sie die Zahlung im PayU-Händlerpanel und bearbeiten Sie dann die Bestellung, stellen Sie sie wieder her oder erstatten Sie die Zahlung.

Failed Payment Status (default Failed): eine ausstehende Zahlung des letzten Versuchs wurde später abgelehnt, ist abgelaufen oder mit einem Fehler beendet worden. Die Notiz zeigt die PayU-Meldung. Eine Ablehnung eines älteren Versuchs oder einer Bestellung, die bereits eine genehmigte Zahlung hat, wird nur als Notiz hinzugefügt.

Jede Benachrichtigung wird einmal verarbeitet, unter einer Sperre pro Warenkorb. Wiederholte PayU-Benachrichtigungen ändern eine Bestellung daher nicht zweimal und fügen keine Notizen doppelt hinzu. Eine bezahlte Bestellung wird nie herabgestuft. Kommt eine weitere genehmigte Zahlung für eine bereits bezahlte Bestellung oder für eine andere Bestellung desselben Warenkorbs, weist eine Notiz an der bezahlten Bestellung darauf hin: Hat der Kunde doppelt bezahlt, erstatten Sie das Duplikat im PayU-Händlerpanel.

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

Registerkarte VibeFox PayU LATAM Payment

Öffnen Sie unter Sales > Orders eine mit PayU LATAM bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox PayU LATAM Payment die Reference, die Transaction ID, die PayU reference, den Status und den PayU-Status, den Requested-Betrag, den Amount reported by PayU, die Payment method, die PayU message, ein SANDBOX-Kennzeichen für Sandbox-Zahlungen, die Liste aller Payment attempts des Warenkorbs und die PayU LATAM notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen werden nicht aus OpenCart heraus vorgenommen. Erstatten Sie die Transaktion im PayU-Händlerpanel und erfassen Sie die Erstattung danach manuell in OpenCart.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayU LATAM Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox PayU LATAM Payment > Edit, über den 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 aktiv ist, und Ihre Domain) sowie die Buttons Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-payu-latam und der Link Lizenzen und Domains in Ihrem Konto verwalten, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht „Modify“ für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, zeigt 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. Nach einer Änderung der Shop-Adresse 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 gilt 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 LATAM 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 Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsmethode im Shop weiterhin, markiert als (unlicensed — visible to admins only). So können Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen. 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 Dashboard des Admin-Bereichs eine Erinnerung. Mit × schließen Sie sie; sie bleibt dann 7 Tage ausgeblendet. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch die PayU-Bestätigung und die Rückkehr des Kunden bestätigt.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter. Updates und Support benötigen aber eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard oder die Seite Edit im Admin-Bereich ö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 LATAM erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Merchant ID, Account ID und der API-Schlüssel der aktuellen Umgebung ausgefüllt sind: die Sandbox-Zugangsdaten, wenn Sandbox eingeschaltet ist, die Live-Zugangsdaten, wenn sie ausgeschaltet ist. Prüfen Sie, ob die Währung des Kunden ARS, BRL, CLP, COP, MXN, PEN oder USD ist, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Betrag erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: die PayU-Bestätigung hat Ihren Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie, ob die Bestätigungs-URL aus den Einstellungen aus dem Internet erreichbar ist (kein lokales System, keine Firewall und kein Passwortschutz). Sehen Sie im Feld Log der Erweiterungsseite nach abgelehnten Bestätigungen. PayU sendet die Bestätigung nach jeder Fehlerantwort erneut.

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

Die Bestätigung antwortet Merchant mismatch: die Merchant ID der Bestätigung weicht von Merchant ID bzw. Sandbox merchant ID der Umgebung der Zahlung ab. Geben Sie die Merchant ID des PayU-Kontos ein, das die Zahlungen verarbeitet.

Die Bestätigung antwortet Gateway not configured: der API-Schlüssel oder die Merchant ID der Umgebung der Zahlung fehlt, zum Beispiel weil die Sandbox-Zugangsdaten entfernt wurden, während eine Sandbox-Zahlung ausstand. Geben Sie sie erneut ein; PayU wiederholt die Bestätigung.

Die Bestätigung antwortet Retry: der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. PayU sendet die Bestätigung erneut. Prüfen Sie das Log nach dem Grund.

Die Bestätigung antwortet Unknown reference: die Zahlungsreferenz wurde nicht von diesem Shop ausgestellt.

Die Bestätigungs-URL zeigt im Browser Method not allowed: das ist normal. Die URL akzeptiert nur Anfragen von PayU.

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

Die Bestellung ist im Prüfstatus: lesen Sie die Notizen auf der Registerkarte VibeFox PayU LATAM Payment. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung kam, nachdem die Bestellung storniert worden war. Prüfen Sie die Transaktion im PayU-Händlerpanel.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox PayU LATAM Payment auf Uninstall (der rote −-Button). 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 Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (auf OpenCart 4 werden seine Ereignisse und seine Startaktion entfernt, die Bestätigung und die Rückkehr des Kunden im Wartungsmodus durchlassen). Ist Delete data eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox, Zugangsdaten, Schalter des Debug-Logs) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungsversuche bleiben immer erhalten, sodass eine späte PayU-Bestätigung eines alten Versuchs auch nach einer Neuinstallation erkannt wird. 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 LATAM Payment in der Liste der installierten Erweiterungen auf Uninstall (den orangefarbenen −-Button) und danach auf Delete (den roten Papierkorb-Button), 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.