VibeFox PayU LATAM for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

Währung: Der Warenkorb muss in ARS, BRL, CLP, COP, MXN, PEN oder USD sein, den 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 Händler-ID, die Konto-ID des Landes, in dem Sie verkaufen, und den API-Schlüssel. Sie finden sie im PayU-Modul (dem PayU-Händlerportal) unter Settings > Technical configuration (merchant ID, API key) und Accounts (account ID). Für Tests veröffentlicht PayU öffentliche Sandbox-Zugangsdaten und Testkarten auf der Seite „Test your solution“ seiner Entwicklerdokumentation. Der API Login und andere API-Zugangsdaten werden nicht benötigt, denn die Zahlung erfolgt auf der gehosteten PayU-Seite und das Modul ruft die PayU-API nie auf.

Erreichbarkeit Ihres Shops aus dem Internet: PayU sendet das Zahlungsergebnis von seinen Servern an Ihren Shop. Deshalb muss der Shop aus dem Internet erreichbar sein (nicht als lokale Seite und nicht hinter einem Passwortschutz).

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel gilt für eine Domain.

Installation

1. Gehen Sie im Back-Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox PayU LATAM Payment in der Modulliste und klicken Sie dort auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure 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 eingerichtet 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 dann aus, um echte Zahlungen mit den Live-Zugangsdaten anzunehmen.

Bei der Installation legt das Modul zwei Bestellstatus an: Awaiting PayU LATAM payment und PayU LATAM payment on hold. PrestaShop bietet eine neue Zahlungsmethode für alle Währungen, Länder und Kundengruppen an. Sie können sie unter Payment > Preferences einschränken. Ein später aktiviertes Land muss dort ebenfalls für das Modul angehakt werden.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox PayU LATAM Payment > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Oberhalb der Felder zeigt die Seite Sandbox mode. Payments go to the PayU sandbox and no real money is charged. an, solange die Sandbox aktiv ist, einen Fehler, wenn Händler-ID, Konto-ID oder API-Schlüssel der aktuellen Umgebung fehlen, und eine Warnung, wenn PayU LATAM die Standardwährung des Shops nicht verarbeitet. Solange Zugangsdaten fehlen, wird PayU LATAM an der Kasse nicht angezeigt. Leerzeichen am Anfang oder Ende eines Zugangsdatums werden ignoriert. Die Seite speichert keinen leeren Title und zeigt Enter a title for the payment method. an.

PayU LATAM

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

Title: der Titel der Zahlungsmethode, der dem Kunden an der Kasse angezeigt wird. Er ist auch der Name der Zahlungsmethode, der in der Bestellung gespeichert wird. Standard: PayU LATAM. Pflichtfeld.

Description: die Beschreibung der Zahlungsmethode, die dem Kunden an der Kasse angezeigt wird. 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: Zahlungen gehen mit den unten eingetragenen Sandbox-Zugangsdaten an die PayU-Sandbox, und es wird kein echtes Geld abgebucht. Ist sie deaktiviert, werden die Live-Zugangsdaten und die Live-Zahlungsseite von PayU verwendet. Standard: an. Solange sie aktiv ist, sehen Kunden unter der Zahlungsmethode Sandbox mode: no real money is charged.

Live-Zugangsdaten

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

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“ 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.

Gespeicherte API-Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Clear saved secrets: Markieren Sie API Key oder Sandbox API key und klicken Sie auf Save, um den gespeicherten Schlüssel zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

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 Bestätigung einer Live-Zahlung mit den Live-Werten. Ausstehende Zahlungen funktionieren deshalb auch nach dem Umschalten weiter. Eine nach dem Umschalten bestätigte Sandbox-Zahlung wird in den Bestellnotizen mit [sandbox] markiert.

Bestätigungs-URL

Dieser Abschnitt zeigt die URL, an die PayU jedes Zahlungsergebnis meldet. Mit suchmaschinenfreundlichen URLs sieht sie so aus: https://your-shop/module/wcp_payu_latam_payment/confirmation, eventuell mit einem Sprachcode wie /en/. Das Modul sendet sie bei jeder Zahlung an PayU, daher muss in PayU nichts eingerichtet werden. Die URL muss aus dem Internet erreichbar sein. Sie funktioniert auch, während der Shop im Wartungsmodus ist, und wird nicht durch die Ländereinschränkung Ihres Shops blockiert. 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 ausgestellt hat, werden abgelehnt. Das Modul verarbeitet diese PayU-Transaktionsstatus:

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

6 (declined), 5 (expired), 104 (error): Die Zahlung ist fehlgeschlagen. Es wird keine Bestellung angelegt und der Warenkorb bleibt erhalten.

7, 10, 12, 14, 15, 18 (pending): Die Zahlung wartet, zum Beispiel eine Bar- oder Banküberweisung, die der Kunde noch nicht abgeschlossen hat. Die Bestellung wird in Awaiting PayU LATAM payment angelegt.

Andere Status werden nur als Notiz hinzugefügt. Ohne Bestätigung wird keine Bestellung angelegt.

Erweitert

Debug log: protokolliert Zahlungsanfragen und PayU-Benachrichtigungen in logs/payu_lp_debug.log.php im Modulordner. Die Datei kann nicht über den Browser geöffnet werden. 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: löscht die Einstellungen und Protokolle bei der Deinstallation des Moduls. PayU-Daten der Bestellungen (Zahlungsversuche) und die Bestellstatus bleiben erhalten. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig PayU LATAM) und bestätigt. Eine Seite Ihres Shops zeigt You are being redirected to PayU LATAM to complete the payment... und sendet automatisch ein signiertes Formular an die PayU-WebCheckout-Seite. Passiert das nicht, klickt der Kunde auf Pay with PayU LATAM oder auf Back to checkout, um zurückzukehren. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Das Formular enthält Gesamtbetrag und Währung des Warenkorbs, Steuer und Steuerbasis des Warenkorbs (beide 0 bei Warenkörben ohne Steuer, damit PayU keine Standard-Mehrwertsteuer hinzufügt), die Beschreibung Cart # mit der Warenkorbnummer 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 Warenkorbs. Auf der PayU-Seite zahlt der Kunde mit einer beliebigen in Ihrem PayU-Konto aktivierten Methode.

Jeder Aufruf der Zahlungsseite startet einen neuen Zahlungsversuch mit eigener Referenz (PS, der Warenkorbnummer und einem Zeitstempel). Ältere Versuche bleiben gespeichert: Bezahlt der Kunde in einem älteren PayU-Tab, wird die Zahlung trotzdem angenommen.

Die Bestellung wird erst als bezahlt markiert, wenn PayU die signierte Bestätigung sendet. Ein Kunde, der von PayU zurückkehrt, markiert eine Bestellung niemals als bezahlt. Wenn der Kunde zurückkehrt:

Nach einer signierten Ablehnung, einem Ablauf oder Fehler: Der Kunde kehrt zur Kasse zurück, 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 kehrt zur Kasse zurück, mit Your PayU LATAM payment was not completed. You can try again or choose another payment method.

Die Bestellung existiert bereits: Der Kunde sieht die übliche Bestellbestätigungsseite. Bei einer Bestellung in Awaiting PayU LATAM payment steht dort 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 zur Prüfung zurückgestellten Bestellung steht dort We have received your PayU LATAM payment and are reviewing it. We will contact you if anything is needed. Bei einer Bestellung im Status Payment error steht dort Your PayU LATAM payment was not approved. Please contact us.

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 Wartetext bei einer Bar- oder Banküberweisung) mit einer Schaltfläche Check again. Die Bestätigung legt die Bestellung an, sobald sie eintrifft.

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 Warenkorbwährung lautet die Meldung PayU LATAM does not accept payments in, gefolgt von der Währung. Ein Warenkorb, der bereits eine Bestellung hat, wird nicht erneut bezahlt: Der Kunde wird zur Bestellbestätigungsseite geleitet.

Das Modul hat kein Zahlungsformular in Ihrem Shop, keine Erstattungen über PrestaShop, keine gespeicherten Karten, keine Abonnements und keine Einstellungen für Ratenzahlung (PayU zeigt Raten auf seiner Seite an). Es fragt den Zahlungsstatus nicht bei der PayU-API ab: Nur die signierte Bestätigung aktualisiert die Bestellung.

Bestellungen

Bestellstatus

No order yet: Der Kunde wurde zu PayU weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt, oder PayU hat die Bestätigung noch nicht gesendet. Es existiert nur der Warenkorb.

Payment accepted: PayU hat die Zahlung bestätigt, und Betrag und Währung stimmen überein. Die Zahlung wird mit der PayU-Transaktions-ID erfasst; eine Notiz zeigt Transaktion, Betrag, Zahlungsmethode und bei Sandbox-Zahlungen [sandbox].

Awaiting PayU LATAM payment: PayU meldet die Zahlung als ausstehend (Bar- oder Banküberweisung). Die Bestellung wechselt zu Payment accepted, sobald PayU die Zahlung bestätigt.

PayU LATAM payment on hold: Der gezahlte Betrag oder die Währung entspricht nicht der Warenkorbsumme, oder eine Zahlung wurde für eine stornierte Bestellung genehmigt. Die Zahlung wird erfasst, wenn sie in der Bestellwährung ist. Die Notiz sagt, welcher Fall vorliegt: Prüfen Sie die Zahlung im PayU-Modul und verarbeiten Sie dann die Bestellung, stellen Sie sie wieder her oder erstatten Sie die Zahlung.

Payment error: Eine ausstehende Zahlung des letzten Versuchs wurde später abgelehnt, lief ab oder endete mit einem Fehler. Die Notiz zeigt die PayU-Meldung. Dieser Warenkorb kann nicht erneut bezahlt werden: Der Kunde gibt eine neue Bestellung auf. Eine Ablehnung eines älteren Versuchs oder einer Bestellung, die bereits eine genehmigte Zahlung hat, wird nur als Notiz hinzugefügt.

Jede Benachrichtigung wird einmal unter einer Sperre pro Warenkorb verarbeitet: Wiederholte PayU-Benachrichtigungen erzeugen keine zweite Bestellung und fügen keine Notizen doppelt hinzu. Eine bezahlte Bestellung wird nie wieder geöffnet oder herabgestuft. Trifft für eine bereits bezahlte Bestellung eine weitere genehmigte Zahlung ein, weist eine Notiz darauf hin: Hat der Kunde doppelt bezahlt, erstatten Sie das Duplikat im PayU-Modul.

PayU LATAM-Zahlungsblock

Die Bestellseite zeigt einen Block PayU LATAM payment mit Referenz, Transaktions-ID, PayU-Referenz, Status und PayU-Status, dem angeforderten Betrag, dem von PayU gemeldeten Betrag, der Zahlungsmethode, der PayU-Meldung, einem SANDBOX-Badge für Sandbox-Zahlungen, der Liste aller Zahlungsversuche des Warenkorbs und den PayU LATAM notes der Bestellung.

Erstattungen

Erstattungen werden nicht über PrestaShop vorgenommen. Erstatten Sie die Transaktion im PayU-Modul und erfassen Sie die Erstattung danach manuell in PrestaShop.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox PayU LATAM Payment ist der erste Block unter Modules > Module Manager > VibeFox PayU LATAM Payment > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-payment-payu-latam und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back-Office (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. Nach einer Änderung der Shop-Adresse oder nachdem Sie einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Das Entfernen des Schlüssels aus dem Shop 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 trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Der Kundenbereich von PrestaShop erkennt nicht, dass Sie im Back-Office angemeldet sind, daher wird die Zahlungsmethode auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Ein Hinweis erscheint in Modules > Module Manager auf dem Reiter Alerts. 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 das Modul weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird während der Arbeit im Back-Office automatisch erneut geprüft: 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. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

PayU LATAM erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und Händler-ID, Konto-ID und API-Schlüssel der aktuellen Umgebung ausgefüllt sind: die Sandbox-Zugangsdaten, wenn Sandbox aktiv ist, die Live-Zugangsdaten, wenn es aus ist. Prüfen Sie, ob die Warenkorbwährung ARS, BRL, CLP, COP, MXN, PEN oder USD ist. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung ist durchgegangen, aber es wurde keine Bestellung angelegt: 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 (kein lokaler Shop, keine Firewall und kein Passwortschutz). Sehen Sie im Feld Log der Modulseite nach abgelehnten Bestätigungen. PayU sendet die Bestätigung nach jeder Fehlerantwort erneut.

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.

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

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

Bestätigung antwortet Retry: Der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet, oder die Bestellung konnte nicht angelegt werden (zum Beispiel weil das Modul deaktiviert ist). Es wurde nichts geändert, und PayU sendet die Bestätigung erneut. Sehen Sie im Log nach dem Grund.

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: Das Modul ist für Land, Währung oder Gruppe des Kunden unter Payment > Preferences nicht erlaubt, oder Enable/Disable ist aus.

Die Bestellung ist PayU LATAM payment on hold: Lesen Sie die Notizen im Block PayU LATAM payment. Der gezahlte Betrag oder die Währung wich vom Warenkorb ab, oder die Zahlung kam an, nachdem die Bestellung storniert worden war. Prüfen Sie die Transaktion im PayU-Modul.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox PayU LATAM Payment und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data aktiv, werden die Einstellungen und das Protokoll entfernt. Ist es aus, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Zahlungsversuche und die Bestellstatus Awaiting PayU LATAM payment und PayU LATAM payment on hold bleiben immer erhalten, damit eine späte PayU-Bestätigung eines alten Versuchs auch nach einer Neuinstallation erkannt wird. Bestehende Bestellungen behalten ihre Zahlungsnotizen, PayU-Referenzen und Transaktions-IDs.

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