VibeFox Culqi 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.

Shopwährung: Der Peruanische Sol (PEN) oder der US-Dollar (USD) muss in Ihrem Shop als aktivierte Währung hinterlegt sein. Culqi akzeptiert keine anderen Währungen, und die Zahlungsart wird nur angezeigt, wenn der Kunde in PEN oder USD bezahlt.

Culqi-Konto: Sie benötigen den öffentlichen Schlüssel und den geheimen Schlüssel Ihres Culqi-Kontos. Integrations- (Test-)Schlüssel stammen von integ-panel.culqi.com, Produktionsschlüssel (Live) von mipanel.culqi.com, jeweils unter CulqiPanel > Desarrollo > API Keys. Der öffentliche Schlüssel wird vom Culqi-Popup im Browser verwendet. Der geheime Schlüssel wird nur auf Ihrem Server verwendet und niemals an den Browser gesendet. Ein Webhook ist nicht erforderlich.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. 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_culqi_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_culqi_payment.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_culqi_payment-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, 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 Culqi Payment 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. Fügen Sie die Integrationsschlüssel ein und für echte Zahlungen die Produktionsschlüssel (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Lassen Sie Test Mode während des Tests eingeschaltet und schalten Sie ihn für echte Zahlungen aus.

OpenCart 4

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

4. Geben Sie den Lizenzschlüssel und die Culqi-Schlüssel wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Bei einer neuen Installation ist die Zahlungsart zunächst deaktiviert und der Testmodus eingeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Culqi Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Test mode is active: the integration keys are used and no real money is charged., solange der Testmodus eingeschaltet ist. Sie wird gewarnt, wenn das Gateway aktiviert ist, die Schlüssel des aktuellen Modus aber fehlen, sowie wenn keine aktivierte Shopwährung von Culqi unterstützt wird. In beiden Fällen wird die Zahlungsart an der Kasse ausgeblendet. Ist Ihre Standardwährung weder PEN noch USD, weist die Seite darauf hin, dass Culqi nur angeboten wird, wenn der Kunde in einer unterstützten Währung bezahlt. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern wird ein ungültiger Wert nicht übernommen und behält seinen bisherigen Wert, während die übrigen Felder gespeichert werden. Die Seite zeigt für jedes solche Feld einen Fehler an: ein Schlüssel mit falschem Präfix (zum Beispiel Live Secret Key must start with sk_live_ — the previous value was kept.), ein leerer Title oder einer mit mehr als 128 Zeichen, eine Sort Order, die keine ganze Zahl ist, ein Total, der keine Zahl von 0 oder mehr ist, oder eine Geozone bzw. ein Bestellstatus, der nicht existiert.

Culqi

Enable/Disable: Enable Culqi Payment Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Credit/Debit Card or Yape (Culqi). Erforderlich, bis zu 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely with your credit/debit card or Yape via Culqi.

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

Geo Zone: Culqi nur für Rechnungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

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

API-Schlüssel

Kopieren Sie die Schlüssel aus CulqiPanel > Desarrollo > API Keys: Integrations- (Test-)Schlüssel auf integ-panel.culqi.com, Produktionsschlüssel auf mipanel.culqi.com (die Seite verlinkt dorthin). Der Testmodus verwendet nur die Testschlüssel, der Live-Modus nur die Live-Schlüssel. Jeder Schlüssel muss mit dem Präfix seines Feldes beginnen.

Test Mode: Wenn eingeschaltet, werden die Testschlüssel (pk_test_ / sk_test_) verwendet und es wird kein echtes Geld belastet. Standard: ein. Schalten Sie ihn aus, um echte Zahlungen mit den Live-Schlüsseln anzunehmen. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order den Hinweis TEST MODE: No real charges will be made.

Test Public Key: der öffentliche Schlüssel der Integrationsumgebung. Er beginnt mit pk_test_.

Test Secret Key: der geheime Schlüssel der Integrationsumgebung. Er beginnt mit sk_test_ und wird niemals an den Browser weitergegeben.

Live Public Key: der öffentliche Schlüssel der Produktionsumgebung. Er beginnt mit pk_live_.

Live Secret Key: der geheime Schlüssel der Produktionsumgebung. Er beginnt mit sk_live_ und wird niemals an den Browser weitergegeben.

Gespeicherte geheime Schlüssel werden nicht erneut angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten geheimen Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved key on save und klicken Sie auf Save.

Zahlungsarten

Karten werden immer angeboten. Banküberweisung, Agenten, Wallets und Cuotéalo erfordern die Culqi-Orders-API und werden von dieser Erweiterung nicht angeboten.

Yape: Offer Yape in the Culqi popup zeigt Yape neben den Karten im Culqi-Fenster an. Standard: ein.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Culqi die Belastung bestätigt hat. Jedes der folgenden Felder listet Ihre Bestellstatus in OpenCart auf.

Order Status After Payment: Culqi hat die Belastung bestätigt, und Betrag und Währung stimmen mit der Bestellung überein. Standard: Processing.

On Hold (Review) Status: Culqi hat einen Betrag oder eine Währung belastet, die nicht zur Bestellung passen, oder die Zahlung nicht erfasst. Eine Notiz erklärt, was Sie im CulqiPanel prüfen sollten. Standard: Pending, da OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Refunded Status: die Zahlung wurde auf der Bestellseite vollständig erstattet. Teilerstattungen fügen nur eine Notiz hinzu. Standard: Refunded.

Erweitert

Debug log: protokolliert API-Anfragen und Zahlungsschritte in culqi_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden; bei 5 MB wird sie nach culqi_p_debug.old.log.php verschoben. Fehler, einschließlich Kartenablehnungen mit ihrem Code, werden immer protokolliert. Schlüssel, Kartendaten und Kundendaten werden niemals protokolliert. Standard: aus.

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 eingeschaltet, werden beim Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll entfernt. Culqi-Belastungen und -Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen auch nach einer Neuinstallation erstattet werden können. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit/Debit Card or Yape (Culqi)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung, und OpenCart legt die Bestellung an, weiterhin ohne Status. Wenn der Kunde auf Confirm Order klickt, öffnet sich das Culqi-Checkout-Popup auf derselben Seite mit dem Namen Ihres Shops, dem Bestellbetrag und der Währung. Dort gibt der Kunde die Kartendaten ein oder bezahlt mit Yape. Die Culqi-Skripte werden immer von Culqi geladen. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt im Bestätigungsblock unten auf der Kassenseite auf Confirm Order. Fordert der Shop keine Rechnungsadresse an (Standard bei OpenCart 4), werden die Kundendaten, die mit der Belastung übermittelt werden, aus der Lieferadresse und dem Namen des Kunden übernommen.

Culqi wandelt die Zahlungsdaten in ein Einmal-Token um, und nur dieses Token wird an Ihren Shop gesendet. Ihr Server erstellt die Belastung über die Culqi-Charges-API für den Bestellbetrag in der Bestellwährung, sofort erfasst. Die Belastung erscheint im CulqiPanel als Order mit der Bestellnummer und der E-Mail-Adresse des Kunden. Die Bestellung wird erst als bezahlt markiert, nachdem Culqi sie bestätigt hat. Anschließend 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 OpenCart-Bestellung.

Verlangt die Bank 3-D Secure, sieht der Kunde Your bank requires additional verification (3-D Secure). Please complete it in the window that opens. Nach der Authentifizierung wird die Belastung automatisch erneut gesendet. Wird die Verifizierung nicht abgeschlossen, sieht der Kunde The 3-D Secure verification was not completed. Please try again or use another card.

Wird die Karte abgelehnt, sieht der Kunde die Meldung von Culqi nach Payment failed: und kann im selben Schritt mit einer anderen Karte erneut versuchen. Antwortet Culqi nicht, sieht der Kunde We could not confirm your payment with Culqi. Please check your email or contact us before trying again. In diesen Fällen bleibt die Bestellung ohne Status, und eine Notiz im Bestellverlauf hält den Versuch fest. Schließt der Kunde das Culqi-Fenster, wird nichts belastet, und die Schaltfläche Confirm Order kann erneut angeklickt werden. Der Warenkorb bleibt in all diesen Fällen erhalten.

Eine Bestellung wird nie doppelt belastet. Sendet der Kunde erneut, während bereits eine Zahlung für dieselbe Bestellung läuft, sieht er This order is already being paid. Please wait a moment and check your email before trying again. Hat Culqi das Geld eingezogen, der Bestellstatus konnte aber nicht gesetzt werden, sieht der Kunde Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. Die Belastung bleibt erhalten, und der nächste Versuch mit demselben Warenkorb setzt den Bestellstatus daraus, ohne eine neue Belastung. Ein Warenkorb wird nur einmal bezahlt: Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt (OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird), gelangt der Kunde zur Erfolgsseite und wird nicht erneut belastet. OpenCart 4 behält eine Bestellung für die Kasse und aktualisiert sie, daher bezahlt der Kunde nach einer abgelehnten Karte dieselbe Bestellung.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen geschlossen (zum Beispiel storniert oder erstattet) oder ist sie bereits bezahlt und hat sich der Warenkorb seitdem geändert (andere Produkte oder Mengen), schickt Confirm Order den Kunden zurück zur Kasse, wo ein neuer Auftrag des Warenkorbs mit eigener Zahlung entsteht. Eine bezahlte und danach geschlossene Bestellung hält den Warenkorb nicht mehr.

Die Erweiterung unterstützt nur einmalige Kartenzahlungen und Yape-Zahlungen, sofort erfasst. Es gibt keine Bank-App, keine Agenten, Wallets oder Cuotéalo, keine gespeicherten Karten, Abonnements oder Ratenzahlungen, keine Culqi-Webhooks und keine getrennte Autorisierung und Erfassung.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde hat noch nicht bezahlt, die Karte wurde abgelehnt oder Culqi hat nicht geantwortet. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. Notizen im Bestellverlauf erklären fehlgeschlagene Versuche.

Order Status After Payment (default Processing): Die Belastung wurde bestätigt und stimmt mit der Bestellung überein. Eine Notiz zeigt Culqi payment successful mit dem Modus (Test oder Live), 3-D Secure, falls verwendet, und der Culqi-Belastungs-ID (chr_...).

On Hold (Review) Status (default Pending): Culqi hat eine Belastung gemeldet, deren Betrag oder Währung nicht zur Bestellung passt, oder eine Zahlung, die autorisiert, aber nicht erfasst wurde. Die Notiz erklärt dies und zeigt die Belastungs-ID. Prüfen Sie die Belastung im CulqiPanel und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

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

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

Registerkarte VibeFox Culqi Payment

Öffnen Sie unter Sales > Orders eine mit Culqi bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Culqi Payment die Charge ID mit einem Hinweis Test bei Testzahlungen, den belasteten Amount (mit 3-D Secure, falls verwendet), einen Review-Hinweis für Bestellungen in Prüfung, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die Culqi notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox Culqi Payment den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Culqi. Bestätigen Sie die Frage Refund this amount through Culqi? This cannot be undone. Voll- und Teilerstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die Culqi belastet hat. Nach einer Betragsabweichung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat, nicht den Bestellbetrag. Die Erstattung wird mit den Schlüsseln des Modus gesendet, in dem die Zahlung erfolgte (Test oder Live), auch wenn Sie seitdem den Modus gewechselt haben. Daher muss der geheime Schlüssel dieses Modus gesetzt sein. Akzeptiert Culqi die Erstattung nicht, zeigt die Registerkarte den Fehler, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Culqi-Erstattungs-ID, dem Betrag und Ihrem Grund dem Erstattungsverlauf und den Notizen 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 Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns senden kein Geld über Culqi zurück. Im CulqiPanel vorgenommene Erstattungen werden nicht nach OpenCart übertragen. Aktualisieren Sie die Bestellung bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Culqi Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox Culqi 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 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-culqi 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. Nachdem sich die Shopadresse geändert hat 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 Shopadresse 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 Culqi 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 angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. 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 auf dem Admin-Dashboard eine Erinnerung. 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.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Admin-Dashboard oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht erforderlich. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Culqi wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, beide Schlüssel des aktuellen Modus gesetzt sind (Test Public Key und Test Secret Key im Testmodus, Live Public Key und Live Secret Key im Live-Modus) und der Kunde in PEN oder USD bezahlt. Die Einstellungsseite zeigt eine Warnung, wenn Schlüssel fehlen. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den eingestellten Total erreicht.

Die Zahlung wurde durchgeführt, die Bestellung bleibt aber ohne Status: Die Erweiterung verwendet keine Webhooks. Die Belastung wird nur durch die Antwort von Culqi an Ihren Server bestätigt. Hat Culqi nicht rechtzeitig geantwortet, enthält die Bestellung die Notiz Culqi did not confirm the charge. Suchen Sie die Belastung dieser Bestellung im CulqiPanel. Hat der Kunde die Meldung gesehen, dass die Bestellung nicht abgeschlossen werden konnte, setzt der nächste Zahlungsversuch in derselben Kundensitzung den Status, ohne erneut zu belasten.

Die Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die Notizen auf der Registerkarte VibeFox Culqi Payment. Der belastete Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung wurde nicht erfasst. Prüfen Sie die Belastung im CulqiPanel und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung.

Der Schlüssel wird nicht gespeichert: Der Fehler besagt, dass das Feld mit einem Präfix beginnen muss, zum Beispiel sk_live_. Jedes Feld akzeptiert nur Schlüssel seines eigenen Typs und Modus: pk_test_, sk_test_, pk_live_ oder sk_live_.

Der Kunde sieht Payment gateway misconfiguration. Please contact the store owner.: Die Schlüssel des aktuellen Modus fehlen, oder Culqi hat den geheimen Schlüssel abgelehnt. Prüfen Sie die Schlüssel in den Einstellungen.

Der Kunde sieht Payment token is invalid. Please try again.: Das Token aus dem Culqi-Fenster gehört zum anderen Modus, zum Beispiel nach dem Umschalten von Test Mode, während die Kassenseite geöffnet war. Der Kunde sollte die Seite neu laden und erneut bezahlen.

Das Culqi-Fenster öffnet sich nicht: Der Kunde sieht The Culqi payment window could not be loaded. Please reload the page and try again. Prüfen Sie, ob Skripte von js.culqi.com und 3ds.culqi.com auf Ihrer Kassenseite nicht blockiert werden, zum Beispiel durch eine Cache- oder Optimierungserweiterung.

Der Kunde sieht Security check failed. Please reload the page and try again.: Die Kassenseite war in einer anderen Sitzung geöffnet. Ein Neuladen der Seite behebt das.

Der Kunde sieht This payment method is not available.: Die Kassensitzung hat keine Culqi-Bestellung mehr, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Eine Karte wurde abgelehnt und Sie möchten den Grund wissen: Lesen Sie die Notiz zur Bestellung oder das Feld Log auf der Seite der Erweiterung. Ablehnungen werden mit dem Culqi-Ablehnungscode protokolliert, auch wenn Debug log ausgeschaltet ist.

Kein Erstattungsformular auf der Registerkarte: Die Registerkarte nennt den Grund: Die Zahlung ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht, die Erweiterung zu bearbeiten, oder der geheime Schlüssel des Zahlungsmodus fehlt.

Die Erstattung schlägt mit einer Meldung zu den Schlüsseln fehl: Die Zahlung wurde im Test- oder Live-Modus getätigt, und der geheime Schlüssel dieses Modus ist nicht gesetzt. Geben Sie ihn ein und versuchen Sie es erneut.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Culqi Payment 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 des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Ist Delete data on uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Schlüssel, Yape, Protokollierung) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Culqi-Belastungen und -Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen auch nach einer Neuinstallation 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 Culqi Payment auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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