VibeFox IntaSend 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 mit der cURL-Erweiterung.

HTTPS: IntaSend benötigt HTTPS für Live-Zahlungen und Webhooks. Die Einstellungsseite warnt Sie, wenn der Live-Modus aktiv ist und die Shop-Adresse nicht HTTPS verwendet.

IntaSend-Konto: Sie benötigen den Publishable Key (ISPubKey_...) und den Secret Key (ISSecretKey_...) Ihres IntaSend-Kontos, für die Sandbox, für Live oder für beide, sowie einen Webhook mit einer Challenge-Phrase im IntaSend-Dashboard (siehe Konfiguration). Der Publishable Key erstellt die Zahlung auf der Kasse. Der Secret Key wird nur auf Ihrem Server verwendet, um bei IntaSend den Zahlungsstatus abzufragen.

Währung: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF oder XOF. Hat der Kunde auf der Kasse eine andere Währung gewählt, wird die Zahlungsart ausgeblendet.

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 OpenCart-3-Paket wcp_intasend_pay-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_intasend_pay.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_intasend_pay-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 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 IntaSend Pay 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. Fügen Sie Ihre IntaSend-Schlüssel für die Sandbox und/oder für Live ein, legen Sie den Webhook im IntaSend-Dashboard an und tragen Sie dieselbe Challenge-Phrase in der Erweiterung ein (siehe Konfiguration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung mit aktiviertem Test mode und deaktivieren Sie dann Test mode, um echte Zahlungen anzunehmen.

OpenCart 4

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

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

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

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox IntaSend Pay Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt ein Statusfeld Test mode: IntaSend sandbox, no real money is charged. oder Live mode: real payments are accepted. an. Es warnt außerdem, wenn die Schlüssel des aktuellen Modus fehlen oder fehlerhaft sind (die Zahlungsart wird dann auf der Kasse ausgeblendet), wenn die Standardwährung des Shops nicht unterstützt wird, wenn keine Webhook-Challenge gesetzt ist und wenn der Live-Modus ohne HTTPS verwendet wird. 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 oder mehr als 128 Zeichen haben, Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder mehr sein, und die gewählte Geozone und die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert, und die Fehlermeldung nennt das Feld. Fehlerhafte Schlüssel verhindern das Speichern nicht: Das Statusfeld nennt sie. Eingefügte Schlüssel werden um Leerzeichen bereinigt.

IntaSend

Enable/Disable: Enable IntaSend aktiviert oder deaktiviert die Zahlungsart. Standard: aus.

Title: Der Name der Zahlungsart, den Kunden auf der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: IntaSend (M-Pesa, card). Pflichtfeld, 1 bis 128 Zeichen.

Description: Der Text, den der Kunde im Schritt Confirm Order über dem Bestätigungsbutton sieht. Standard: You will be redirected to IntaSend to pay securely with M-Pesa, card or another available method.

Sort Order: Die Position von IntaSend unter den Zahlungsarten auf der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

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

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

API-Schlüssel

Die Schlüssel finden Sie im IntaSend-Dashboard unter Settings > API Keys, getrennt im Sandbox-Dashboard und im Live-Dashboard (der Abschnitt enthält Links zu beiden). Der Testmodus verwendet die Sandbox-Schlüssel und die Sandbox-API, der Live-Modus die Live-Schlüssel und die Live-API. Die Erweiterung prüft, ob der Publishable Key mit ISPubKey_ beginnt, der Secret Key mit ISSecretKey_, und ob die Schlüssel zum aktuellen Modus passen: Sandbox-Schlüssel enthalten _test, Live-Schlüssel enthalten _live. Ist das nicht der Fall, wird die Zahlungsart ausgeblendet, und das Statusfeld erklärt den Grund.

Test mode: verwendet die IntaSend-Sandbox, es wird kein echtes Geld belastet. Standard: an. Deaktivieren Sie die Option, um echte Zahlungen mit den Live-Schlüsseln anzunehmen. Solange der Testmodus aktiv ist, sehen Kunden im Schritt Confirm Order den Hinweis TEST MODE - IntaSend sandbox, no real money is charged.

Sandbox publishable key: beginnt mit ISPubKey_test. Er identifiziert Ihr Unternehmen, wenn eine Zahlung erstellt wird.

Sandbox secret key: beginnt mit ISSecretKey_test. Wird nur auf Ihrem Server verwendet, um Zahlungen über die Payment Status API zu bestätigen.

Live publishable key: beginnt mit ISPubKey_live.

Live secret key: beginnt mit ISSecretKey_live. Wird nur auf Ihrem Server verwendet, um Zahlungen zu bestätigen.

Gespeicherte Secret Keys und die Webhook-Challenge 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 Wert zu entfernen, aktivieren Sie unter dem Feld Clear the saved value und klicken Sie auf Save.

Webhook

Der Webhook teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist, auch wenn der Kunde nicht in den Shop zurückkehrt (Browser geschlossen, M-Pesa später bestätigt). Öffnen Sie im IntaSend-Dashboard, in der Sandbox und im Live-Bereich, den Punkt Webhooks und fügen Sie die URL hinzu, die in diesem Abschnitt unter Webhook URL angezeigt wird. In OpenCart 3 hat sie die Form https://your-store/index.php?route=extension/payment/wcp_intasend_pay/webhook, in OpenCart 4 die Form https://your-store/index.php?route=extension/wcp_intasend_pay/payment/wcp_intasend_pay.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation erzeugt. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Tragen Sie dort eine Challenge-Phrase ein und dieselbe Phrase in der Erweiterung. Verwenden Sie für Sandbox und Live dieselbe Challenge.

Webhook challenge: dieselbe Challenge wie im IntaSend-Dashboard. Webhooks mit einer anderen Challenge werden abgelehnt. Solange dieses Feld leer ist, werden Webhooks nicht verarbeitet, und Zahlungen werden nur bestätigt, wenn der Kunde in den Shop zurückkehrt. Solche Webhooks werden als ignoriert beantwortet, nicht als Fehler, damit IntaSend den Webhook nicht deaktiviert, bevor Sie die Challenge eingetragen haben.

Die Erweiterung reagiert auf diese von IntaSend gemeldeten Zahlungsstatus. Vor jeder Änderung fragt sie über die Payment Status API den tatsächlichen Status ab:

Benachrichtigungen, die keine Kassenzahlungen dieses Shops sind, zum Beispiel Zahlungslinks oder Geldtransfer-Ereignisse desselben IntaSend-Kontos, werden mit Ignored beantwortet, damit IntaSend den Webhook nicht deaktiviert.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung, „missing order“). Die Bestellung erhält erst dann einen Status, wenn IntaSend die Zahlung über die Payment Status API bestätigt hat. Jedes Feld unten listet Ihre Bestellstatus aus OpenCart auf.

Paid Order Status: Der Status, der nach einer von IntaSend bestätigten Zahlung gesetzt wird. Standard: Processing.

On Hold Status: IntaSend hat einen abweichenden Betrag oder eine abweichende Währung gemeldet, eine Teilzahlung oder eine Zahlung nach der Stornierung der Bestellung. Die Bestellung erhält diesen Status und eine Notiz mit dem Grund. 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: Eine Zahlung für eine Bestellung in diesem Status fügt nur eine Notiz hinzu; die Bestellung wird nicht wieder geöffnet. Standard: Refunded. Die Erweiterung selbst führt keine Erstattungen durch.

Erweitert

Debug log: protokolliert Ereignisse von Kasse, Rückkehr und Webhook in intasend_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Browser geöffnet werden, und bei 5 MB wird sie nach intasend_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert. API-Schlüssel, die Challenge und Kundendaten werden nie protokolliert. Standard: aus.

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

Delete data on uninstall: Wenn aktiviert, entfernt das Deinstallieren der Erweiterung die Einstellungen der Zahlungsart und das Protokoll. Die für Bestellungen gespeicherten IntaSend-Referenzen gehören zur Zahlungshistorie und bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die Secret Keys und die Webhook-Challenge werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten Secret Keys und die Webhook-Challenge bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig IntaSend (M-Pesa, card)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung eine IntaSend-Zahlung über den Bestellbetrag in der Bestellwährung und leitet den Kunden zur gehosteten Kasse von IntaSend weiter. Dort bezahlt der Kunde mit M-Pesa, einer Karte oder einer anderen Methode, die in Ihrem IntaSend-Konto aktiviert ist. Die E-Mail-Adresse und Telefonnummer des Kunden sowie Name, Adresse und Land der Zahlungsadresse werden an IntaSend übergeben, sofern sie den Feldregeln von IntaSend entsprechen. Leere oder ungeeignete Felder werden weggelassen. Jeder Versuch erhält eine eigene IntaSend-Referenz.

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. Standardmäßig fragt OpenCart 4 nicht nach einer Zahlungsadresse; die Erweiterung übergibt dann Adresse, Stadt, Postleitzahl und Land der Lieferadresse an IntaSend.

Nach der Zahlung kehrt der Kunde über die Startseitenadresse Ihres Shops zurück, weil IntaSend einige Zeichen in der Rücksprung-Adresse nicht akzeptiert; die Erweiterung leitet den Kunden dann auf ihre Rückkehrseite weiter. Die Bestellung wird erst als bezahlt markiert, wenn IntaSend die Zahlung bestätigt: Die Erweiterung fragt die Payment Status API ab, wenn der Kunde zurückkehrt und wenn der Webhook eintrifft. Danach 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 Bestellung in OpenCart. Wurde die Bestellung in die Warteschleife gesetzt, zeigt die Seite außerdem Your payment was received and your order is being reviewed. We will contact you if anything is needed. Ist die Zahlung noch nicht bestätigt oder ist IntaSend in diesem Moment nicht erreichbar, zeigt eine Seite Payment confirmation den Text Your payment is being confirmed by IntaSend (M-Pesa confirmations can take a minute). You will receive an e-mail as soon as it is confirmed. mit den Schaltflächen Check again und Back to checkout. Der Webhook setzt den Bestellstatus, sobald IntaSend die Zahlung bestätigt.

Ist die Zahlung fehlgeschlagen, ist der Kunde zurück auf der Kasse mit The payment was not successful. Please try again or choose another payment method. (mit dem Grund von IntaSend, sofern angegeben). Ist der Kunde ohne Zahlung zurückgekehrt, lautet die Meldung The payment was not completed. Please try again or choose another payment method. Der Warenkorb bleibt erhalten, und der Kunde kann erneut bezahlen. Auf OpenCart 4 werden diese Meldungen über der Kasse angezeigt. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse, daher bezahlt der Kunde nach einer fehlgeschlagenen Zahlung dieselbe Bestellung mit einem neuen Versuch. Ein Warenkorb wird nur einmal bezahlt: Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, gelangt der Kunde zur Erfolgsseite statt zu einer neuen Zahlung. 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 diese Bestellung inzwischen geschlossen (zum Beispiel haben Sie sie storniert oder erstattet), wird der Kunde mit Your previous order was cancelled or refunded. Please confirm the order again. zurück zur Kasse geschickt. Ist die Bestellung bereits aufgegeben und der Warenkorb enthält inzwischen andere Produkte, lautet die Meldung Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. In beiden Fällen bezahlt das nächste Confirm Order eine neue Bestellung des Warenkorbs.

Kann IntaSend die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer Meldung über dem Button: IntaSend could not start the payment: und dem Grund von IntaSend, oder IntaSend is temporarily unavailable. Please try again in a moment or choose another payment method. Die Details werden im Protokoll festgehalten. Eine Bestellung mit dem Gesamtbetrag null kann nicht mit IntaSend bezahlt werden.

Der Webhook funktioniert auch, wenn sich der Shop im Wartungsmodus befindet: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die den Webhook und die Rückkehr des Kunden durchlässt.

Die Erweiterung unterstützt nur einmalige Zahlungen. Erstattungen werden nicht aus dem Shop an IntaSend gesendet, und es gibt keine gespeicherten Karten, Abonnements oder eingebetteten (Popup-)Zahlungsformulare. Ältere Kassenlinks derselben Bestellung können bei IntaSend nicht storniert werden.

Bestellungen

Bestellstatus

No status (missing order): Der Kunde wurde zu IntaSend weitergeleitet und hat nicht bezahlt, die Zahlung ist fehlgeschlagen oder IntaSend hat die Zahlung noch nicht bestätigt. In Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Paid Order Status (default Processing): Die Zahlung wurde bestätigt. Eine Notiz zeigt die IntaSend-Rechnung, die Zahlungsart bei IntaSend, den Betrag, den Modus (Sandbox oder Live) und wie die Zahlung bestätigt wurde (Webhook oder Rückkehr des Kunden).

On Hold Status (default Pending): IntaSend hat einen anderen Betrag oder eine andere Währung als den Bestellwert gemeldet, eine Teilzahlung oder eine Zahlung, die nach der Stornierung der Bestellung eingegangen ist. Die Notiz erklärt es. Prüfen Sie die Zahlung im IntaSend-Dashboard und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung. Trifft später die richtige Zahlung ein, wechselt die Bestellung zu Paid Order Status, und der Kunde wird per E-Mail benachrichtigt.

Trifft eine zweite Zahlung für eine bereits bezahlte Bestellung ein, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, sie im IntaSend-Dashboard zu erstatten, falls es sich um ein Duplikat handelt. Eine Zahlung für eine Bestellung im Status Refunded Status fügt eine Notiz hinzu und öffnet die Bestellung nicht erneut.

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

Registerkarte VibeFox IntaSend Pay Gateway

Öffnen Sie unter Sales > Orders eine mit IntaSend bezahlte Bestellung. Am unteren Ende der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox IntaSend Pay Gateway die IntaSend checkout attempts der Bestellung (Datum, Referenz, IntaSend-Zahlung, Umgebung, Betrag, Rechnung und Zahlungsart, Ergebnis mit dem Grund des Fehlschlags), die Invoices processed (Rechnung, IntaSend-Status, Betrag und Ergebnis) und die IntaSend notes der Bestellung. Die Registerkarte ist nur lesbar und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen werden nicht aus dem Shop an IntaSend gesendet. Erstatten Sie die Zahlung im IntaSend-Dashboard und erfassen Sie die Erstattung manuell in OpenCart, zum Beispiel indem Sie die Bestellung auf Refunded Status setzen.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox IntaSend Pay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox IntaSend Pay 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 gültig 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-intasend und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit der Berechtigung 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 Shop-Adresse geändert hat oder Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, 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 seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird IntaSend Kunden auf 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 Admin-Bereich im selben Browser 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. 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 im 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.

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 pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

IntaSend erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Schlüssel des aktuellen Modus eingetragen sind und zu diesem Modus passen: Sandbox-Schlüssel (mit _test) im Testmodus, Live-Schlüssel (mit _live) im Live-Modus. Das Statusfeld oben auf der Einstellungsseite zeigt, was nicht stimmt. Die Kassenwährung des Kunden muss unterstützt werden. Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung war erfolgreich, die Bestellung bleibt aber ohne Status: Die Bestätigungen von M-Pesa können einen Moment dauern. Der Webhook setzt den Status, sobald IntaSend den endgültigen Zustand meldet. Prüfen Sie, ob die Webhook-URL im IntaSend-Dashboard (Sandbox oder Live, je nach verwendetem Modus) genau der unter Webhook URL angezeigten entspricht und ob dort die Challenge mit Webhook challenge übereinstimmt. Die Bestellung erhält ihren Status außerdem, wenn der Kunde in den Shop zurückkehrt oder auf Check again klickt.

Der Webhook antwortet Ignored: webhook challenge not configured: Webhook challenge ist leer. Tragen Sie die Challenge aus dem IntaSend-Dashboard ein.

Der Webhook antwortet Invalid challenge: Die Challenge in IntaSend und in der Erweiterung stimmen nicht überein, oder der Webhook hat keine Challenge.

Der Webhook antwortet Verification unavailable, retry later oder Busy, retry later: IntaSend war in diesem Moment nicht erreichbar, die Bestellung (ihr Warenkorb) wurde gerade von einer anderen Anfrage bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. IntaSend wiederholt den Webhook. Der Grund steht im Protokoll.

Der Webhook antwortet Invoice not verified oder Invoice does not match the reference: IntaSend hat nicht bestätigt, dass diese Rechnung zur Bestellung gehört. Es wird nichts geändert.

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

Die Bestellung ist im On Hold Status: Lesen Sie die Notizen auf der Registerkarte VibeFox IntaSend Pay Gateway. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, die Zahlung war teilweise oder sie kam, nachdem die Bestellung storniert wurde. Prüfen Sie die Zahlung im IntaSend-Dashboard.

Der Kunde sieht nach Confirm Order einen Fehler: Sehen Sie im Feld Log auf der Seite der Erweiterung nach (aktivieren Sie Debug log für mehr Details). Sind die Schlüssel des aktuellen Modus falsch, sieht der Kunde IntaSend is not available at the moment. Please choose another payment method or contact the store. This payment method is not available. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde: Der Kunde lädt die Kasse neu. Sagt das Protokoll, dass die Rückkehr-URL Zeichen enthält, die IntaSend nicht akzeptiert, liegt die Ursache in der Shop-Adresse.

Der Kunde sieht We could not match this payment to an order: Der Rückkehr-Link wurde verändert oder gehört zu einer anderen Bestellung. Hat der Kunde bezahlt, setzt der Webhook trotzdem den Bestellstatus.

Für Entwickler: Bevor die Zahlung erstellt wird, löst die Erweiterung das OpenCart-Ereignis intasend_p_checkout_payload mit den Anfragedaten, der Bestellung und dem Modus aus; das Ereignis intasend_p_supported_currencies kann die Liste der Währungen ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox IntaSend Pay 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 Bereich Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Die OpenCart-Ereignisse der Erweiterung werden ebenfalls entfernt (auf OpenCart 4 zusätzlich deren Startup-Aktion, die Webhook und Kundenrückkehr im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Einstellungen der Zahlungsart (Titel, Beschreibung, Testmodus, Schlüssel, Webhook-Challenge, Schalter des Debug-Logs) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die IntaSend-Zahlungsversuche und Rechnungen von Bestellungen bleiben immer erhalten. 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 IntaSend Pay 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.

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