VibeFox Wompi 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: kolumbianischer Peso (COP). Wompi Colombia rechnet in COP ab. Fügen Sie COP unter System > Localisation > Currencies hinzu, falls Ihr Shop sie noch nicht hat; die Zahlungsmethode wird nur angeboten, wenn der Kunde in COP bezahlt. Die Einstellungsseite warnt Sie, wenn die Standardwährung des Shops nicht COP ist.

Wompi-Konto: ein Wompi-Colombia-Händlerkonto. Jede Umgebung (Sandbox und Produktion) hat vier Schlüssel: öffentlichen Schlüssel, privaten Schlüssel, Event-Geheimnis und Integritäts-Geheimnis. Sie finden sie im Wompi-Händlerportal (comercios.wompi.co) im Bereich für Entwickler. Wompi El Salvador und Panama verwenden andere APIs und werden nicht unterstützt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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 OpenCart-3-Paket wcp_wompi_payment-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_wompi_payment.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_wompi_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 Wompi Payment und klicken Sie auf Install (der grüne +-Button). Ihr Admin-Benutzer benötigt 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 in das Feld License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Fügen Sie die Schlüssel für Sandbox und Produktion aus dem Wompi-Händlerportal ein und legen Sie in Wompi die Events URL fest (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung im Sandbox-Modus und deaktivieren Sie dann Sandbox mode, um 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_wompi_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 Wompi Payment, klicken Sie auf Install (der grüne +-Button) und dann auf Edit (der Stift-Button).

4. Geben Sie den Lizenzschlüssel, die Wompi-Schlüssel und die Events URL ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Events URL ist anders (siehe Events URL).

Nach einer Neuinstallation ist die Zahlungsmethode zunächst deaktiviert und der Sandbox-Modus aktiviert.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox Wompi Payment > Edit. Die Abschnitte sind links aufgelistet; der Button Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt ein Statusfeld den aktuellen Modus, SANDBOX oder PRODUCTION. Fehlt ein Schlüssel dieses Modus, listet das Feld ihn auf und weist darauf hin, dass die Zahlungsmethode an der Kasse ausgeblendet bleibt, bis alle Schlüssel dieser Umgebung eingetragen sind. Sind alle Schlüssel eingetragen, zeigt es an, ob echte Zahlungen belastet werden. Beim Speichern warnt Sie die Erweiterung, wenn ein Schlüssel nicht mit dem Präfix seines Abschnitts beginnt, und wenn Wompi aktiviert, aber an der Kasse wegen fehlender Schlüssel ausgeblendet ist. Title darf höchstens 128 Zeichen lang sein (Title must be at most 128 characters.), Sort Order muss eine ganze Zahl sein (Sort Order must be a whole number.), Total muss eine Zahl sein, 0 oder größer (Total: enter a number, 0 or greater.), und die gewählte Geo-Zone und die Bestellstatus müssen vorhanden sein; andernfalls wird nichts gespeichert und die Seite zeigt den Fehler an. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Wompi

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

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Zahlungsmethode in der Bestellung gespeichert. Standard: Wompi. Höchstens 128 Zeichen. Wenn Sie das Feld leer lassen, wird der Name der Erweiterung verwendet.

Description: der Text, den der Kunde im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche sieht. Standard: Pay securely with Wompi: cards, PSE, Nequi, Bancolombia and more.

Sort Order: die Position von Wompi unter den Zahlungsmethoden an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein; negative Zahlen sind erlaubt.

Geo Zone: bietet Wompi nur für Zahlungsadressen in der gewählten Geo-Zone an. Standard: All zones. Geo-Zonen werden unter System > Localisation > Geo Zones eingerichtet. Auf OpenCart 4 wird, wenn die Kasse keine Zahlungsadresse hat, die Lieferadresse geprüft.

Total: die Kassensumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Wompi angeboten wird: eine Zahl, 0 oder größer. Lassen Sie das Feld leer, um Wompi für jede Summe anzubieten. Wompi selbst benötigt mindestens COP 1,500.

Wompi-Konto

Kopieren Sie die Schlüssel aus dem Wompi-Händlerportal (comercios.wompi.co), Bereich für Entwickler. Jede Umgebung hat einen eigenen öffentlichen Schlüssel, privaten Schlüssel, Event-Geheimnis und Integritäts-Geheimnis.

Sandbox mode: nutzt die Wompi-Sandbox (Sandbox-Schlüssel, kein echtes Geld). Es wechselt sowohl die Schlüssel als auch die Wompi-API (sandbox.wompi.co oder production.wompi.co). Zahlungsversuche behalten die Umgebung, in der sie gestartet wurden. Standard: an. Schalten Sie es aus, um echte Zahlungen anzunehmen. Solange es aktiviert ist, sehen Kunden im Schritt Confirm Order den Hinweis Sandbox mode: no real payment is made.

Sandbox-Schlüssel

Die vier Schlüssel der Wompi-Sandbox. Sie beginnen mit pub_test_, prv_test_, test_events_ und test_integrity_.

Public key: der öffentliche Sandbox-Schlüssel (pub_test_...). Er identifiziert Ihr Konto auf der Wompi Web Checkout.

Private key: der private Sandbox-Schlüssel (prv_test_...). Er wird verwendet, um Transaktionen über die Wompi-API abzurufen.

Events secret: das Sandbox-Event-Geheimnis (test_events_...). Es prüft die Signatur von Wompi-Ereignissen.

Integrity secret: das Sandbox-Integritäts-Geheimnis (test_integrity_...). Es signiert die an die Web Checkout gesendete Zahlungsanfrage.

Produktionsschlüssel

Die vier Schlüssel der Wompi-Produktionsumgebung. Sie beginnen mit pub_prod_, prv_prod_, prod_events_ und prod_integrity_.

Public key: der öffentliche Produktionsschlüssel (pub_prod_...).

Private key: der private Produktionsschlüssel (prv_prod_...).

Events secret: das Produktions-Event-Geheimnis (prod_events_...).

Integrity secret: das Produktions-Integritäts-Geheimnis (prod_integrity_...).

Öffentliche Schlüssel werden in ihren Feldern angezeigt. Gespeicherte private Schlüssel und Geheimnisse 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. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear saved secret on save und klicken Sie auf Save.

Events URL (Webhook)

Wompi-Ereignisse informieren Ihren Shop darüber, dass sich eine Transaktion geändert hat. Stellen Sie im Wompi-Händlerportal im Bereich für Entwickler die Events URL ein, die in diesem Abschnitt angezeigt wird, sowohl für die Sandbox als auch für die Produktion. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet und sieht auf OpenCart 3 etwa so aus: https://your-store/index.php?route=extension/payment/wcp_wompi_payment/webhook und auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_wompi_payment/payment/wcp_wompi_payment.webhook. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.

Die Erweiterung verwendet dieses Ereignis:

Andere Ereignisse werden mit Ignored beantwortet. Jedes Ereignis wird mit dem Event-Geheimnis seiner Umgebung (Sandbox oder Produktion) geprüft. Webhooks ohne gültige Signatur werden abgelehnt. Nach der Prüfung wird die Transaktion mit dem privaten Schlüssel dieser Umgebung von der Wompi-API abgerufen, und nur diese Daten werden verwendet. Ohne die Events URL erhält eine Bestellung ihren Status erst, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst einen Status, wenn Wompi die Transaktion meldet. Jedes Feld unten listet Ihre Bestellstatus in OpenCart auf.

Order Status After Payment: eine APPROVED-Transaktion mit dem erwarteten Betrag in COP. Standard: In Bearbeitung.

Awaiting Payment Status: eine PENDING-Transaktion, zum Beispiel PSE, Nequi oder eine Barzahlung, die auf Bestätigung wartet. Die Bestellung erhält Order Status After Payment, sobald Wompi sie genehmigt. Standard: Ausstehend.

On Hold (Review) Status: Wompi hat einen anderen Betrag oder eine andere Währung genehmigt als die Bestellsumme oder die Zahlung nach der Stornierung der Bestellung genehmigt. Eine Notiz erklärt dies; die Bestellung wird nicht als bezahlt markiert. Standard: Ausstehend, da OpenCart keinen Status On hold hat. Sie können eigene Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

Failed Payment Status: eine ausstehende Transaktion des letzten Zahlungsversuchs wurde abgelehnt oder endete mit einem Fehler. Standard: Fehlgeschlagen.

Cancelled Order Status: eine ausstehende Transaktion des letzten Zahlungsversuchs wurde in Wompi storniert. Eine für eine Bestellung in diesem Status genehmigte Zahlung setzt sie in den Prüfstatus, statt sie als bezahlt zu markieren. Standard: Storniert.

Erweitert

Debug log: schreibt Zahlungs- und Webhook-Aktivitäten in wompi_p_debug.log.php im Protokollordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler und Warnungen werden immer protokolliert, auch wenn diese Option aus ist. Schlüssel, Geheimnisse und Kundendaten werden nie protokolliert. 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 on uninstall: ist die Option aktiv, entfernt das Deinstallieren der Erweiterung ihre Einstellungen und das Protokoll. Bestellungen und die Wompi-Zahlungsversuche bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Private Schlüssel und Geheimnisse werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsmethode (standardmäßig Wompi). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung einen Zahlungsversuch mit einer eigenen Referenz (OC-, der Bestellnummer und einem Zeitstempel), signiert ihn mit dem Integritäts-Geheimnis und leitet den Kunden mit dem Bestellbetrag in COP zur Wompi Web Checkout weiter. Die E-Mail-Adresse des Kunden und der Name der Zahlungsadresse werden an Wompi übergeben. 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. Hat die Kasse keine Zahlungsadresse, wird der Name aus der Bestellung oder der Lieferadresse übernommen.

Auf der Wompi-Seite bezahlt der Kunde mit einer beliebigen Zahlungsmethode, die in Ihrem Wompi-Konto aktiviert ist. Danach leitet Wompi den Kunden zu Ihrem Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Wompi die Zahlung bestätigt: durch ein signiertes Ereignis oder durch eine serverseitige Anfrage an die Wompi-API, wenn der Kunde zurückkehrt. Die Transaktionsnummer in der Rücksprung-Adresse selbst wird nicht als vertrauenswürdig behandelt; akzeptiert werden nur Transaktionen, die für diese Bestellung in der Umgebung ihres Versuchs erstellt wurden. Beim Neuladen der Seite wird die Transaktion höchstens alle 20 Sekunden erneut geprüft.

Ist die Transaktion genehmigt, 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 Bestellung in OpenCart. Bei einer ausstehenden Zahlung (zum Beispiel PSE, Nequi oder eine Barzahlung) zeigt die Seite Your Wompi payment is pending confirmation (for example PSE, Nequi or a cash payment). We will process the order as soon as Wompi confirms the payment. Bei einer Bestellung im Prüfstatus zeigt sie We have received your Wompi payment and are reviewing it. We will contact you if anything is needed. Wird eine ausstehende Zahlung später abgelehnt, zeigt die Seite Your Wompi payment was not approved. Please contact us. Wird sie storniert, zeigt die Seite Your Wompi payment was voided and this order was cancelled. Please contact us.

Hat Wompi die Transaktion bei der Rückkehr des Kunden noch nicht bestätigt, zeigt eine Seite We are waiting for Wompi to confirm your payment. You will receive an e-mail as soon as it is confirmed. mit den Schaltflächen Check again und Back to checkout. Das Wompi-Ereignis setzt den Bestellstatus, sobald es eintrifft.

Wird die Zahlung abgelehnt, bleibt die Bestellung ohne Status und der Warenkorb wird beibehalten. Der Kunde kehrt zur Kasse zurück mit Your Wompi payment was not approved (...). You can try again or choose another payment method. und dem von Wompi angegebenen Grund. Eine stornierte Zahlung zeigt Your Wompi payment was voided. You can try again or choose another payment method. Verlässt der Kunde die Web Checkout ohne zu bezahlen, lautet die Meldung Your Wompi payment was not completed. You can try again or choose another payment method. Jeder neue Versuch erhält eine neue Referenz. OpenCart legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an, ein Warenkorb wird jedoch nur einmal bezahlt: Sobald eine Bestellung des Warenkorbs bezahlt ist, auf Zahlung wartet oder im Prüfstatus ist, wird der Kunde zur Erfolgsseite geleitet, statt erneut zu bezahlen.

Auf OpenCart 4 werden diese Meldungen über der Kasse angezeigt. OpenCart 4 behält für die Kasse eine Bestellung und aktualisiert sie jedes Mal, wenn der Schritt Confirm Order angezeigt wird: Nach einer abgelehnten oder nicht abgeschlossenen Zahlung bezahlt der Kunde dieselbe Bestellung mit einem neuen Versuch. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel wurde ihre ausstehende PSE- oder Nequi-Zahlung später abgelehnt oder storniert oder Sie haben sie storniert), oder wurde der Warenkorb geändert, nachdem eine Zahlung begonnen hatte, verlässt die Bestellung die Kasse, und der Kunde sieht Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. Der nächste Confirm Order bezahlt den Warenkorb mit einer neuen Bestellung.

Die Zahlungsmethode wird nur angezeigt, wenn die Lizenz aktiv ist, alle vier Schlüssel des aktuellen Modus eingetragen sind, der Kunde in COP bezahlt und die Summe mindestens COP 1,500 beträgt. Kann die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche:

Die Events URL funktioniert auch, wenn der Shop im Wartungsmodus ist, da OpenCart Anfragen von Zahlungserweiterungen durchlässt. Auf OpenCart 4 lässt eine Startaktion der Erweiterung die Events URL und die Rückkehr des Kunden durch.

Die Erweiterung führt keine Erstattungen über OpenCart durch. Sie verfügt über keine gespeicherten Karten, keine Abonnements und keine Kartenfelder auf Ihrer Website: Alle Zahlungsdaten werden bei Wompi eingegeben.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Wompi weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt oder Wompi hat die Transaktion noch nicht gemeldet. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Awaiting Payment Status (Standard Ausstehend): Wompi meldet die Transaktion als ausstehend, zum Beispiel PSE, Nequi oder Barzahlungen, die auf Bestätigung warten. Die Bestellung wartet, bis Wompi sie genehmigt oder ablehnt. Nach der Genehmigung wechselt sie zu Order Status After Payment.

Order Status After Payment (Standard In Bearbeitung): die Transaktion wurde für den Bestellbetrag in COP genehmigt. Eine Notiz zeigt die Transaktion, den Typ der Zahlungsmethode (zum Beispiel CARD, PSE oder NEQUI), die Referenz, den Betrag und die Umgebung.

On Hold (Review) Status (Standard Ausstehend): Wompi hat einen anderen Betrag oder eine andere Währung als die Bestellsumme genehmigt (zum Beispiel wurde der Warenkorb nach Beginn der Zahlung geändert), oder die Zahlung wurde nach der Stornierung der Bestellung genehmigt. Die Bestellung wird nicht als bezahlt markiert. Die Notiz erklärt dies. Prüfen Sie die Zahlung im Wompi-Portal und erfüllen Sie die Bestellung oder erstatten Sie die Zahlung.

Failed Payment Status (Standard Fehlgeschlagen): eine ausstehende Transaktion des letzten Zahlungsversuchs wurde abgelehnt oder endete mit einem Fehler. Die Wompi-Meldung wird der Notiz hinzugefügt. Ergebnisse älterer Versuche ändern die Bestellung nicht.

Cancelled Order Status (Standard Storniert): eine ausstehende Transaktion des letzten Zahlungsversuchs wurde in Wompi storniert.

Ändert sich der Status einer Bestellung, die bereits einen Status hat (zum Beispiel von wartend zu bezahlt oder fehlgeschlagen), benachrichtigt OpenCart den Kunden. Trifft eine zweite genehmigte Zahlung für eine bereits bezahlte Bestellung oder für eine andere Bestellung eines bereits bezahlten Warenkorbs ein, wird die Bestellung nicht geändert. Eine Notiz bittet Sie, die doppelte Zahlung im Wompi-Portal zu erstatten. Wird die Zahlungstransaktion in Wompi storniert, bittet eine Notiz Sie, die Bestellung zu prüfen. Wiederholte Ereignisse und Rückkehrvorgänge erzeugen nie doppelte Notizen oder Zahlungen.

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

Registerkarte VibeFox Wompi Payment

Öffnen Sie unter Sales > Orders eine mit Wompi bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Wompi Payment die Reference, die Transaction ID, den Status (mit dem Wompi-Status), den Requested-Betrag, den Transaction amount, die Payment method, die Wompi message, ein Kennzeichen SANDBOX für Sandbox-Zahlungen, die Payment attempts des Warenkorbs, wenn es mehrere gab, und die Wompi notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen werden nicht aus OpenCart gesendet. Erstatten oder stornieren Sie die Zahlung im Wompi-Händlerportal und erfassen Sie die Erstattung anschließend manuell in OpenCart. Eine im Wompi-Portal vorgenommene Stornierung der Zahlungstransaktion wird der Bestellung als Notiz hinzugefügt. Produktretouren unter Sales > Returns zahlen über Wompi kein Geld zurück.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Wompi Payment ist der erste Block auf der Seite Extensions > Extensions > Payments > VibeFox Wompi 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 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, 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-wompi und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Admin-Benutzer mit dem Recht Modify für die Erweiterung ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wenn der Schlüssel nicht akzeptiert wird, 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. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, 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 Wompi 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), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop 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 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 durch Wompi-Ereignisse und Rückkehrvorgänge der Kunden bestätigt.

Wenn eine Lizenz abläuft, arbeitet die Erweiterung weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Dashboard des Admin-Bereichs oder die Seite Edit ö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. Beim Deinstallieren der Erweiterung werden immer der Lizenzschlüssel und der Lizenzstatus entfernt.

Fehlerbehebung

Wompi erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und alle vier Schlüssel des aktuellen Modus eingetragen sind (das Statusfeld der Einstellungsseite listet fehlende Schlüssel auf). Prüfen Sie außerdem, ob der Kunde in COP bezahlt und die Summe mindestens COP 1,500 beträgt. Prüfen Sie auch, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung die in den Einstellungen festgelegte Total erreicht.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: die Events URL funktioniert nicht. Prüfen Sie im Wompi-Portal, ob die Events URL für die verwendete Umgebung (Sandbox oder Produktion) eingetragen ist und genau der in den Einstellungen angezeigten entspricht. Prüfen Sie, ob das Event-Geheimnis dieser Umgebung im passenden Abschnitt steht. Die Bestellung erhält ihren Status auch dann, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Events URL answers Not configured: das Event-Geheimnis der Umgebung des Ereignisses ist leer. Fügen Sie es in die Einstellungen ein.

Events URL answers Invalid signature: das Event-Geheimnis gehört zu einer anderen Umgebung oder einem anderen Konto. Kopieren Sie es erneut aus dem Wompi-Portal.

Events URL answers Transaction lookup failed: die Wompi-API hat die Transaktion nicht zurückgegeben, zum Beispiel wegen eines falschen privaten Schlüssels oder eines Netzwerkproblems. Wompi sendet das Ereignis später erneut.

Events URL answers Retry: die Bestellung wurde im selben Moment von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Wompi sendet das Ereignis später erneut. Den Grund finden Sie im Feld Log.

Events URL answers Environment mismatch: eine Sandbox-Transaktion kam für einen Produktions-Zahlungsversuch oder umgekehrt. Sandbox-Zahlungen bestätigen nie Produktionsbestellungen.

Events URL answers Unknown reference: die Transaktionsreferenz sieht aus wie eine Referenz dieses Shops, wurde hier aber nie ausgestellt, zum Beispiel von einem anderen OpenCart-Shop auf demselben Wompi-Konto. Referenzen anderer Systeme werden mit Ignored: not an OpenCart reference beantwortet.

The Events URL shows Method not allowed in the browser: das ist normal. Die URL akzeptiert nur Anfragen von Wompi.

The key does not start with ... warning on save: ein Schlüssel wurde in den falschen Abschnitt eingefügt. Sandbox-Schlüssel beginnen mit pub_test_, prv_test_, test_events_ und test_integrity_, Produktionsschlüssel mit pub_prod_, prv_prod_, prod_events_ und prod_integrity_.

Order is in the review status: lesen Sie die Notizen auf der Registerkarte VibeFox Wompi Payment (siehe Bestellstatus) und erfüllen Sie danach die Bestellung oder erstatten Sie die Zahlung im Wompi-Portal.

Other errors: sehen Sie im Feld Log auf der Erweiterungsseite und bei den Wompi notes der Bestellung nach. Fehler werden immer protokolliert. Aktivieren Sie Debug log für mehr Details.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Wompi Payment auf Uninstall (der rote −-Button). 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 aus dem Abschnitt Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (auf OpenCart 4 auch seine Startaktion, die im Wartungsmodus die Events URL durchlässt). Ist Delete data on uninstall aktiv, werden die übrigen Einstellungen (Titel, Beschreibung, Sandbox-Modus, Schlüssel, Protokollierung) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Wompi-Zahlungsversuche bleiben immer erhalten, sodass ein verspätetes Ereignis einer alten Zahlung auch nach einer Neuinstallation erkannt wird. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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