VibeFox Wompi 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: Kolumbianischer Peso (COP). Wompi Kolumbien rechnet in COP ab, und die Zahlungsmethode wird bei Warenkörben in anderen Währungen ausgeblendet. Die Konfigurationsseite warnt Sie, wenn die Standardwährung des Shops nicht COP ist.

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 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. Klicken Sie nach dem Hochladen auf Configure oder suchen Sie später VibeFox Wompi Payment in der Modulliste und klicken Sie auf Configure.

3. Fügen 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. Fügen Sie die Sandbox- und Produktionsschlüssel aus dem Händler-Dashboard von Wompi ein und setzen Sie die Events-URL in Wompi (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.

Bei der Installation legt das Modul zwei Bestellstatus an, Awaiting Wompi payment und Wompi payment on hold. PrestaShop bietet ein neues Zahlungsmodul für die Währungen, Länder und Kundengruppen an, die zu diesem Zeitpunkt existieren. Prüfen Sie unter Payment > Preferences, dass COP erlaubt ist. Ein Land, das Sie später hinzufügen, muss dort angehakt werden, bevor Kunden aus diesem Land Wompi sehen.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Wompi Payment > Configure. Jeder Abschnitt mit Feldern hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. 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 Modul, 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.

Wompi

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

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

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), Bereich für Entwickler. Jede Umgebung hat eigene Schlüssel: öffentlicher Schlüssel, privater Schlüssel, Events-Secret und Integrity-Secret.

Sandbox mode: verwendet die Wompi-Sandbox (Sandbox-Schlüssel, kein echtes Geld). Es werden sowohl die Schlüssel als auch die Wompi-API umgeschaltet (sandbox.wompi.co oder production.wompi.co). Zahlungsversuche behalten die Umgebung, in der sie gestartet wurden. Standard: on. Deaktivieren Sie die Option, um echte Zahlungen anzunehmen. Solange sie aktiv ist, sehen Kunden unter der Zahlungsmethode Sandbox-Modus: Es wird keine echte Zahlung ausgeführt.

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 wird verwendet, um 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 Zahlungsanfrage, die an den Web Checkout gesendet wird.

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_...).

Öffentliche Schlüssel werden in ihren Feldern angezeigt. Gespeicherte private Schlüssel und Secrets werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Gespeichert: Leer lassen, um ihn beizubehalten. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten.

Clear saved secrets: Setzen Sie ein Häkchen bei einem privaten Schlüssel oder Secret einer der beiden Umgebungen und klicken Sie auf Save, um ihn zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

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 in diesem Abschnitt angezeigte Events-URL, für die Sandbox und für die Produktion. Mit freundlichen URLs sieht sie so aus: https://your-shop/module/wcp_wompi_payment/webhook, eventuell mit einem Sprachcode wie /es/. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen.

Das Modul verwendet dieses Ereignis:

transaction.updated: eine Transaktion wurde genehmigt, abgelehnt, storniert, ist fehlgeschlagen oder steht aus.

Andere Ereignisse werden mit Ignored beantwortet. Jedes Ereignis wird mit dem Events-Secret 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 über die Wompi-API abgerufen, und nur diese Daten werden verwendet. Ohne Events-URL wird eine Bestellung nur angelegt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Erweitert

Debug log: schreibt Zahlungs- und Webhook-Aktivitäten in logs/wompi_p_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Fehler und Warnungen werden immer protokolliert, auch wenn diese Option deaktiviert ist. Schlüssel, Secrets und Kundendaten werden nie protokolliert. Standard: off.

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: Wenn aktiviert, entfernt die Deinstallation des Moduls die Modul-Einstellungen und das Protokoll. Die Wompi-Zahlungsversuche und die Bestellstatus des Moduls bleiben immer erhalten, sodass bestehende Bestellungen ihre Wompi-Daten behalten. Standard: off.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig Wompi) und bestätigt. Das Modul legt einen Zahlungsversuch mit einer eigenen Referenz an (PS-, die Warenkorbnummer und einen Zeitstempel), signiert ihn mit dem Integrity-Secret und leitet den Kunden mit dem Warenkorbbetrag in COP zum Wompi Web Checkout weiter. E-Mail-Adresse des Kunden und Name der Rechnungsadresse werden an Wompi übergeben. Zu diesem Zeitpunkt existiert noch keine Bestellung.

Auf der Wompi-Seite bezahlt der Kunde mit einer beliebigen Zahlungsmethode, die in Ihrem Wompi-Konto aktiviert ist. Danach leitet Wompi den Kunden zurück in Ihren Shop. Die Bestellung wird erst als bezahlt markiert, nachdem Wompi die Zahlung bestätigt hat: 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 vertraut, und nur Transaktionen, die für diesen Warenkorb in der Umgebung des Versuchs erstellt wurden, werden akzeptiert. Bei Seitenaktualisierungen wird die Transaktion höchstens alle 20 Sekunden erneut geprüft.

Wenn die Transaktion genehmigt wird, wird die Bestellung angelegt und der Kunde sieht die übliche Bestellbestätigungsseite. Bei einer ausstehenden Zahlung (zum Beispiel PSE, Nequi oder eine Barzahlung) zeigt die Seite Ihre Wompi-Zahlung steht zur Bestätigung aus (zum Beispiel PSE, Nequi oder eine Barzahlung). Wir bearbeiten die Bestellung, sobald Wompi die Zahlung bestätigt. Bei einer Bestellung in Wartestellung zeigt sie Wir haben Ihre Wompi-Zahlung erhalten und prüfen sie. Wir melden uns, falls etwas benötigt wird. Wird eine ausstehende Zahlung später abgelehnt, zeigt die Seite Ihre Wompi-Zahlung wurde nicht genehmigt. Bitte kontaktieren Sie uns. Wird sie storniert, zeigt die Seite Ihre Wompi-Zahlung wurde storniert, und diese Bestellung wurde abgebrochen. Bitte kontaktieren Sie uns.

Wenn Wompi die Transaktion bei der Rückkehr des Kunden noch nicht bestätigt hat, zeigt eine Seite Wir warten auf die Bestätigung Ihrer Zahlung durch Wompi. Sie erhalten eine E-Mail, sobald sie bestätigt ist. mit einer Schaltfläche Check again. Das Wompi-Ereignis legt die Bestellung an, sobald es eintrifft.

Wird die Zahlung abgelehnt, wird keine Bestellung angelegt und der Warenkorb bleibt erhalten. Der Kunde ist wieder an der Kasse mit Ihre Wompi-Zahlung wurde nicht genehmigt (...). Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen., mit dem von Wompi angegebenen Grund. Eine stornierte Zahlung zeigt Ihre Wompi-Zahlung wurde storniert. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen. Verlässt der Kunde den Web Checkout ohne zu zahlen, lautet die Meldung Ihre Wompi-Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen oder eine andere Zahlungsmethode wählen. Jeder neue Versuch erhält eine neue Referenz. Sobald der Warenkorb eine Bestellung hat (bezahlt, ausstehend, Zahlungsfehler oder Storniert), kann er nicht erneut bezahlt werden: Der Kunde wird zur Bestellbestätigungsseite geleitet.

Die Zahlungsmethode wird nur angezeigt, wenn die Lizenz aktiv ist, alle vier Schlüssel des aktuellen Modus eingetragen sind, die Warenkorb-Währung COP und für das Modul erlaubt ist und der Gesamtbetrag mindestens COP 1.500 beträgt. Kann die Zahlung nicht starten, bleibt der Kunde an der Kasse mit einer kurzen Meldung:

Wompi ist derzeit nicht verfügbar. Bitte wählen Sie eine andere Zahlungsmethode.: Schlüssel des aktuellen Modus fehlen.

Wompi akzeptiert Zahlungen nur in COP; diese Bestellung ist in ...: der Warenkorb ist in einer anderen Währung.

Der Mindestbetrag für Wompi-Zahlungen ist ...: der Gesamtbetrag des Warenkorbs liegt unter COP 1.500.

Diese Zahlungsmethode ist nicht verfügbar.: das Modul ist deaktiviert oder für das Land, die Währung oder die Kundengruppe des Warenkorbs nicht erlaubt.

Die Events-URL funktioniert, während der Shop im Wartungsmodus ist, und wird nicht durch die Ländersperre Ihres Shops blockiert.

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

Bestellungen

Bestellstatus

Noch keine Bestellung: Der Kunde wurde zu Wompi weitergeleitet und hat nicht bezahlt, die Zahlung wurde abgelehnt oder Wompi hat die Transaktion noch nicht bestätigt. Es existiert nur der Warenkorb.

Awaiting Wompi payment: Wompi meldet die Transaktion als ausstehend, zum Beispiel PSE-, Nequi- oder Barzahlungen, die auf eine Bestätigung warten. Die Bestellung wartet, bis Wompi sie genehmigt oder ablehnt. Wird sie genehmigt, wird die Zahlung verbucht und die Bestellung wechselt zu Payment accepted.

Payment accepted: Die Transaktion wurde für den Warenkorbbetrag in COP genehmigt. Die Zahlung wird mit der Wompi-Transaktions-ID verbucht, und eine Notiz zeigt die Transaktion, den Typ der Zahlungsmethode (zum Beispiel CARD, PSE oder NEQUI), die Referenz, den Betrag und die Umgebung.

Wompi payment on hold: Wompi hat einen anderen Betrag oder eine andere Währung genehmigt als den Bestellbetrag (zum Beispiel wurde der Warenkorb geändert, nachdem die Zahlung begonnen hatte), oder die Zahlung wurde genehmigt, nachdem die Bestellung storniert worden war. Die Bestellung wird nicht als bezahlt markiert. Die Notiz erklärt dies. Prüfen Sie die Zahlung im Wompi-Dashboard und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Payment error: Eine ausstehende Transaktion des letzten Zahlungsversuchs wurde abgelehnt oder endete mit einem Fehler. Die Meldung von Wompi wird der Notiz hinzugefügt. Ergebnisse älterer Versuche ändern die Bestellung nicht.

Canceled: Eine ausstehende Transaktion des letzten Zahlungsversuchs wurde in Wompi storniert.

Trifft eine zweite genehmigte Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht geä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 die Rückkehr des Kunden erzeugen nie doppelte Notizen, E-Mails oder Zahlungen.

Wompi-Zahlungsblock

Die Bestellseite zeigt einen Block Wompi payment mit der Referenz, der Transaktions-ID, dem Status (mit dem Wompi-Status), dem angeforderten Betrag, dem Betrag der Transaktion, der Zahlungsmethode, der Meldung von Wompi, einem Abzeichen SANDBOX für Sandbox-Zahlungen, den Payment attempts des Warenkorbs, wenn es mehrere gab, und den Wompi notes der Bestellung.

Erstattungen

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

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Wompi Payment ist der erste Block auf Modules > Module Manager > VibeFox Wompi Payment > Configure, über den 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 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: presta-payment-wompi 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. 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 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 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. Die PrestaShop-Storefront weiß nicht, dass Sie im Back-Office angemeldet sind, daher ist 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. Eine Erinnerung erscheint in Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin durch Wompi-Ereignisse und die Rückkehr der 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 Ihrer Arbeit im Back-Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

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 auf der Konfigurationsseite listet fehlende Schlüssel auf). Prüfen Sie außerdem, ob die Warenkorb-Währung COP ist und der Gesamtbetrag mindestens COP 1.500 beträgt. Prüfen Sie unter Payment > Preferences, ob das Modul für COP, das Land des Kunden und die Kundengruppe erlaubt ist.

Die Zahlung ist erfolgt, aber es wurde keine Bestellung angelegt: Die Events-URL funktioniert nicht. Prüfen Sie im Wompi-Dashboard, ob die Events-URL für die verwendete Umgebung (Sandbox oder Produktion) gesetzt ist und genau der Adresse entspricht, die in den Einstellungen angezeigt wird. Prüfen Sie, ob das Events-Secret dieser Umgebung im passenden Abschnitt steht. Die Bestellung wird auch angelegt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

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

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

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

Die Events-URL antwortet Retry: Die Bestellung wurde gerade durch eine andere Anfrage bestätigt, oder die Bestellung konnte nicht angelegt werden (zum Beispiel, weil das Modul deaktiviert ist). Wompi sendet das Ereignis später erneut. Sehen Sie im Feld Log nach dem Grund.

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

Die Events-URL antwortet Unknown reference: Die Transaktionsreferenz wurde nicht von diesem Shop ausgegeben, zum Beispiel weil dasselbe Wompi-Konto von einem anderen Shop genutzt wird. Referenzen anderer Systeme werden mit Ignored beantwortet.

Die Webhook-URL zeigt im Browser Method not allowed: Das ist normal. Die URL akzeptiert nur Anfragen von Wompi.

Warnung beim Speichern, dass der Schlüssel nicht mit ... beginnt: 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_.

Bestellung ist Wompi payment on hold: Lesen Sie die Notizen im Block Wompi payment (siehe Bestellstatus) und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung im Wompi-Dashboard.

Andere Fehler: Sehen Sie im Feld Log auf der Modulseite und in den Wompi notes der Bestellung nach. Fehler werden immer protokolliert. Aktivieren Sie Debug log für mehr Details.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Wompi Payment und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Ist Delete data on uninstall aktiviert, werden die Modul-Einstellungen und das Protokoll entfernt. Ist es deaktiviert, bleiben alle Einstellungen für eine spätere Neuinstallation erhalten. Die Wompi-Zahlungsversuche und die Bestellstatus Awaiting Wompi payment und Wompi payment on hold bleiben immer erhalten, sodass ein spätes Ereignis einer alten Zahlung auch nach einer Neuinstallation erkannt wird. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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