VibeFox Wompi for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

Shop-Währung: kolumbianischer Peso (COP). Wompi Kolumbien rechnet in COP ab, und die Zahlungsmethode wird bei Bestellungen in anderen Währungen ausgeblendet.

Wompi-Konto: ein Wompi-Kolumbien-Händlerkonto. Jede Umgebung (Sandbox und Produktion) hat vier Schlüssel: öffentlicher Schlüssel, privater Schlüssel, Events-Secret und Integrity-Secret. Sie finden sie im Händler-Dashboard von Wompi (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

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

2. Klicken Sie auf Activate.

3. Stellen Sie die Shop-Währung unter WooCommerce > Settings > General auf kolumbianischen Peso (COP) ein.

4. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Wompi oder klicken Sie auf der Plugins-Seite unter dem Namen des Plugins auf Settings.

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

6. Fügen Sie die Sandbox- und Produktionsschlüssel aus dem Händler-Dashboard von Wompi ein und legen Sie die Events URL in Wompi fest (siehe Konfiguration).

7. Aktivieren Sie Enable/Disable. Testen Sie eine Zahlung im Sandbox-Modus und deaktivieren Sie danach Sandbox mode, um echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Wompi. Oberhalb der Felder 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 ist, bis alle Schlüssel dieser Umgebung eingetragen sind. Sind alle Schlüssel eingetragen, zeigt es an, ob echte Zahlungen belastet werden. Beim Speichern warnt das Plugin, wenn ein Schlüssel nicht mit dem Präfix seines Abschnitts beginnt, und wenn Wompi aktiviert, aber an der Kasse ausgeblendet ist, weil Schlüssel fehlen. In der Liste der Zahlungsmethoden ist Wompi als „Einrichtung erforderlich“ markiert, bis im aktuellen Modus alle vier Schlüssel eingetragen sind. Schlüssel aus Version 1.0 werden bei der Aktualisierung automatisch in den passenden Abschnitt Sandbox oder Production übernommen.

General

Enable/Disable: Enable Wompi aktiviert oder deaktiviert die Zahlungsmethode. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: Wompi.

Description: der Text, der an der Kasse unter der Zahlungsmethode angezeigt wird. Standard: Pay securely with Wompi: cards, PSE, Nequi, Bancolombia and more.

Wompi-Konto

Kopieren Sie die Schlüssel aus dem Händler-Dashboard von Wompi (comercios.wompi.co) im Bereich für Entwickler. Jede Umgebung hat einen eigenen öffentlichen Schlüssel, privaten Schlüssel, Events-Secret und Integrity-Secret.

Sandbox mode: Use the Wompi sandbox (sandbox keys, no real money). Damit werden sowohl die Schlüssel als auch die Wompi-API umgeschaltet (sandbox.wompi.co oder production.wompi.co). Bestellungen behalten die Umgebung, in der sie bezahlt wurden. Standard: aktiviert. Deaktivieren Sie die Option, um echte Zahlungen anzunehmen.

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 im Wompi Web Checkout.

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

Events secret: das Sandbox-Events-Secret (test_events_...). Es prüft die Signatur der Wompi-Ereignisse.

Integrity secret: das Sandbox-Integrity-Secret (test_integrity_...). Es signiert die an den 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-Events-Secret (prod_events_...).

Integrity secret: das Produktions-Integrity-Secret (prod_integrity_...).

Events URL (Webhook)

Wompi-Ereignisse informieren Ihren Shop darüber, dass sich eine Transaktion geändert hat. Setzen Sie im Händler-Dashboard von Wompi im Bereich für Entwickler die Events URL, die in diesem Abschnitt der Einstellungen angezeigt wird, sowohl für die Sandbox als auch für die Produktion. Sie sieht etwa so aus: https://your-site/wc-api/wompi_p/. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.

Das Plugin verwendet dieses Ereignis:

Andere Ereignisse werden mit Ignored beantwortet. Jedes Ereignis wird mit dem Events-Secret seiner Umgebung (Sandbox oder Produktion) geprüft. Ereignisse ohne gültige Signatur werden abgelehnt. Nach der Prüfung wird die Transaktion über die Wompi-API abgerufen, und nur diese Daten werden verwendet. Ohne die Events URL wird eine Bestellung erst bestätigt, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.

Erweitert

Debug log: Log payment and webhook activity schreibt Zahlungs- und Ereignisaktivitäten unter WooCommerce > Status > Logs, Quelle wcp_wompi_payment. Fehler werden immer protokolliert, auch wenn diese Option deaktiviert ist. Schlüssel, Secrets und Kundendaten werden nie protokolliert. Standard: aus.

Delete data on uninstall: Remove the plugin settings and logs when the plugin is deleted. Deaktivieren des Plugins löscht nie etwas. Bestelldaten bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Wompi) und gibt die Bestellung auf. Im Sandbox-Modus zeigt die Kasse unter der Beschreibung Sandbox mode: no real payment is made. an. Das Plugin erstellt einen Zahlungsversuch mit einer eigenen Referenz (WC-, der Bestellnummer und einem Zeitstempel), signiert ihn mit dem Integrity-Secret und leitet den Kunden mit dem Bestellbetrag in COP zum Wompi Web Checkout weiter. Rechnungs-E-Mail und Name des Kunden werden an Wompi übergeben. Eine Notiz zur Bestellung hält die Umgebung, die Referenz und den Betrag fest.

Auf der Wompi-Seite zahlt der Kunde mit einer beliebigen Zahlungsmethode, die in Ihrem Wompi-Konto aktiviert ist. Danach leitet Wompi den Kunden zur Bestellbestätigungsseite Ihres Shops 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, sobald der Kunde diese Seite erreicht. Die Transaktionsnummer in der Rücksprung-Adresse selbst wird nicht als vertrauenswürdig behandelt. Beim Neuladen der Seite wird die Transaktion höchstens alle 20 Sekunden erneut geprüft.

Nur Transaktionen, die für diese Bestellung erstellt wurden, können sie bezahlen, und nur in der Umgebung des Versuchs. Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen, zum Beispiel über die Seite Pay for order. Jeder Versuch erhält eine neue Referenz.

Die Zahlungsmethode wird nur angezeigt, wenn die Lizenz aktiv ist, alle vier Schlüssel des aktuellen Modus eingetragen sind, die Bestellwährung COP ist und der Gesamtbetrag mindestens COP 1.500 beträgt. Wenn die Zahlung nicht starten kann, sieht der Kunde eine kurze Meldung und kann eine andere Zahlungsmethode wählen:

Die Zahlungsmethode funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel. Spanische Übersetzungen für Kolumbien und Spanien sind enthalten.

Das Plugin führt keine Erstattungen über WooCommerce durch. Auf Ihrer Website gibt es keine gespeicherten Karten, keine Abonnements und keine Kartenfelder: Alle Zahlungsdaten werden bei Wompi eingegeben.

Bestellungen

Bestellstatus

Pending payment: Der Kunde wurde zu Wompi weitergeleitet und hat noch nicht bezahlt, oder Wompi hat die Transaktion noch nicht bestätigt.

On hold (pending payment): Wompi meldet die Transaktion als ausstehend, zum Beispiel bei PSE-, Nequi- oder Barzahlungen, die auf Bestätigung warten. Die Bestellung bleibt in Wartestellung, bis Wompi sie genehmigt oder ablehnt.

Processing or Completed: Die Transaktion wurde genehmigt. Es gilt der WooCommerce-Standard: Verarbeitung oder Abgeschlossen, bei Bestellungen mit nur virtuellen, herunterladbaren Produkten Abgeschlossen. Die Bestellnotiz zeigt die Wompi-Transaktion, die Art der Zahlungsmethode (zum Beispiel Karte, PSE oder Nequi) und die Referenz. Die Transaktions-ID der Bestellung ist die Wompi-Transaktions-ID.

On hold after payment: Wompi hat einen anderen Betrag oder eine andere Währung als den Bestellbetrag genehmigt (zum Beispiel wurde die Bestellung nach Beginn der Zahlung geändert), oder die Zahlung wurde genehmigt, nachdem die Bestellung storniert worden war. Die Bestellung wird nicht als bezahlt markiert. Die Bestellnotiz erklärt dies. Prüfen Sie die Zahlung im Wompi-Dashboard und schließen Sie die Bestellung ab oder erstatten Sie die Zahlung.

Failed: Die 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: Die Transaktion des letzten Zahlungsversuchs wurde in Wompi storniert, bevor die Bestellung bezahlt wurde.

Geht eine zweite genehmigte Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, das Duplikat im Wompi-Dashboard zu erstatten. Wird die zahlende Transaktion in Wompi storniert, fordert eine Notiz Sie auf, die Bestellung zu prüfen. Eine späte Zahlung für eine erstattete Bestellung fügt nur eine Notiz hinzu. Wiederholte Ereignisse und Rücksprünge erzeugen nie doppelte Notizen, E-Mails oder Bestandsänderungen.

Erstattungen

Erstattungen werden nicht aus WooCommerce gesendet. Erstatten oder stornieren Sie die Zahlung im Händler-Dashboard von Wompi und erfassen Sie danach in WooCommerce eine manuelle Erstattung. Eine in Wompi vorgenommene Stornierung wird der Bestellung als Notiz hinzugefügt.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Wompi. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren 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. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch Wompi-Ereignisse und Rücksprünge der Kunden bestätigt.

Läuft eine Lizenz ab, funktioniert das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Wompi erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable aktiviert ist und alle vier Schlüssel des aktuellen Modus eingetragen sind (das Statusfeld auf der Einstellungsseite listet fehlende Schlüssel auf). Prüfen Sie außerdem, ob die Bestellwährung COP ist und der Bestellbetrag mindestens COP 1.500 beträgt.

Die Zahlung ist erfolgt, aber die Bestellung bleibt bei Pending payment: Die Events URL funktioniert nicht. Prüfen Sie im Wompi-Dashboard, ob die Events URL für die von Ihnen verwendete Umgebung (Sandbox oder Produktion) gesetzt ist und genau der Adresse in den Einstellungen entspricht. Prüfen Sie, ob das Events-Secret dieser Umgebung im passenden Abschnitt steht. Die Bestellung wird auch bestätigt, wenn der Kunde nach der Zahlung zum Shop zurückkehrt.

Events URL antwortet Not configured: Das Events-Secret der Umgebung des Ereignisses ist leer. Fügen Sie es in die Einstellungen ein.

Events URL antwortet Invalid signature: Das Events-Secret gehört zu einer anderen Umgebung oder einem anderen Konto. Kopieren Sie es erneut aus dem Wompi-Dashboard.

Events URL antwortet 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 antwortet Busy, retry: Die Bestellung wurde im selben Moment durch eine andere Anfrage aktualisiert. Wompi sendet das Ereignis später erneut.

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

Warnung beim Speichern „The key does not start with ...“: Ein Schlüssel wurde im 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_.

Bestellung ist On hold mit einer Notiz zum Betrag: Der genehmigte Betrag oder die Währung weicht vom Bestellbetrag ab. Prüfen Sie die Zahlung im Wompi-Dashboard und schließen Sie die Bestellung ab oder erstatten Sie sie manuell.

Andere Fehler: Öffnen Sie die Bestellnotizen oder WooCommerce > Status > Logs, Quelle wcp_wompi_payment. Fehler werden immer protokolliert. Aktivieren Sie Debug log für mehr Details. Entwickler können mit dem Filter wompi_p_supported_currencies eine weitere Währung zulassen, wenn ihr Wompi-Konto sie akzeptiert.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Wenn der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet wird, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen des Gateways und die Protokolle des Plugins werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen, Wompi-Daten und Transaktions-IDs.

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