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

iPay88-Händlerkonto: Der Merchant Code und der Merchant Key werden von iPay88 ausgegeben, sobald Ihr Händlerkonto aktiviert ist. Sie werden auch im iPay88-Händlerportal angezeigt. Wenn Sie noch kein Händler sind, beantragen Sie ein Konto auf der Website von iPay88. Halten Sie den Merchant Key geheim: Mit ihm werden die Zahlungen signiert. iPay88 hat keine separate Sandbox, daher gibt es keine Testschlüssel.

Request-URL: Ihre Website-Adresse muss bei iPay88 als Request-URL hinterlegt sein. Andernfalls zeigt die iPay88-Seite „Permission not allow“ an.

Währung: Malaysia — MYR sowie USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP oder THB, wenn die Mehrwährungsoption in Ihrem iPay88-Konto aktiviert ist; Philippinen — PHP oder USD; Indonesien — IDR; Thailand — THB. Kann die Kassenwährung des Kunden in Ihrer Region nicht belastet werden, wird die Zahlungsart auf der Kasse 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_ipay88_payment-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_ipay88_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_ipay88_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 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 iPay88 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. Wählen Sie Ihre iPay88 region, tragen Sie den Merchant Code und den Merchant Key ein, aktivieren Sie Enable/Disable und klicken Sie auf Save.

5. Um die Einrichtung zu prüfen, führen Sie eine Zahlung mit aktiviertem Test mode durch und deaktivieren Sie danach den Testmodus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_ipay88_payment.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 iPay88 Payment, 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 iPay88-Einstellungen ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Response- und Backend-URLs unterscheiden sich (siehe Response- und Backend-URLs).

Bei einer neuen Installation ist die Zahlungsart zunächst deaktiviert. Die Response- und Backend-URLs werden mit jeder Zahlung übermittelt, daher müssen sie bei iPay88 nicht eingerichtet werden.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox iPay88 Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Enter the iPay88 Merchant Code and Merchant Key — until then the payment method is not shown at checkout., solange ein Schlüssel fehlt, eine Warnung, wenn die Standardwährung des Shops in der gewählten Region nicht belastet werden kann (die Zahlungsart wird dann für diese Währung auf der Kasse ausgeblendet), und eine Warnung, solange der Testmodus aktiv ist. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht 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. Die iPay88-Felder verhindern das Speichern nie.

iPay88

Enable/Disable: Enable iPay88 Payment Gateway 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: iPay88. Bis zu 128 Zeichen; bleibt das Feld leer, sehen Kunden iPay88.

Description: Der Text, den der Kunde im Schritt Confirm Order über dem Bestätigungsbutton sieht. Standard: Pay securely via iPay88 (credit card, online banking, e-wallet).

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

Geo Zone: iPay88 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 iPay88 angeboten wird. Lassen Sie das Feld leer, um iPay88 bei jedem Betrag anzubieten.

iPay88-Konto

iPay88 region: Das Land Ihres iPay88-Händlerkontos. Es bestimmt die iPay88-Zahlungsseite und die Währungen, die belastet werden können. Die Bestellung wird immer in ihrer eigenen Währung belastet. Standard: Malaysia.

Merchant Code: Ihr iPay88-Merchant Code, zum Beispiel M01234.

Merchant Key: Ihr iPay88-Merchant Key. Er signiert Zahlungsanfragen und prüft die Antworten von iPay88. Halten Sie ihn geheim. Leerzeichen am Anfang und am Ende werden beim Speichern entfernt. Der gespeicherte Schlüssel wird 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 den gespeicherten Schlüssel zu entfernen, aktivieren Sie Clear the saved Merchant Key on save und klicken Sie auf Save.

Signature type: Die Art, wie Zahlungsanfragen signiert werden. Antworten werden in beiden Formaten geprüft, sodass Zahlungen, die vor einer Umstellung gestartet wurden, weiterhin nachprüfbar bleiben.

Zahlung

Payment method: Wählen Sie eine iPay88-Zahlungsart aus der malaysischen PaymentId-Liste vor oder belassen Sie Let the customer choose on the iPay88 page (Standard). Die Liste umfasst Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay und ShopeePay.

Reference prefix: optional. Wird vor der Bestellnummer in der iPay88-Referenz (RefNo) ergänzt, zum Beispiel SHOP1-. Verwenden Sie in jedem Shop, der dasselbe iPay88-Konto nutzt, ein eigenes Präfix, damit die Antwort eines Shops niemals auf eine Bestellung eines anderen angewendet wird. Erlaubt sind Buchstaben, Ziffern, „-“ und „_“, bis zu 10 Zeichen. Andere Zeichen werden beim Speichern entfernt, und ein Präfix, das mit einer Ziffer endet, erhält am Ende „-“, weil die Bestellnummer vom Ende der RefNo gelesen wird. Die Seite warnt Sie dann mit dem gespeicherten Wert.

Test mode: belastet einen festen Testbetrag statt des Bestellbetrags. iPay88 hat keine eigene Sandbox: Testzahlungen sind echte Transaktionen auf der Live-Zahlungsseite von iPay88 mit einem kleinen Betrag (1,00; IDR 10.000). Die Bestellung wird als bezahlt markiert, sobald der Testbetrag eingegangen ist, und die Bestellnotiz weist darauf hin. Solange der Testmodus aktiv ist, sehen Kunden im Schritt Confirm Order den Hinweis TEST MODE: only a test amount of ... will be charged. Eine im Testmodus gestartete Zahlung wird immer mit dem Testbetrag geprüft, auch wenn Sie den Testmodus deaktivieren, bevor iPay88 antwortet. Lassen Sie den Testmodus in einem Live-Shop niemals aktiviert. Standard: aus.

Response- und Backend-URLs

Die Erweiterung übermittelt beide URLs mit jeder Zahlung, daher ist nichts einzurichten. Falls iPay88 sie anfordert, kopieren Sie sie aus diesem Abschnitt. Auf OpenCart 3 haben sie diese Form: https://your-store/index.php?route=extension/payment/wcp_ipay88_payment/back (Response URL, die Rückkehr des Kunden) und https://your-store/index.php?route=extension/payment/wcp_ipay88_payment/backend (Backend URL, die Benachrichtigung von Server zu Server), auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_ipay88_payment/payment/wcp_ipay_88payment.back und https://your-store/index.php?route=extension/wcp_ipay88_payment/payment/wcp_ipay_88payment.backend. Der Abschnitt zeigt außerdem Ihre Website-Adresse, die bei iPay88 als Request-URL hinterlegt sein muss.

Beide Antworten von iPay88 werden auf die gleiche Weise geprüft: die Pflichtfelder, die Signatur mit Ihrem Merchant Key und die Referenz einer Zahlung, die dieser Shop für diese Bestellung gestartet hat. Antworten ohne gültige Signatur werden abgelehnt und ändern nie eine Bestellung. Die Backend-Benachrichtigung wird erst nach der Verarbeitung mit RECEIVEOK beantwortet. Andernfalls sendet iPay88 sie erneut. Sie 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 die signierte Backend-Benachrichtigung und die Rückkehr des Kunden durchlässt. iPay88 meldet diese Zahlungsstatus:

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung, „missing order“). Sie erhält erst dann einen Status, wenn iPay88 eine korrekt signierte Antwort gesendet hat. Eine fehlgeschlagene oder abgebrochene Zahlung lässt die Bestellung ohne Status; der Kunde kehrt mit erhaltenem Warenkorb zur Kasse zurück. Jedes Feld unten listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: eine erfolgreiche Zahlung (iPay88-Status 1) mit dem erwarteten Betrag und der erwarteten Währung. Standard: Processing.

Awaiting Payment Status: eine ausstehende Zahlung (Status 6), zum Beispiel eine Überweisung über einen Geldautomaten oder ein virtuelles Konto, die der Kunde noch nicht getätigt hat. Die Bestellung wechselt zum Status nach der Zahlung, wenn iPay88 die Zahlung bestätigt. Standard: Pending.

On Hold (Review) Status: iPay88 hat eine erfolgreiche Zahlung gemeldet, allerdings mit einem anderen Betrag oder einer anderen Währung als die Bestellung oder für eine Bestellung, die storniert worden war. Eine Notiz zeigt die Details; die Bestellung wird nicht als bezahlt markiert. 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.

Failed Payment Status: eine ausstehende Zahlung (Status 6), die iPay88 anschließend als fehlgeschlagen (Status 0) meldet. Standard: Failed.

Cancelled Order Status: der Status, den Ihr Shop für stornierte Bestellungen verwendet. Eine für eine solche Bestellung eingegangene Zahlung setzt sie in den Prüfstatus, statt sie als bezahlt zu markieren. Die Erweiterung setzt diesen Status nie selbst. Standard: Canceled.

Erweitert

Debug log: protokolliert Zahlungsanfragen und Antworten von iPay88 in ipay88_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Browser geöffnet werden. Es werden keine personenbezogenen Daten, kein Merchant Key und keine Signaturen protokolliert. Fehler und Warnungen werden immer protokolliert, auch wenn der Schalter deaktiviert ist. 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 und das Protokoll. Bestellungen und die iPay88-Zahlungsdatensätze werden nie gelöscht, daher wird eine verspätete Antwort auf eine alte Zahlung auch nach einer Neuinstallation verarbeitet. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Der Merchant Key wird nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Der gespeicherte Merchant Key bleibt erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig iPay88). 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, zeigt der Schritt Redirecting to iPay88 payment gateway... und Please do not close this window., während ein signiertes Formular an die iPay88-Zahlungsseite Ihrer Region gesendet wird. Sendet der Browser es nicht automatisch, klickt der Kunde auf Pay Now. Die Erweiterung übergibt den Bestellbetrag in der Bestellwährung (im Testmodus den Testbetrag), die Produktnamen sowie Name, E-Mail-Adresse und Telefonnummer des Kunden. Auf der iPay88-Seite bezahlt der Kunde mit Karte, FPX-Online-Banking, E-Wallet oder einer anderen Methode, die Ihr Konto anbietet.

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 an der Kasse nicht nach einer Telefonnummer, iPay88 benötigt sie jedoch: Hat die Bestellung keine Telefonnummer, zeigt der Bestätigungsschritt ein Pflichtfeld Phone mit iPay88 requires the contact number of the payer. Ohne Nummer sieht der Kunde iPay88 requires a phone number. Please enter your phone number and try again. Die eingegebene Nummer wird für den nächsten Versuch gespeichert.

Die Bestellung wird erst als bezahlt markiert, wenn iPay88 die Zahlung mit einer signierten Antwort bestätigt, entweder bei der Rückkehr des Kunden oder über die Backend-Benachrichtigung. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung. Nach einer erfolgreichen Zahlung sieht der Kunde die Erfolgsseite der Bestellung in OpenCart mit Your iPay88 payment has been received. Bei einer ausstehenden Zahlung zeigt die Seite Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. Bei einer Bestellung im Prüfstatus zeigt sie We have received a payment notification from iPay88 and are reviewing it. We will contact you if anything is needed. Wird eine ausstehende Zahlung später bestätigt oder schlägt sie fehl, informiert OpenCart den Kunden über den neuen Status.

Wird die Bestellung gleichzeitig durch die Backend-Benachrichtigung bestätigt, sieht der Kunde We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. mit den Schaltflächen Check again und Back to checkout.

Ist die Zahlung fehlgeschlagen oder abgebrochen worden, bleibt die Bestellung ohne Status und der Warenkorb wird beibehalten. Der Kunde ist zurück auf der Kasse mit The payment was not completed: und dem Grund von iPay88, danach You can try again or choose another payment method. Auf OpenCart 4 wird diese Meldung über der Kasse angezeigt. OpenCart 3 erstellt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung und damit eine neue RefNo; OpenCart 4 aktualisiert die Bestellung der Kasse, sodass der Kunde dieselbe Bestellung erneut bezahlt. Ein erneuter Versuch derselben Bestellung verwendet dieselbe RefNo. Kann die Antwort nicht verifiziert werden, sieht der Kunde The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. mit einer Schaltfläche Return to the store.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order mit This payment method is temporarily unavailable. Please choose another payment method. (Schlüssel fehlen oder der Gesamtbetrag ist null) oder iPay88 cannot accept payments in ... Please choose another payment method. (Währung in der Region nicht belastbar). Ein Warenkorb wird nur einmal bezahlt: Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder wartet auf eine ausstehende Zahlung, wird kein zweites Zahlungsformular erstellt und der Kunde gelangt zur Erfolgsseite der Bestellung. 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 ohne Zahlung geschlossen (zum Beispiel ist eine ausstehende Überweisung fehlgeschlagen oder Sie haben die Bestellung 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 geändert, lautet die Meldung Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. In beiden Fällen bezahlt das nächste Confirm Order eine neue Bestellung des Warenkorbs.

Die Erweiterung unterstützt nur einmalige Zahlungen. Sie bietet keine Erstattungen aus OpenCart, keine gespeicherten Karten, Abonnements, Vorautorisierung und Erfassung oder Kartenfelder auf Ihrer Website. Sie fragt den Zahlungsstatus bei iPay88 nicht erneut ab: Bestellungen werden nur durch die Antwort von iPay88 und die Backend-Benachrichtigung aktualisiert.

Bestellungen

Bestellstatus

No status (missing order): Der Kunde wurde zu iPay88 weitergeleitet und es ist noch kein Ergebnis eingetroffen, oder die Zahlung ist fehlgeschlagen. In Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (default Processing): iPay88 hat eine erfolgreiche Zahlung mit dem erwarteten Betrag und der erwarteten Währung gemeldet. Eine Notiz zeigt die TransID, die PaymentID, den Betrag und die Währung. Im Testmodus weist eine zweite Notiz darauf hin, dass der Testbetrag statt des Bestellbetrags belastet wurde.

Awaiting Payment Status (default Pending): iPay88 hat die Zahlung als ausstehend gemeldet. Die Bestellung wechselt zu Order Status After Payment, sobald iPay88 die Zahlung bestätigt, oder zu Failed Payment Status, wenn sie fehlschlägt.

Failed Payment Status (default Failed): Eine ausstehende Zahlung ist anschließend fehlgeschlagen. Die Notiz zeigt den Grund von iPay88. Der Kunde kann eine neue Bestellung aufgeben.

On Hold (Review) Status (default Pending): iPay88 hat eine erfolgreiche Zahlung mit einem anderen Betrag oder einer anderen Währung als die Bestellung gemeldet, oder die Zahlung ist nach der Stornierung der Bestellung eingegangen. Die Bestellung wurde NICHT als bezahlt markiert. Die Notiz erklärt es. Prüfen Sie die Zahlung im iPay88-Portal und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Eine bezahlte oder abgeschlossene Bestellung wird durch eine spätere Antwort nie verändert. Trifft eine weitere erfolgreiche Zahlung dafür oder für eine andere Bestellung desselben Warenkorbs ein, bittet Sie eine Notiz, sie im iPay88-Portal zu prüfen und zu erstatten, falls es sich um ein Duplikat handelt. Eine Fehlermeldung ändert nie eine bezahlte, stornierte oder geprüfte Bestellung. Wiederholte Antworten fügen nichts Neues hinzu.

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

Registerkarte VibeFox iPay88 Payment

Öffnen Sie unter Sales > Orders eine mit iPay88 bezahlte Bestellung. Am unteren Ende der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox iPay88 Payment die RefNo, TransId, den Status, den angeforderten Betrag (Requested), den Amount received, die PaymentId, den AuthCode, den Error und die Region, ein TEST MODE-Kennzeichen für Testzahlungen und die iPay88 notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen werden nicht aus OpenCart an iPay88 gesendet. Erstatten Sie die Zahlung im iPay88-Händlerportal und erfassen Sie die Erstattung danach manuell in OpenCart.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox iPay88 Payment ist der erste Block unter Extensions > Extensions > Payments > VibeFox iPay88 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 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-ipay88 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 iPay88 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

iPay88 erscheint nicht auf der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der Merchant Code und der Merchant Key eingetragen sind und die Kassenwährung des Kunden in der gewählten iPay88 region belastet werden kann. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. 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: Weder die Rückkehr des Kunden noch die Backend-Benachrichtigung haben Ihren Shop mit einer gültigen Signatur erreicht. Sehen Sie im Feld Log nach: Fehler werden immer protokolliert. Prüfen Sie, ob der Merchant Key genau der von iPay88 erhaltene ist und ob Ihr Server Anfragen von iPay88 an der in den Einstellungen angezeigten Backend URL annimmt.

Die iPay88-Seite zeigt „Permission not allow“: Ihre Website-Adresse ist bei iPay88 nicht als Request-URL hinterlegt. Bitten Sie iPay88, die im Abschnitt Response- und Backend-URLs angezeigte Adresse zu registrieren.

Die Backend-Benachrichtigung antwortet BAD SIGNATURE: Die Signatur stimmt nicht mit dem Merchant Key überein. Prüfen Sie den Merchant Key. Es wurde nichts geändert.

Die Backend-Benachrichtigung antwortet NOT CONFIGURED: Der Merchant Code oder der Merchant Key ist nicht gesetzt, daher kann die Antwort nicht verifiziert werden. iPay88 sendet die Benachrichtigung erneut.

Die Backend-Benachrichtigung antwortet UNKNOWN ORDER: Für diese Referenz wurde in diesem Shop keine iPay88-Zahlung gestartet, zum Beispiel weil ein anderer Shop mit demselben Konto kein Reference prefix oder dasselbe Präfix verwendet.

Die Backend-Benachrichtigung antwortet RETRY: Die Bestellung (oder eine andere Bestellung desselben Warenkorbs) wurde gerade durch die Rückkehr des Kunden oder eine andere Benachrichtigung bestätigt, oder der Bestellstatus konnte nicht gesetzt werden. iPay88 sendet die Benachrichtigung erneut.

Die Backend URL zeigt im Browser BAD REQUEST: Das ist normal. Die URL akzeptiert nur signierte Anfragen von iPay88.

Die Bestellung ist im On Hold (Review) Status: iPay88 hat eine Zahlung gemeldet, die nicht zur Bestellung passt, oder die Bestellung war storniert worden. Lesen Sie die Notizen auf der Registerkarte VibeFox iPay88 Payment und prüfen Sie die Zahlung im iPay88-Portal; anschließend schließen Sie die Bestellung ab oder erstatten die Zahlung.

Der Kunde sieht „iPay88 cannot accept payments in“ mit einer Währung: Die Kassenwährung kann in der gewählten Region nicht belastet werden. Bei iPay88 Malaysia benötigen Währungen außer MYR außerdem die Mehrwährungsoption in Ihrem iPay88-Konto.

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

Echte Kunden werden nur mit 1,00 belastet: Test mode ist aktiviert. Deaktivieren Sie ihn.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox iPay88 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 im Bereich Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 zusätzlich deren Ereignisse und Startup-Aktion, die die iPay88-Antworten im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Einstellungen (Titel, Beschreibung, Region, Merchant Code und Key, Signaturtyp, Zahlungsart, Präfix, Testmodus, Schalter des Debug-Logs) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die iPay88-Zahlungsdatensätze der Bestellungen bleiben immer erhalten. Bestellungen werden nie gelöscht und 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 iPay88 Payment 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.

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