VibeFox Conekta for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

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

PHP: 8.0 oder neuer.

Währung: Die Shopwährung muss MXN oder USD sein. Bei anderen Währungen wird die Zahlungsart ausgeblendet.

Conekta-Konto: Sie benötigen die privaten API-Schlüssel Ihres Conekta-Kontos (Test und Live), also die Private Keys, und einen Webhook im Conekta-Panel (siehe Konfiguration). Es werden nur die Private Keys verwendet. Der Public Key wird nicht benötigt, da die Zahlung auf der gehosteten Zahlungsseite von Conekta erfolgt.

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

Installation

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Conekta > Manage oder klicken Sie auf der Seite „Plugins“ unter dem Namen des Plugins auf Settings.

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

5. Geben Sie Ihre privaten Test- und Live-Schlüssel ein, wählen Sie den Modus und fügen Sie den Webhook im Conekta-Panel hinzu (siehe Konfiguration).

6. Aktivieren Sie Enable / Disable und speichern Sie. Testen Sie eine Zahlung im Testmodus und entfernen Sie danach den Haken bei Test mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Conekta. Oberhalb der Felder warnt die Seite Sie, wenn Conekta aktiviert ist, der Private Key des aktuellen Modus aber leer ist (die Zahlungsart wird dann an der Kasse ausgeblendet), und wenn die Shopwährung nicht MXN oder USD ist. Solange der Testmodus aktiv ist, zeigt die Seite Test mode is on: payments are simulated with the test private key. an. Wenn Sie ein aktiviertes Gateway ohne den Schlüssel des aktuellen Modus speichern, erscheint eine Fehlermeldung, die Sie auffordert, ihn einzugeben.

Allgemein

Enable / Disable: Enable Conekta payments schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den der Kunde an der Kasse sieht. Standard: Conekta.

Description: der Text unter der Zahlungsart an der Kasse. Standard: Pay securely with card, OXXO cash or SPEI transfer. You will be redirected to Conekta to complete your payment.

Payment methods: die Zahlungsarten, die auf der Conekta-Zahlungsseite angeboten werden. Standard: Karte, Barzahlung und Banküberweisung. Barzahlung, SPEI und BNPL sind nur für MXN-Bestellungen verfügbar (USD-Bestellungen erhalten nur Karten) und müssen in Ihrem Conekta-Konto aktiviert sein. Ist nichts ausgewählt, wird Karte verwendet.

Credit / debit card: Kartenzahlung.

Cash (OXXO and other stores): Der Kunde erhält eine Referenz und zahlt bar in einem Geschäft.

Bank transfer (SPEI): Der Kunde erhält eine Referenz und zahlt per Banküberweisung.

Buy now, pay later (BNPL): Zahlung über eine BNPL-Option, sofern sie in Ihrem Conekta-Konto aktiviert ist.

API-Schlüssel

Kopieren Sie Ihre Private Keys aus dem Conekta-Panel unter Developers > API keys. Test- und Live-Schlüssel sind unterschiedlich.

Test mode: Enable test mode verwendet den privaten Testschlüssel. Es wird kein echtes Geld belastet, und an der Kasse wird ein Abzeichen TEST MODE angezeigt. Erstattungen verwenden immer den Schlüssel des Modus, in dem die Zahlung erfolgte. Standard: an.

Test private key: der private API-Schlüssel aus dem Testmodus Ihres Conekta-Kontos.

Live private key: der private API-Schlüssel aus dem Live-Modus Ihres Conekta-Kontos. Halten Sie ihn geheim.

Jede Conekta-Bestellung speichert ihren Modus: Benachrichtigungen und Erstattungen verwenden den passenden Schlüssel. Lassen Sie beide Schlüssel ausgefüllt, solange noch alte Testbestellungen offen sind.

Webhook

Der Webhook informiert Ihren Shop über Zahlungen, die nach dem Verlassen der Conekta-Seite eingegangen sind, zum Beispiel OXXO- oder SPEI-Zahlungen. Gehen Sie im Conekta-Panel zu Developers > Webhooks und fügen Sie die in diesem Abschnitt angezeigte URL für den Test- und den Live-Modus hinzu. Sie sieht so aus: https://your-site/wc-api/webhook_wc_conekta/.

Wählen Sie diese Ereignisse aus:

order.paid: Die Bestellung wurde bezahlt.

order.pending_payment: Die Bestellung wartet auf Zahlung, zum Beispiel nachdem eine OXXO- oder SPEI-Referenz ausgestellt wurde.

order.declined: Die Zahlung wurde abgelehnt.

order.expired: Die Zahlungsseite oder Zahlungsreferenz ist abgelaufen.

order.canceled: Die Conekta-Bestellung wurde storniert.

order.refunded: Die Zahlung wurde erstattet, zum Beispiel im Conekta-Panel.

order.charged_back: Der Kunde hat die Zahlung angefochten (Chargeback); das Plugin fügt eine Bestellnotiz hinzu.

Der Webhook-Inhalt teilt dem Plugin nur mit, welche Conekta-Bestellung sich geändert hat. Jede Benachrichtigung wird geprüft, indem die Bestellung mit dem Private Key ihres Modus erneut über die Conekta-API abgerufen wird; der Digest-Signaturheader des Webhooks wird nicht verwendet. Benachrichtigungen zu Conekta-Bestellungen, die dieser Shop für diese Bestellung nicht angelegt hat, werden angenommen und ignoriert. Ohne Webhook wird eine Bestellung nur bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt oder bei dem nächsten Zahlungsversuch für dieselbe Bestellung.

Erweitert

Debug log: Log API calls and notifications schreibt Details nach WooCommerce > Status > Logs, Quelle wcp_conekta_gateway. Fehler werden immer protokolliert. Protokolle enthalten nie API-Schlüssel oder Kundenkontaktdaten. Standard: aus.

Delete data on uninstall: Remove the settings, Conekta order references and logs when the plugin is deleted. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Conekta) und gibt die Bestellung auf. Das Plugin legt für den Bestellbetrag in der Bestellwährung eine Conekta-Bestellung an, mit den Artikeln, dem Versand, den Steuern und Rabatten, und leitet den Kunden zur gehosteten Zahlungsseite von Conekta weiter. Dort zahlt der Kunde mit einer der erlaubten Methoden.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Conekta die Zahlung bestätigt: Das Plugin liest die Bestellung über die Conekta-API, sobald der Webhook eintrifft und wenn der Kunde zurückkehrt. Kann die Zahlung noch nicht bestätigt werden, zeigt die Seite „Bestellung eingegangen“ We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again. Hat der Kunde OXXO oder SPEI gewählt und eine Zahlungsreferenz erhalten, wird die Bestellung auf „In Wartestellung“ gesetzt und die Seite zeigt Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received.

Wird die Zahlung abgelehnt, wird die Bestellung als „Fehlgeschlagen“ markiert und der Kunde kehrt zur Seite Pay for order zurück, mit The Conekta payment was not completed. Please try again or choose another payment method. Ist die Zahlungsseite abgelaufen oder wurde sie abgebrochen, sieht der Kunde The Conekta payment has expired or was cancelled. Please place the order again. Zahlt der Kunde eine Bestellung erneut, wird eine offene Conekta-Zahlungsseite mit demselben Betrag wiederverwendet; andernfalls wird die vorherige in Conekta storniert, bevor eine neue angelegt wird, damit ein alter Link nicht zweimal bezahlt werden kann. War die vorherige Zahlungsseite bereits bezahlt, wird die Zahlung verbucht, statt erneut zu belasten.

Kann Conekta die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel The payment could not be started. Please try again in a moment or choose another payment method. Der technische Grund wird im Protokoll festgehalten.

Die Zahlungsart 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. Die Texte sind ins Spanische (Mexiko) übersetzt.

Das Plugin nimmt Zahlungen nur auf der Conekta-Seite entgegen. Es gibt kein Kartenformular auf Ihrer Kassenseite, keine gespeicherten Karten, keine Abonnements, keine Vorautorisierung und Erfassung sowie keine monatlichen Ratenzahlungen (MSI).

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu Conekta weitergeleitet und hat noch nicht bezahlt. Die Bestellnotiz zeigt die Conekta-Bestellung und den Modus.

Processing: Conekta hat die Zahlung mit demselben Betrag und derselben Währung bestätigt (Bestellungen, die nur virtuelle, herunterladbare Produkte enthalten, werden auf „Fertiggestellt“ gesetzt, dem WooCommerce-Standard). Die Bestellnotiz zeigt die Zahlungsart (zum Beispiel die Kartenmarke und die letzten vier Ziffern, OXXO / Barzahlung oder SPEI-Überweisung), die Conekta-Bestellung und die Belastung. Die Transaktions-ID der Bestellung ist die Charge-ID von Conekta.

On hold, waiting for OXXO or SPEI: Der Kunde hat eine Zahlungsreferenz erhalten. Die Bestellung wird auf „In Bearbeitung“ gesetzt, sobald Conekta die Zahlung meldet.

On hold after payment: Der von Conekta erhaltene Betrag oder die Währung stimmt nicht mit der Bestellung überein, eine Testmodus-Zahlung ist eingegangen, während der Shop im Live-Modus lief (es wurde kein echtes Geld eingezogen), oder die Zahlung ist für eine bereits stornierte Bestellung eingegangen. Die Bestellnotiz erklärt das. Prüfen Sie die Zahlung und schließen Sie die Bestellung dann ab oder erstatten Sie sie. Eine Bestellung, die bei Conekta nur vorautorisiert ist, wird ebenfalls auf „In Wartestellung“ gesetzt, mit einer Notiz, sie im Conekta-Panel zu erfassen oder zu stornieren.

Failed: Die Zahlung wurde abgelehnt. Die Notiz zeigt den Grund. Der Kunde kann erneut bezahlen.

Cancelled: Die aktuelle Conekta-Zahlungsseite ist abgelaufen oder wurde abgebrochen.

Eine bezahlte oder erstattete Bestellung wird nie herabgestuft oder wieder geöffnet. Trifft eine weitere Conekta-Zahlung für eine bereits bezahlte Bestellung ein, bittet Sie eine WARNING-Notiz, sie im Conekta-Panel zu erstatten.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Conekta (die Schaltfläche zeigt den Titel der Zahlungsart). Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung geht an die Conekta-Bestellung, die die Zahlung enthält, und verwendet den Schlüssel des Modus, in dem die Zahlung erfolgte; dieser Schlüssel muss daher eingerichtet sein. Akzeptiert Conekta die Erstattung nicht, zeigt WooCommerce den Fehler an und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird den Bestellnotizen mit Betrag, Modus, Conekta-Bestellung, Erstattungs-ID und Grund hinzugefügt.

Im Conekta-Panel vorgenommene Erstattungen gelangen über den Webhook zu Ihnen und werden als Notiz mit dem in Conekta und in WooCommerce erstatteten Betrag hinzugefügt. Sie werden nicht automatisch als WooCommerce-Erstattungen verbucht. Verbuchen Sie sie manuell, ohne Refund via Conekta zu verwenden. Ein von Conekta gemeldeter Chargeback wird ebenfalls 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 > Conekta. 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, sowie 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 gilt nur für eine 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 Conekta 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 Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Ein Hinweis erscheint auf der Seite „Plugins“ und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Conekta erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, der Private Key des aktuellen Modus ausgefüllt ist (Test private key im Testmodus, Live private key im Live-Modus) und die Shopwährung MXN oder USD ist. Die Einstellungsseite zeigt für jede dieser Bedingungen eine Warnung an.

Die Zahlung ging durch, aber die Bestellung bleibt auf Pending payment: Der Webhook funktioniert nicht. Prüfen Sie im Conekta-Panel, ob der Webhook für den verwendeten Modus (Test oder Live) existiert, ob seine URL genau der in den Einstellungen angezeigten entspricht und ob die Ereignisse ausgewählt sind. Prüfen Sie, ob der Private Key dieses Modus gesetzt ist, da jede Benachrichtigung damit geprüft wird. Die Bestellung wird auch bestätigt, wenn der Kunde in den Shop zurückkehrt oder versucht, dieselbe Bestellung erneut zu bezahlen.

Webhook antwortet Temporarily unavailable: Die Conekta-API war nicht erreichbar, der Private Key des Modus der Bestellung fehlt oder die Bestellung wurde gerade von einer anderen Anfrage verarbeitet. Conekta wiederholt den Webhook.

Webhook antwortet Verification failed, Invalid payload oder Invalid order id: Die Conekta-API hat die Bestellung nicht bestätigt, oder die Benachrichtigung war kein gültiges Conekta-Bestellereignis.

Webhook antwortet Ignored: Die Benachrichtigung gehört zu einer Conekta-Bestellung, die dieser Shop für diese Bestellung nicht angelegt hat (zum Beispiel ein anderer Shop oder ein Zahlungslink auf demselben Konto), oder zu einem anderen Objekt als einer Bestellung.

Der Kunde sieht We could not check the status of your previous payment attempt: Die vorherige Conekta-Zahlungsseite der Bestellung konnte nicht gelesen werden, daher wird keine neue erstellt, um eine Doppelzahlung zu vermeiden. Versuchen Sie es in Kürze erneut.

Der Kunde sieht Payment gateway is not configured: Der Private Key des aktuellen Modus fehlt.

Bestellung ist On hold: Lesen Sie die Bestellnotizen. Der Kunde hat die OXXO- oder SPEI-Referenz noch nicht bezahlt, Betrag oder Währung stimmten nicht überein, oder eine Testmodus-Zahlung ist eingegangen, während der Shop im Live-Modus lief.

Erstattung schlägt mit einer Meldung zum Test- oder Live-Modus fehl: Die Zahlung wurde in diesem Modus getätigt, und dessen Private Key ist nicht gesetzt. Geben Sie ihn ein und versuchen Sie es erneut.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel beispielsweise bereits auf einer anderen Domain verwendet, 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.

Für Entwickler listet die Readme den Filter wc_ckt_supported_currencies für die Währungsliste auf.

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen des Gateways, die auf Bestellungen gespeicherten Conekta-Referenzen und die Protokolle 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 und Transaktions-IDs.

Conekta ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Conekta verbunden noch von Conekta unterstützt oder empfohlen.