VibeFox Khipu for OpenCart — Hilfe

Voraussetzungen

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: Chilenischer Peso (CLP), Argentinischer Peso (ARS) oder Peruanischer Sol (PEN). Die Währung muss unter System > Localisation > Currencies vorhanden sein. Khipu wird nur angeboten, solange der Kunde in einer dieser Währungen bezahlt; bei anderen Währungen wird die Zahlungsart im Checkout ausgeblendet.

Khipu-Konto: Sie benötigen die Receiver ID („Id de cobrador“), den API-Schlüssel und den geheimen Schlüssel Ihres Khipu-Inkassokontos. Sie finden sie in Ihrem Khipu-Konto unter dem Händlerprofil (khipu.com/merchant/profile). Alle drei sind erforderlich: Ohne sie wird Khipu im Checkout nicht angeboten, und ohne den geheimen Schlüssel kann keine Zahlung bestätigt werden. Im Khipu-Konto muss nichts eingerichtet werden.

Erreichbarer Shop: Khipu bestätigt Zahlungen, indem es Ihren Shop aufruft. Die Benachrichtigungs-URL muss daher aus dem Internet erreichbar sein, ohne Passwortschutz und ohne Firewall, die Khipu blockiert. Der Wartungsmodus des Shops blockiert sie nicht.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer 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 OpenCart-3-Paket wcp_khipu_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_khipu_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_khipu_gateway-oc3-(version).ocmod.zip. 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 aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox Khipu 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 License key).

4. Geben Sie die Receiver ID, den API key und den Secret key Ihres Khipu-Inkassokontos ein (siehe Configuration).

5. Aktivieren Sie Enable / Disable und klicken Sie auf Save. Zum Testen verwenden Sie zunächst die Schlüssel eines Khipu-Entwicklerkontos und ersetzen sie danach durch die Schlüssel Ihres Produktivkontos.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_khipu_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Erweiterungscode 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 Khipu Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Bei einer neuen Installation ist die Zahlungsart zunächst ausgeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Khipu Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite, wenn Receiver ID, API key oder Secret key fehlen (Khipu wird dann im Checkout nicht angeboten), und wenn die Standardwährung des Shops von Khipu nicht unterstützt wird (Khipu wird dann nur angeboten, solange der Kunde in CLP, ARS oder PEN bezahlt). 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 und nicht länger als 128 Zeichen, Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder mehr sein, und die Geo Zone und die Bestellstatus müssen vorhanden sein. Andernfalls wird nichts gespeichert, und die Seite nennt das Feld. Fehlende Schlüssel verhindern das Speichern nicht.

Khipu

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

Title: der Name der Zahlungsart, den Kunden im Checkout sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Khipu. Pflichtfeld, 1 bis 128 Zeichen.

Description: der Text, der Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Standard: Per Banküberweisung mit Khipu bezahlen.

Sort Order: die Position von Khipu unter den Zahlungsarten im Checkout. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: Khipu wird nur für Zahlungsadressen in der ausgewählten Geo Zone angeboten. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: die Checkout-Summe in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor Khipu angeboten wird. Leer lassen, um Khipu bei jeder Summe anzubieten.

Khipu-Konto

Kopieren Sie Receiver ID, API key und Secret key aus Ihrem Khipu-Inkassokonto (der Abschnitt verlinkt auf khipu.com/merchant/profile). Khipu hat keinen separaten Sandbox-Server, und die Erweiterung hat keinen Testmodus-Schalter. Zum Testen verwenden Sie die Schlüssel eines Entwickler-Inkassokontos („desarrollo“): Damit wird über die Testbank DemoBank bezahlt, und es wird kein echtes Geld bewegt. Wechseln Sie zu den Schlüsseln Ihres Produktiv-Inkassokontos, wenn Sie live gehen.

Receiver ID: Ihre Khipu-Empfänger-ID („cobrador“). Zahlungen anderer Khipu-Konten werden abgelehnt.

API key: wird zum Erstellen von Zahlungen und zur Prüfung jeder Zahlung bei Khipu verwendet.

Secret key: wird zur Prüfung der Signatur (HMAC-SHA256) der Khipu-Zahlungsbenachrichtigungen verwendet. Ohne ihn kann keine Zahlung bestätigt werden.

Gespeicherte Schlüssel werden nie wieder 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 Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value und klicken Sie auf Save.

Zahlungsbenachrichtigungen

Notification URL: Khipu bestätigt Zahlungen, indem es die hier angezeigte URL aufruft. Auf OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_khipu_gateway/webhook, auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_khipu_gateway/payment/wcp_khipu_gateway.webhook. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Die URL wird bei jeder Zahlung automatisch mitgesendet, daher ist in Ihrem Khipu-Konto nichts einzurichten; die URL muss aber aus dem Internet erreichbar sein.

Jede Benachrichtigung muss eine gültige Signatur haben, die mit Ihrem Secret key erstellt wurde. Benachrichtigungen ohne gültige Signatur werden abgelehnt. Die Erweiterung vertraut dem Inhalt der Benachrichtigung nie: Sie fragt bei Khipu den Zahlungsstatus ab und handelt nach dem, was Khipu meldet:

Status after payment: der Status, den die Bestellung erhält, sobald Khipu die Zahlung bestätigt. Der Status wird sofort mit einer einzigen Statusänderung gesetzt.

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst einen Status, nachdem Khipu die Zahlung bestätigt hat. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.

Paid Order Status: der Status nach einer bestätigten Zahlung, wenn Status after payment auf Processing steht. Standard: In Bearbeitung.

Complete Order Status: der Status nach einer bestätigten Zahlung, wenn Status after payment auf Completed steht. Standard: Abgeschlossen.

On Hold (Review) Status: Zahlungen, deren Betrag oder Währung nicht zur Bestellung passen oder die nach der Stornierung der Bestellung eingehen, erhalten diesen Status und eine Notiz mit der Begründung. Standard: Ausstehend, da OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Erweitert

Debug log: protokolliert API-Aufrufe und Benachrichtigungen in wc_khp_debug.log.php im Log-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Browser geöffnet werden; bei 5 MB wird sie nach wc_khp_debug.old.log.php verschoben. Fehler werden immer protokolliert, auch wenn der Schalter aus ist. Schlüssel und Zahlerdaten werden nie geschrieben. Standard: aus.

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

Delete data on uninstall: Wenn eingeschaltet, entfernt die Deinstallation der Erweiterung die Einstellungen der Zahlungsart und das Log. Bestelldaten (Khipu-Zahlungs-IDs der Bestellungen) bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. API key und Secret key werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Der gespeicherte API key und Secret key bleiben erhalten.

Checkout

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Khipu). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung oberhalb der Bestätigungsschaltfläche. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Khipu-Zahlung über die Bestellsumme in der Bestellwährung und leitet den Kunden zur Khipu-Zahlungsseite weiter. Die Zahlung wird bei Khipu als Order # mit der Bestellnummer und dem Namen des Shops angezeigt, mit der Liste der Produkte. Die E-Mail-Adresse des Kunden wird an Khipu übergeben, wenn sie gültig ist. Auf der Khipu-Seite bezahlt der Kunde per Banküberweisung von seiner eigenen Bank.

Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kasse auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn Khipu die Zahlung bestätigt: durch die signierte Benachrichtigung oder durch eine Statusabfrage bei Khipu, wenn der Kunde zurückkehrt. Die Rückkehr selbst markiert nie etwas als bezahlt. Die Bestellung erhält dann 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. Prüft die Bank die Überweisung noch oder kann Khipu nicht erreicht werden, zeigt eine Seite Payment confirmation den Text Khipu is confirming your bank transfer. Your order will be confirmed automatically as soon as Khipu confirms the payment, and you will receive an e-mail. mit den Schaltflächen Check again und Back to checkout. Lässt sich die neueste Khipu-Zahlung der Bestellung keiner Bestellung zuordnen (zum Beispiel weil sie zu einer anderen Receiver ID gehört), kehrt der Kunde zum Checkout zurück mit We could not match this payment to an order. If you paid, please contact us.

Bricht der Kunde auf der Khipu-Seite ab oder wurde die Zahlung nicht abgeschlossen, kehrt der Kunde zum Checkout zurück mit The Khipu payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. Auf OpenCart 4 werden diese Meldungen über der Kasse angezeigt. Jeder neue Versuch (OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse und bezahlt sie mit einer neuen Khipu-Zahlung) löscht die vorherige unbezahlte Khipu-Zahlung der Bestellung oder des Warenkorbs, sodass der alte Link nicht mehr bezahlt werden kann. Hat Khipu die vorherige Zahlung bereits erhalten, wird sie übernommen und der Kunde gelangt zur Erfolgsseite, ohne dass eine neue Zahlung erfolgt. Wird die vorherige Überweisung noch von der Bank geprüft, sieht der Kunde Your previous Khipu payment for this order is still being verified by the bank. Please wait a few minutes before paying again. Ist die vorherige Zahlung in Prüfung, wird der Kunde gebeten, den Shop zu kontaktieren, bevor er erneut bezahlt. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde sie ohne Zahlung geschlossen (zum Beispiel haben Sie sie storniert), wird der Kunde mit Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zurück zur Kasse geschickt. Ist die Bestellung bereits aufgegeben und der Warenkorb hat sich seitdem geändert, lautet die Meldung Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. In beiden Fällen bezahlt das nächste Confirm Order eine neue Bestellung des Warenkorbs.

Kann Khipu die Zahlung nicht erstellen, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel Khipu could not create the payment for this order. Please check your billing details and try again, or contact the store. oder Khipu is temporarily unavailable. Please try again in a few minutes. Die Details werden im Log festgehalten.

Die Benachrichtigung funktioniert auch während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die die Benachrichtigung und die Rückkehr des Kunden durchlässt.

Die Erweiterung unterstützt nur einmalige Banküberweisungen. Erstattungen werden nicht von OpenCart an Khipu gesendet, und es gibt keine Abonnements, gespeicherten Zahlungsarten oder Vorautorisierungen. Unbezahlte Zahlungen sind nicht an eine Bestandsreservierung gebunden.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde wurde zu Khipu weitergeleitet und hat nicht bezahlt, oder Khipu hat die Überweisung noch nicht bestätigt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Paid Order Status oder Complete Order Status (Standard In Bearbeitung oder Abgeschlossen): Khipu hat die Zahlung bestätigt. Der Status richtet sich nach Status after payment. Eine Notiz zeigt Khipu payment verified. Payment ID: mit der Zahlungs-ID und dem Betrag.

On Hold (Review) Status (Standard Ausstehend): Khipu hat eine Zahlung bestätigt, deren Betrag oder Währung nicht zur Bestellung passt, oder die Zahlung ist eingegangen, nachdem die Bestellung storniert oder abgelehnt wurde. Eine Notiz erklärt es. Prüfen Sie die Zahlung in Ihrem Khipu-Konto und schließen Sie dann die Bestellung ab oder erstatten Sie dem Kunden den Betrag. Trifft später eine Zahlung in der richtigen Höhe für dieselbe Bestellung ein, wechselt die Bestellung in den bezahlten Status, und der Kunde wird per E-Mail benachrichtigt. Geht die Zahlung ein, nachdem die Bestellung bereits auf einen anderen Verarbeitungsstatus gesetzt wurde, bleibt der Status unverändert und es wird nur eine Notiz hinzugefügt.

Geht eine Zahlung für eine bereits bezahlte Bestellung oder für eine andere Bestellung eines bereits bezahlten Warenkorbs ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, sie dem Kunden zu erstatten, wenn es sich um eine zweite Zahlung handelt. Meldet Khipu eine bezahlte Zahlung als rückgängig gemacht, erhält die Bestellung eine Notiz, und ihr Status bleibt unverändert.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht. Sie beginnen mit dem Wort Khipu.

Registerkarte VibeFox Khipu Gateway

Öffnen Sie unter Sales > Orders eine mit Khipu bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Khipu Gateway die Khipu-Zahlungsversuche der Bestellung (Datum, Betrag, Khipu-Zahlungs-ID, Khipu-Status und Ergebnis), eine Warnung Manual review, solange die Bestellung im Prüfstatus ist, und die Khipu notes der Bestellung. Die Registerkarte ist nur lesbar und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen werden nicht von OpenCart an Khipu gesendet, weil Khipu über seine API keine Erstattung anbietet. Die Registerkarte weist darauf hin. Erstatten Sie dem Kunden den Betrag aus Ihrem Khipu-Konto oder per Banküberweisung und ändern Sie dann den Bestellstatus in OpenCart manuell.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Khipu Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Khipu 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 zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-khipu 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 Sprache des Admin-Bereichs (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 auf einer Domain: der 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 Khipu Kunden im Checkout nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 gibt es diese Vorschau nicht: Der Shop sieht die Admin-Anmeldung 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 Dashboard des Admin-Bereichs 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.

Läuft eine Lizenz ab, 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 des Admin-Bereichs öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Khipu erscheint nicht im Checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable / Disable eingeschaltet ist und Receiver ID, API key und Secret key alle eingetragen sind. Der Kunde muss in CLP, ARS oder PEN bezahlen. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung die in den Einstellungen festgelegte Total erreicht.

Die Zahlung ist durchgegangen, aber die Bestellung bleibt ohne Status: Khipu bestätigt eine Überweisung, nachdem die Bank sie geprüft hat. Die Bestellung erhält ihren Status, wenn die Khipu-Benachrichtigung eingeht oder wenn der Kunde auf Check again klickt. Prüfen Sie, ob Ihr Shop unter der URL aus Notification URL aus dem Internet erreichbar ist (kein Passwortschutz und keine Firewall, die Khipu blockiert), und sehen Sie sich das Feld Log auf der Erweiterungsseite an.

Die Benachrichtigung meldet Secret key not configured: Secret key ist leer. Tragen Sie ihn ein. Khipu sendet die Benachrichtigung erneut.

Die Benachrichtigung meldet Invalid signature, Missing signature oder Malformed signature: Der Secret key gehört nicht zu dem Inkassokonto, dessen Schlüssel Sie verwenden, oder die Anfrage kam nicht von Khipu.

Die Benachrichtigung meldet Order not found, Payment not found for this account oder Payment does not belong to this order: Die Zahlung ging an eine andere Receiver ID, mit anderen Schlüsseln oder für eine andere Bestellung ein. Prüfen Sie die Receiver ID und die Schlüssel.

Die Benachrichtigung meldet Payment not final yet oder Verification unavailable: Die Überweisung wird noch geprüft, oder Khipu konnte nicht erreicht werden. Khipu sendet die Benachrichtigung erneut.

Die Benachrichtigung meldet Busy, retry later oder Order could not be updated, retry later: Die Bestellung wurde gleichzeitig von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. Khipu sendet die Benachrichtigung erneut. Der Grund steht im Log.

Die Bestellung ist nach der Zahlung im Prüfstatus: Lesen Sie die Notizen in der Registerkarte VibeFox Khipu Gateway. Betrag oder Währung stimmten nicht mit der Bestellung überein, oder die Zahlung ging ein, nachdem die Bestellung storniert worden war.

Der Kunde sieht „Khipu payments are not available right now“: Der API key fehlt oder ist falsch. Prüfen Sie die Schlüssel in Ihrem Khipu-Konto.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse wc_khp_supported_currencies (um eine Währung hinzuzufügen, die Ihr Khipu-Konto akzeptiert, zum Beispiel EUR für Khipu Spanien), wc_khp_currency_decimals und wc_khp_payment_data aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Khipu 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 drei Bestellstatus, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Auf OpenCart 4 werden zusätzlich deren Ereignis und Startup-Aktion entfernt, die die Benachrichtigung und Kundenrückkehr im Wartungsmodus durchlässt. Ist Delete data on uninstall eingeschaltet, werden die übrigen Einstellungen der Zahlungsart (Titel, Beschreibung, Receiver ID, Schlüssel, Status nach der Zahlung, Debug-Log) und das Log entfernt. Ist es aus, bleiben sie für eine spätere Neuinstallation erhalten. Die Khipu-Zahlungsversuche bleiben immer erhalten, sodass späte Benachrichtigungen zu früher bezahlten Bestellungen auch nach einer Neuinstallation verarbeitet werden. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auf OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie neben VibeFox Khipu Gateway in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche). Klicken Sie dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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