VibeFox dLocal 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.

dLocal-Go-Konto: Sie benötigen den API-Schlüssel und das API-Secret Ihres dLocal-Go-Kontos, von der Seite Payment integration im dLocal-Go-Dashboard: dashboard-sbx.dlocalgo.com für die Sandbox, dashboard.dlocalgo.com für den Produktivbetrieb. Sandbox und Produktivbetrieb verwenden unterschiedliche Zugangsdaten. Die Erweiterung funktioniert nur mit dLocal Go, nicht mit der Enterprise-API von dLocal Payments.

Währungen und Länder: Die Erweiterung begrenzt sie nicht. dLocal Go entscheidet anhand Ihres dLocal-Go-Kontos, welche Zahlungsmethoden für das Land des Kunden und die Bestellwährung angeboten werden.

Erreichbarer Shop: dLocal Go sendet Zahlungs- und Erstattungsbenachrichtigungen von eigenen Servern aus, daher müssen die Benachrichtigungs-URLs über HTTPS aus dem Internet erreichbar sein.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer 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_dlocal_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_dlocal_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_dlocal_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 dLocal Payment und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (die Stift-Schaltfläche), 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 den API-Schlüssel und das API-Secret für die Sandbox sowie für echte Zahlungen für den Produktivbetrieb ein. Wählen Sie das Environment (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Führen Sie eine Testzahlung in der Sandbox durch und stellen Sie danach Environment auf Production um.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_dlocal_payment.ocmod.zip aus. 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 dLocal Payment, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die dLocal-Go-Zugangsdaten ein und testen Sie die Zahlung wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URLs sind anders (siehe Notifications (IPN)).

Im dLocal-Go-Dashboard muss nichts eingerichtet werden: Die Benachrichtigungs- und Rückgabe-URLs werden bei jeder Zahlung und jeder Erstattung übermittelt. Eine neue Installation startet mit deaktivierter Zahlungsmethode und ausgewählter Sandbox.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox dLocal Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Solange der API-Schlüssel und das Secret der ausgewählten Umgebung nicht eingegeben sind, warnt Sie die Seite, dass die Zahlungsmethode an der Kasse ausgeblendet wird, zum Beispiel: Geben Sie den API-Schlüssel und das Secret der Sandbox ein: Bis dahin wird die Zahlungsmethode an der Kasse ausgeblendet. Ist die Sandbox ausgewählt und die Zahlungsmethode aktiviert, wird Der Sandbox-Modus ist aktiv: Zahlungen werden simuliert, es wird kein Geld abgebucht. angezeigt. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein oder mehr als 128 Zeichen haben, Sort Order muss eine ganze Zahl sein, Total eine Zahl von 0 oder mehr, und die Geo Zone sowie die Bestellstatus müssen vorhanden sein. Andernfalls wird nichts gespeichert und die Seite zeigt den Fehler an. Ist die Zahlungsmethode ohne Schlüssel und Secret der ausgewählten Umgebung aktiviert, werden die Einstellungen mit der oben genannten Warnung gespeichert.

dLocal Go

Enable/Disable: Enable dLocal Go schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: dLocal Go. Pflichtfeld.

Description: der Text, den Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche sehen. Standard: Bezahlen Sie mit lokalen Karten, per Banküberweisung oder bar über dLocal Go.

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

Geo Zone: bietet dLocal Go nur für Zahlungsadressen in der ausgewählten Geo Zone an. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Warenkorbbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor dLocal Go angeboten wird. Lassen Sie das Feld leer, um dLocal Go für jeden Betrag anzubieten.

API-Zugangsdaten

Kopieren Sie den API-Schlüssel und das API-Secret aus dem dLocal-Go-Dashboard, Payment integration: dashboard-sbx.dlocalgo.com (Sandbox) oder dashboard.dlocalgo.com (Produktivbetrieb). Der Abschnitt verlinkt beide Dashboards.

Environment: welche Zugangsdaten und welche dLocal-Go-Server für neue Zahlungen verwendet werden.

Erstattungen und Benachrichtigungen zu einer Zahlung verwenden immer die Zugangsdaten der Umgebung, in der sie gemacht wurde. Bewahren Sie daher die Zugangsdaten der anderen Umgebung auf, solange deren Zahlungen noch offen sind oder erstattet werden können.

Sandbox API Key: Ihr API-Schlüssel der dLocal-Go-Sandbox.

Sandbox API Secret: Ihr API-Secret der dLocal-Go-Sandbox.

Production API Key: Ihr API-Schlüssel für den Produktivbetrieb bei dLocal Go.

Production API Secret: Ihr API-Secret für den Produktivbetrieb bei dLocal Go.

Gespeicherte Schlüssel und Secrets werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert — leer lassen, um es zu behalten. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value und klicken Sie auf Save.

Zahlung

Default country: dLocal Go zeigt die Zahlungsmethoden des Landes des Kunden, das aus der Zahlungsadresse entnommen wird, sonst aus der Lieferadresse. Dieses Land wird verwendet, wenn die Bestellung keines von beiden hat. Die Liste zeigt die Länder Ihres Shops. Standard: Uruguay.

Auto-complete orders: gibt bezahlten Bestellungen den Complete Order Status statt des Paid Order Status. Standard: aus.

Notifications (IPN): Die Benachrichtigungen informieren Ihren Shop darüber, dass sich eine Zahlung oder eine Erstattung geändert hat. Die Erweiterung sendet die Benachrichtigungs-URLs bei jeder Zahlung und jeder Erstattung an dLocal Go, daher muss im dLocal-Go-Dashboard nichts konfiguriert werden. Dieses Feld zeigt beide URLs, aufgebaut aus der Shop-Adresse Ihrer OpenCart-Installation:

Benachrichtigungen werden mit Ihrem API-Secret (HMAC-SHA256) geprüft. Benachrichtigungen ohne gültige Signatur werden abgelehnt. Eine Benachrichtigung muss mit den Zugangsdaten der Umgebung signiert sein, in der die Zahlung getätigt wurde. Danach werden Status, Betrag und Währung der Zahlung immer erneut über die dLocal-Go-API abgefragt; dem Inhalt der Benachrichtigung wird nicht vertraut. Ohne Benachrichtigungen erhält eine Bestellung ihren Status erst, wenn der Kunde in den Shop zurückkehrt.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn dLocal Go die Zahlung bestätigt hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Paid Order Status: der Bestellstatus nach einer bestätigten Zahlung. Standard: In Bearbeitung.

Complete Order Status: der Bestellstatus nach einer bestätigten Zahlung, wenn Auto-complete orders aktiviert ist. Standard: Abgeschlossen.

On Hold (Review) Status: Zahlungen, deren Betrag oder Währung nicht zur Bestellung passt oder die nach dem Stornieren der Bestellung eingehen, erhalten diesen Status und eine Notiz mit der Begründung. Standard: Ausstehend, weil OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Refunded Status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: schreibt dLocal-Go-Anfragen und Benachrichtigungen in dlocal_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden, und bei 5 MB wird sie in eine Sicherungsdatei verschoben. API-Zugangsdaten und personenbezogene Daten werden nicht protokolliert. Fehler und Warnungen werden immer geschrieben; die übrigen Einträge nur, solange diese Option aktiv ist. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Logs. Klicken Sie auf Clear log, um es zu leeren.

Delete data on uninstall: Ist die Option aktiv, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Log. Die Zahlungsdaten der Bestellungen (dLocal-Zahlungen und -Erstattungen) bleiben immer erhalten, damit bestehende Bestellungen weiter funktionieren. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig dLocal Go). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis Sie werden zur Kassenseite von dLocal Go weitergeleitet. Im Sandbox-Modus wird außerdem Sandbox-Modus: Es wird keine echte Zahlung getätigt. angezeigt. OpenCart erstellt die Bestellung in diesem Schritt, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine dLocal-Go-Zahlung für den Bestellbetrag in der Bestellwährung, mit Land, Name, E-Mail-Adresse und Telefonnummer des Kunden, und leitet den Kunden zur Zahlungsseite von dLocal Go weiter. Dort bezahlt der Kunde mit einer Methode seines Landes. Auf der dLocal-Go-Seite erscheint die Zahlung als Order # mit der Bestellnummer. Bei OpenCart 4 wählt der Kunde die Zahlungsmethode mit der Schaltfläche Choose des Zahlungsmethodenblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Fordert der Shop keine Zahlungsadresse an (Standard bei OpenCart 4), werden das Land der Lieferadresse und der Name des Kunden verwendet.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn dLocal Go die Zahlung bestätigt hat: durch die signierte Benachrichtigung oder durch eine serverseitige Anfrage an die dLocal-Go-API, wenn der Kunde zurückkehrt. Die Rückgabe-Adresse enthält ein zufälliges Token des Zahlungsversuchs. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your payment with dLocal Go has been received. Wurde die Bestellung in den Prüfstatus gesetzt, zeigt die Seite Your dLocal Go payment has been received and is being reviewed by the store. You will be informed when your order is confirmed. Hat dLocal Go die Zahlung noch nicht bestätigt (zum Beispiel ein noch nicht bezahlter Barcode-Gutschein oder dLocal Go war nicht erreichbar), bittet eine Seite Payment confirmation den Kunden, nicht erneut zu zahlen, und bietet Check again und Back to checkout an. Die Bestellung erhält ihren Status, sobald dLocal Go die Zahlung bestätigt. Bei OpenCart 4 sendet der Browser die Shop-Sitzung nicht mit, wenn dLocal Go den Kunden zurückschickt. Daher zeigt die Erweiterung zuerst eine kurze Seite, die dieselbe Rückkehradresse erneut von Ihrem Shop aus öffnet: Der Kunde behält Warenkorb und Anmeldung.

Verlässt der Kunde die Seite von dLocal Go, ohne zu zahlen, kehrt er zur Kasse zurück und sieht Die Zahlung bei dLocal Go wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen. Wurde die Zahlung abgelehnt oder ist sie abgelaufen, lautet die Meldung Ihre dLocal-Zahlung wurde nicht abgeschlossen: Sie wurde abgelehnt oder ist abgelaufen. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsmethode. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. Jeder Klick auf Confirm Order erstellt eine neue dLocal-Go-Zahlung. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie, daher gehört die neue Zahlung zur selben Bestellung. Ein älterer Zahlungslink kann weiterhin bezahlt werden und bestätigt dann seine Bestellung. Bevor eine neue Zahlung beginnt, werden die offenen Zahlungen derselben Bestellung und derselben Kundensitzung (letzte 24 Stunden) bei dLocal Go abgefragt: Ist eine davon bezahlt, wird ihre Bestellung bestätigt und der Kunde gelangt zur Erfolgsseite, ohne eine zweite Zahlung leisten zu müssen.

Bei OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel storniert oder erstattet), schickt Confirm Order oder die Rückkehr von dLocal Go den Kunden mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zurück zur Kasse, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung des Warenkorbs.

Kann dLocal Go die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel dLocal could not start the payment: gefolgt vom Grund, den dLocal nennt. Das passiert auch, wenn das Land des Kunden und die Bestellwährung in Ihrem dLocal-Go-Konto nicht freigeschaltet sind. Lehnt dLocal Go Ihre Zugangsdaten ab, sieht der Kunde This payment method is temporarily unavailable. Please choose another payment method or contact us. Der technische Grund wird im Log festgehalten.

Die Benachrichtigungen funktionieren auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und bei OpenCart 4 fügt die Erweiterung eine Startaktion hinzu, die die Benachrichtigungen und die Rückkehr des Kunden durchlässt.

Die Erweiterung verarbeitet nur einmalige Zahlungen auf der Seite von dLocal Go. Sie hat kein Kartenformular in Ihrem Shop, keine gespeicherten Karten, keine Abonnements und keine getrennte Autorisierung und Erfassung.

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu dLocal Go weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt oder ist abgelaufen, oder sie ist bei dLocal Go noch ausstehend. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Paid Order Status (Standard In Bearbeitung) oder Complete Order Status (Standard Abgeschlossen): Die Zahlung wurde bestätigt. Die Bestellung erhält den Complete Order Status, wenn Auto-complete orders aktiv ist. Eine Notiz zeigt die Umgebung und die dLocal-Zahlungs-ID.

On Hold (Review) Status (Standard Ausstehend): dLocal Go hat einen anderen Betrag oder eine andere Währung als die Bestellsumme gemeldet, oder die Zahlung ist nach dem Stornieren der Bestellung eingegangen. Die Notiz erklärt es. Vergleichen Sie mit dem dLocal-Go-Dashboard und versenden Sie die Bestellung oder erstatten Sie die Zahlung.

Refunded Status (Standard Erstattet): Die Zahlung wurde über die Erweiterung vollständig erstattet.

Eine abgelehnte, abgelaufene oder stornierte Zahlung ändert nie eine Bestellung, die bereits einen Status hat. Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, die doppelte Zahlung im dLocal-Go-Dashboard zu erstatten. Dieselbe Art von Notiz wird der bezahlten Bestellung hinzugefügt, wenn derselbe Warenkorb (gleiche Kundensitzung und gleicher Warenkorbinhalt) mit einer anderen Bestellung erneut bezahlt wurde, zum Beispiel in einem zweiten Browser-Tab; diese andere Bestellung erhält keinen Status.

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

Registerkarte VibeFox dLocal Payment

Öffnen Sie unter Sales > Orders eine Bestellung, die mit dLocal Go bezahlt wurde. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox dLocal Payment die Payment ID, die Environment (Sandbox oder Produktivbetrieb), den ZahlungsStatus, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die dLocal Go notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox dLocal Payment den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via dLocal Go. Bestätigen Sie die Frage Refund this amount through dLocal Go? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die dLocal Go belastet hat; nach einer Abweichung bei Betrag oder Währung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht die Bestellsumme. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung getätigt wurde, mit deren Zugangsdaten. Akzeptiert dLocal Go die Erstattung nicht, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. Eine akzeptierte Erstattung wird mit Erstattungs-ID, Status und Grund dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie eine manuelle Statusänderung. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald dLocal Go die Zahlung bestätigt hat.

Anschließend meldet dLocal Go den endgültigen Erstattungsstatus über die Erstattungsbenachrichtigung, und er wird den Notizen hinzugefügt. Lehnt oder storniert dLocal Go später eine Erstattung, die es zuvor akzeptiert hatte, warnt die Notiz, dass das Geld nicht an den Kunden zurückgegeben wurde. Erstatten Sie dem Kunden erneut oder auf andere Weise.

Produktrücksendungen unter Sales > Returns senden kein Geld über dLocal Go zurück. Im dLocal-Go-Dashboard vorgenommene Erstattungen werden in OpenCart nicht als Erstattungen erfasst. Aktualisieren Sie die Bestellung bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox dLocal Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox dLocal Payment > 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 aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-dlocal und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung 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, 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 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 auf einer Domain: der 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 dLocal Go Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde Diese Zahlungsmethode ist nicht verfügbar. Bitte wählen Sie eine andere. 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), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsmethode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admin-Bereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Aktualisierungen 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 Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

dLocal Go erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der API-Schlüssel sowie das API-Secret der ausgewählten Environment gesetzt sind. Die Einstellungsseite zeigt eine Warnung, wenn sie fehlen. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: dLocal Go konnte die Benachrichtigungs-URL nicht erreichen (Firewall, Basisauthentifizierung, keine öffentliche HTTPS-Adresse), und der Kunde ist nicht in den Shop zurückgekehrt. Aktivieren Sie Debug log, sehen Sie im Feld Log nach und prüfen Sie die Zahlung im dLocal-Go-Dashboard. Sobald eine Benachrichtigung eintrifft oder der Kunde auf Check again klickt, erhält die Bestellung ihren Status.

Die Benachrichtigung antwortet Missing signature oder Invalid signature: Der API-Schlüssel und das Secret in den Einstellungen gehören nicht zu dem Konto, das die Benachrichtigung gesendet hat. Benachrichtigungen werden mit den Zugangsdaten der Umgebung der Zahlung geprüft, daher werden Zahlungen, die vor dem Umstellen von Environment gestartet wurden, weiterhin bestätigt, solange die Zugangsdaten ihrer Umgebung in den Einstellungen bleiben.

Die Benachrichtigung antwortet Gateway not configured: Die Zugangsdaten der Umgebung der Zahlung fehlen. Geben Sie sie ein; dLocal Go wiederholt die Benachrichtigung.

Die Benachrichtigung antwortet API verification failed: Die dLocal-Go-API konnte nicht erreicht werden, um die Zahlung zu lesen. dLocal Go wiederholt die Benachrichtigung.

Die Benachrichtigung antwortet Temporarily unavailable: Die Bestellung wurde gerade von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. dLocal Go wiederholt die Benachrichtigung. Der Grund steht im Log.

Die Benachrichtigung antwortet Order not found: Die Zahlung gehört zu keiner Bestellung dieses Shops, zum Beispiel weil sie von einer anderen Website mit demselben dLocal-Go-Konto erstellt wurde.

Der Kunde sieht This payment method is temporarily unavailable: dLocal Go hat den API-Schlüssel oder das API-Secret abgelehnt. Prüfen Sie die Zugangsdaten der ausgewählten Umgebung.

Der Kunde sieht Payment gateway is not properly configured: Die Zugangsdaten der ausgewählten Umgebung fehlen.

Die Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die Notizen auf der Registerkarte VibeFox dLocal Payment. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung kam nach dem Stornieren der Bestellung an. Versenden Sie die Bestellung oder erstatten Sie die Zahlung.

Kein Erstattungsformular auf der Registerkarte: Die Registerkarte nennt den Grund: Die Zahlung ist noch nicht bestätigt, sie ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern, oder die Zugangsdaten der Zahlungsumgebung fehlen.

Die Erstattung schlägt mit einer Meldung über fehlende Zugangsdaten fehl: Die Zahlung wurde in der anderen Umgebung getätigt, und deren Zugangsdaten sind nicht gesetzt. Geben Sie sie ein und versuchen Sie es erneut.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse dlocal_p_payment_data (die Zahlungsanfrage und die Bestellung, bevor die Zahlung erstellt wird) und dlocal_p_currency_decimals (die Nachkommastellen einer Währung) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox dLocal Payment auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 zusätzlich dessen Ereignisse und die Startaktion, die dLocal Go im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiv, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Umgebung, Zugangsdaten, Standardland, Auto-Abschluss, Protokollierung) und das Log entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die dLocal-Zahlungen und -Erstattungen der Bestellungen bleiben immer erhalten, sodass zuvor bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um bei OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox dLocal Payment auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

dLocal ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit dLocal verbunden und wird von dLocal nicht unterstützt.