VibeFox Conekta 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: Die Währung der Kasse 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) sowie einen Webhook im Conekta-Panel (siehe Konfiguration). Es werden nur die privaten Schlüssel verwendet. Der öffentliche Schlüssel wird nicht benötigt, da die Zahlung auf der gehosteten Checkout-Seite von Conekta erfolgt.

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net erworben. Ein Schlüssel funktioniert für eine 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_conekta_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_conekta_gateway.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_conekta_gateway-oc3-(version).ocmod.zip aus. Die Erweiterung enthält 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 Conekta Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

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 Ihre privaten Schlüssel für Test und Live ein, wählen Sie den Modus und fügen Sie im Conekta-Panel den Webhook hinzu (siehe Konfiguration).

5. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Testen Sie eine Zahlung im Testmodus und deaktivieren Sie danach Test mode.

OpenCart 4

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

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

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Conekta Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, wenn Conekta aktiviert ist, aber der private Schlüssel des aktuellen Modus leer ist (die Zahlungsart wird dann an der Kasse ausgeblendet), und wenn die Standardwährung des Shops nicht MXN oder USD ist. Solange der Testmodus aktiv ist, wird Test mode is on: payments are simulated with the test private key. angezeigt. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein, Sort Order muss eine ganze Zahl sein, Total muss eine nicht negative Zahl sein, und die ausgewählte Geozone und die Bestellstatus müssen vorhanden sein. Schlägt eine Prüfung fehl, wird nichts gespeichert und die Seite listet die Fehler auf. Zwei Warnungen verhindern das Speichern nicht: wenn keine Zahlungsart ausgewählt ist (dann werden Kartenzahlungen angeboten) und wenn das Gateway aktiviert ist, ohne dass der private Schlüssel des aktuellen Modus eingetragen ist.

Conekta

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

Title: der Name der Zahlungsart, den der Kunde an der Kasse sieht. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Default: Conekta. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Default: Pay securely with card, OXXO cash or SPEI transfer. Sie werden zu Conekta weitergeleitet, um Ihre Zahlung abzuschließen.

Payment methods: die Zahlungsarten, die auf der Zahlungsseite von Conekta angeboten werden. Default: card, cash and bank transfer. 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 bezahlt bar in einer Filiale.

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

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

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

Geo Zone: Conekta nur für Rechnungsadressen in der ausgewählten Geozone anbieten. Default: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Kassenbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Conekta angeboten wird. Lassen Sie das Feld leer, um Conekta bei jedem Betrag anzubieten.

API-Schlüssel

Kopieren Sie Ihre privaten Schlüssel aus dem Conekta-Panel unter Developers > API keys (die Seite enthält einen Link zum Panel). Test- und Live-Schlüssel sind verschieden.

Test mode: verwendet den privaten Testschlüssel. Es wird kein echtes Geld belastet, und der Kunde sieht im Schritt Confirm Order den Hinweis TEST MODE — No real charges will be made. Erstattungen verwenden immer den Schlüssel des Modus, in dem die Zahlung erfolgt ist. Default: on.

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

Live private key: der private API-Schlüssel aus dem Produktivmodus Ihres Conekta-Kontos. Bewahren Sie ihn geheim auf.

Gespeicherte Schlüssel 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 Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved key on save und klicken Sie auf Save.

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

Webhook

Der Webhook informiert Ihren Shop über Zahlungen, zum Beispiel über OXXO- oder SPEI-Zahlungen, die nach dem Verlassen der Conekta-Seite durch den Kunden erfolgen. Gehen Sie im Conekta-Panel zu Developers > Webhooks und fügen Sie die URL hinzu, die in diesem Abschnitt unter Webhook URL angezeigt wird, sowohl für den Testmodus als auch für den Live-Modus. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_conekta_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_conekta_gateway/payment/wcp_conekta_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Sie muss aus dem Internet erreichbar sein.

Wählen Sie diese Ereignisse aus (sie sind auch in diesem Abschnitt aufgelistet):

order.paid: die Bestellung wurde bezahlt.

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

order.declined: die Zahlung wurde abgelehnt.

order.expired: die Kasse oder die 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); die Erweiterung fügt eine Bestellnotiz hinzu.

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

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Conekta die Zahlung gemeldet hat, durch den Webhook oder wenn der Kunde zurückkehrt; die Bestellung wird immer erneut von Conekta abgerufen. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status, der nach einer verifizierten Zahlung über Conekta gesetzt wird. Default: Processing.

Awaiting Conekta Payment Status: dem Kunden wurde eine OXXO- oder SPEI-Referenz ausgestellt, und Conekta hat das Geld noch nicht erhalten. Default: Pending.

Conekta Payment On Hold Status: bezahlt, aber der Betrag oder die Währung weicht von der Bestellung ab, eine TEST-Zahlung kam im Live-Modus an, die Bestellung wurde bereits storniert oder die Zahlung ist nur vorautorisiert. Eine Notiz erklärt den Grund. Default: Pending, da OpenCart keinen Status „On hold“ hat. Sie können eigene Status unter System > Localisation > Order Statuses anlegen und hier auswählen.

Payment Expired / Canceled Status: eine auf Zahlung wartende Bestellung, deren Conekta-Referenz abgelaufen ist oder deren Conekta-Bestellung storniert wurde. Default: Canceled.

Refunded Status: wird gesetzt, nachdem die Zahlung von der Bestellseite aus vollständig erstattet wurde. Default: Refunded.

Erweitert

Debug log: protokolliert API-Aufrufe und Benachrichtigungen in wc_ckt_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler und Warnungen werden immer protokolliert, auch wenn dieser Schalter aus ist. Protokolle enthalten niemals API-Schlüssel oder Kontaktdaten von Kunden. Default: off.

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

Delete data on uninstall: Wenn aktiviert, entfernt das Deinstallieren der Erweiterung die Einstellungen und das Protokoll. Die Conekta-Transaktionen und -Erstattungen sowie die Bestellungen werden immer beibehalten, sodass alte Bestellungen nach einer Neuinstallation weiterhin bestätigt und erstattet werden können. Default: off.

Import / Export

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

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte private Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Conekta). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to Conekta to complete your payment. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Conekta-Bestellung über die Bestellsumme in der Bestellwährung, mit den Produkten, Zuschlägen, Rabatten, Steuern und dem Versand, und leitet den Kunden zur gehosteten Checkout-Seite von Conekta weiter. Name, E-Mail-Adresse, Telefonnummer und Lieferadresse des Kunden werden an Conekta übergeben; auf der Conekta-Seite wird die Zahlung als Order # und die Bestellnummer angezeigt. Dort bezahlt der Kunde mit einer der erlaubten Methoden. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Fordert der Shop keine Rechnungsadresse an (Standard bei OpenCart 4), werden die Rechnungsdaten aus der Lieferadresse und dem Namen des Kunden übernommen.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Conekta sie bestätigt: Die Erweiterung liest die Bestellung über die Conekta-API, wenn der Webhook eintrifft und wenn der Kunde zurückkehrt. Die Bestellung erhält ihren Status dann auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Wenn der Kunde OXXO oder SPEI gewählt und eine Zahlungsreferenz erhalten hat, erhält die Bestellung den Status Awaiting Conekta Payment Status, und die Erfolgsseite zeigt Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received. Bei einer Bestellung im Status „On hold“ zeigt die Seite We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again.

Wenn die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt werden kann, zeigt eine Seite Payment confirmation denselben Text und eine Schaltfläche Check again. Der Webhook setzt den Bestellstatus, sobald er eintrifft. Bei OpenCart 4 sendet der Browser die Shop-Sitzung nicht mit, wenn Conekta 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.

Wenn die Zahlung abgelehnt wird, bleibt die Bestellung ohne Status, und der Kunde kehrt zur Kasse zurück mit The Conekta payment was not completed. Please try again or choose another payment method. Ist die Kasse abgelaufen oder wurde sie abgebrochen, lautet die Meldung The Conekta payment has expired or was cancelled. Please try again. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. Bei jedem neuen Versuch (OpenCart 3 erstellt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung, OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie) werden zuerst die früheren Conekta-Kassen des Warenkorbs gelesen. Eine offene Kasse derselben Bestellung mit demselben Betrag wird wiederverwendet; andernfalls wird die vorherige in Conekta storniert, bevor eine neue erstellt wird, damit ein alter Link nicht doppelt bezahlt werden kann. Wurde eine frühere Kasse bereits bezahlt, wird ihre Bestellung bestätigt, statt erneut zu belasten. Ein Warenkorb wird nur einmal bezahlt: Hat eine andere Bestellung desselben Warenkorbs bereits eine Conekta-Zahlung oder eine ausgestellte OXXO-/SPEI-Referenz, wird keine neue Zahlung gestartet, und der Kunde gelangt zur Erfolgsseite. Trifft trotzdem eine zweite Zahlung für denselben Warenkorb ein, bleibt deren Bestellung ohne Status, und die bezahlte Bestellung erhält eine Notiz, das Duplikat im Conekta-Panel zu erstatten.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel ist ihre OXXO- oder SPEI-Referenz abgelaufen oder Sie haben sie storniert), schickt Confirm Order den Kunden mit The Conekta payment has expired or was cancelled. Please try again. zurück zur Kasse, und beim nächsten Klick auf Confirm Order wird eine neue Bestellung des Warenkorbs bezahlt. Hat die Bestellung bereits einen Status und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), wird der Kunde zur Kasse zurückgeschickt, und der geänderte Warenkorb erhält eine neue Bestellung und eine eigene Zahlung.

Wenn Conekta die Zahlung nicht starten kann, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel The payment could not be started. Please try again in a moment or choose another payment method. Validierungsmeldungen von Conekta, etwa ein Mindestbetrag, werden so angezeigt, wie Conekta sie sendet. Der technische Grund wird im Protokoll festgehalten.

Der Webhook funktioniert 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 für den Webhook hinzu.

Die Erweiterung nimmt Zahlungen nur auf der Conekta-Seite entgegen. Sie hat kein Kartenformular auf Ihrer Kassenseite und unterstützt keine gespeicherten Karten, Abonnements, Vorautorisierung und Erfassung oder Ratenzahlungen (MSI).

Bestellungen und Erstattungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Conekta geschickt und hat nicht bezahlt, die Zahlung wurde abgelehnt oder Conekta hat die Zahlung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur angezeigt, wenn der Filter Order Status auf Missing Orders gesetzt ist.

Order Status After Payment (default Processing): Conekta hat die Zahlung mit demselben Betrag und derselben Währung bestätigt. Eine Notiz zeigt die Zahlungsart (zum Beispiel die Kartenmarke und die letzten vier Ziffern, OXXO / Barzahlung oder SPEI-Überweisung), die Conekta-Bestellung und die Belastung.

Awaiting Conekta Payment Status (default Pending): Der Kunde hat eine OXXO- oder SPEI-Zahlungsreferenz erhalten. Die Bestellung wechselt zu Order Status After Payment, wenn Conekta die Zahlung meldet.

Conekta Payment On Hold Status (default Pending): Der von Conekta erhaltene Betrag oder die Währung stimmt nicht mit der Bestellung überein, eine Zahlung im Testmodus kam im Live-Modus des Shops an (es wurde kein echtes Geld eingezogen), oder die Zahlung kam für eine bereits stornierte Bestellung an. Die Notiz erklärt es. Prüfen Sie die Bestellung und bearbeiten Sie sie dann oder erstatten Sie die Zahlung. Eine Bestellung, die bei Conekta nur vorautorisiert ist, wird ebenfalls zurückgehalten, mit einer Notiz, sie im Conekta-Panel zu erfassen oder zu stornieren.

Payment Expired / Canceled Status (default Canceled): Die OXXO- oder SPEI-Referenz einer wartenden Bestellung ist abgelaufen oder ihre Conekta-Bestellung wurde storniert.

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

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.

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

Registerkarte VibeFox Conekta Gateway

Öffnen Sie unter Sales > Orders eine mit Conekta bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Conekta Gateway die Conekta order mit einem Hinweis Test mode bei Testzahlungen, die Charge, den Zahlungs-Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Conekta notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox Conekta Gateway den Amount ein (der noch nicht erstattete Betrag ist bereits eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via Conekta. Bestätigen Sie die Frage Refund this amount through Conekta? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups). Erstattungen sind auf den Betrag und die Währung begrenzt, die Conekta tatsächlich belastet hat; bei einer Betragsabweichung können Sie daher bis zu dem erstatten, was der Kunde bezahlt hat, nicht bis zur Bestellsumme. Die Erstattung geht an die Conekta-Bestellung, die die Zahlung enthält, und verwendet den Schlüssel des Modus, in dem die Zahlung erfolgt ist. Dieser Schlüssel muss daher eingetragen sein. Lehnt Conekta die Erstattung ab, zeigt die Registerkarte den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen mit Betrag, Modus, Conekta-Bestellung, Erstattungs-ID und Grund 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 bei einer manuellen Statusänderung. Eine teilweise Erstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald Conekta die Zahlung gemeldet hat.

Produktrücksendungen unter Sales > Returns zahlen über Conekta kein Geld zurück.

Im Conekta-Panel vorgenommene Erstattungen gelangen über den Webhook in den Shop und werden als Notiz mit dem in Conekta und in OpenCart erstatteten Betrag hinzugefügt. Sie werden nicht automatisch erfasst. Aktualisieren Sie die Bestellung manuell, ohne Refund via Conekta zu verwenden. Ein von Conekta gemeldeter Chargeback wird ebenfalls als Notiz hinzugefügt.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Conekta Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Conekta Gateway > 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-conekta und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht 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. Nach einer Änderung der Shop-Adresse oder nachdem 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 für eine Domain: die Shop-Adresse aus der OpenCart-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 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. Ein Admin-Benutzer, der im selben Browser im Admin-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint eine Erinnerung auf dem Dashboard des Admin-Bereichs. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Wenn eine Lizenz abläuft, arbeitet die Erweiterung weiter, Updates und Support benötigen jedoch 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 der Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden der Lizenzschlüssel und der Lizenzstatus immer entfernt.

Fehlerbehebung

Conekta erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist, der private Schlüssel des aktuellen Modus eingetragen ist (Test private key im Testmodus, Live private key im Live-Modus) und die Kassenwährung MXN oder USD ist. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt oder die Shop-Währung nicht unterstützt wird. Prüfen Sie außerdem, ob die Rechnungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung war erfolgreich, aber die Bestellung bleibt ohne Status: Der Webhook funktioniert nicht. Prüfen Sie im Conekta-Panel, ob der Webhook für den von Ihnen genutzten Modus (Test oder Live) existiert, ob seine URL exakt der unter Webhook URL angezeigten entspricht und ob die Ereignisse ausgewählt sind. Prüfen Sie, ob der private Schlüssel dieses Modus eingetragen ist, da jede Benachrichtigung damit geprüft wird. Die Bestellung erhält ihren Status auch, wenn der Kunde in den Shop zurückkehrt oder versucht, denselben Warenkorb erneut zu bezahlen.

Der Webhook antwortet Temporarily unavailable: Die Conekta-API war nicht erreichbar, der private Schlüssel des Modus der Bestellung fehlt, die Bestellung wurde gerade von einer anderen Anfrage verarbeitet oder der Bestellstatus konnte nicht gesetzt werden. Conekta wiederholt den Webhook. Den Grund finden Sie im Feld Log.

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

Der 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 desselben Kontos), oder zu einem anderen Objekt als einer Bestellung.

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

Der Kunde sieht We could not check the status of your previous payment attempt: Die frühere Conekta-Kasse des Warenkorbs konnte nicht gelesen werden, daher wird keine neue erstellt, um eine Doppelzahlung zu vermeiden. Versuchen Sie es gleich noch einmal.

Der Kunde sieht Payment gateway is not configured: Der private Schlüssel des aktuellen Modus fehlt.

Der Kunde sieht This payment method is not available.: Die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Der Kunde sieht Payment verification failed: Der Rücksprunglink von Conekta passte nicht zur Bestellung. Prüfen Sie die Bestellung im Conekta-Panel; der Webhook bestätigt weiterhin eine echte Zahlung.

Die Bestellung ist im Status „wartend“ oder „on hold“: Lesen Sie die Conekta notes auf der Registerkarte der Bestellung. Der Kunde hat die OXXO- oder SPEI-Referenz noch nicht bezahlt, Betrag oder Währung stimmten nicht überein, eine Zahlung im Testmodus kam im Live-Modus an oder die Zahlung ist nur vorautorisiert.

Kein Erstattungsformular auf der Registerkarte: Die Registerkarte nennt den Grund: Conekta hat die Zahlung noch nicht gemeldet, sie ist vollständig erstattet, Ihrer Benutzergruppe fehlt das Recht, die Erweiterung zu bearbeiten, oder der private Schlüssel des Modus der Zahlung ist nicht eingetragen.

Erstattung schlägt mit einer Meldung zum Test- oder Live-Modus fehl: Die Zahlung wurde in diesem Modus getätigt, und dessen privater Schlüssel ist nicht eingetragen. Tragen Sie ihn ein und versuchen Sie es erneut.

Für Entwickler: Die OpenCart-Ereignisse wc_ckt_supported_currencies, wc_ckt_order_request, wc_ckt_allowed_payment_methods und wc_ckt_refund_reason erlauben anderen Erweiterungen, die unterstützten Währungen, die Conekta-Bestellanfrage, die Zahlungsarten und den Erstattungsgrund zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Conekta Gateway 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 im Abschnitt 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 den Webhook im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Zahlungsarten, Testmodus, private Schlüssel, Protokollierung) und das Protokoll entfernt. Ist es deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Conekta-Transaktionen und -Erstattungen werden immer beibehalten, 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 Conekta Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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