VibeFox iPay88 for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

iPay88-Händlerkonto: Merchant Code und Merchant Key stellt iPay88 aus, sobald Ihr Händlerkonto freigeschaltet ist. Sie werden auch im iPay88-Händlerportal angezeigt. Wenn Sie noch kein Händler sind, beantragen Sie das auf der Website von iPay88. Halten Sie den Merchant Key geheim: Er signiert die Zahlungen. iPay88 hat keine separate Sandbox, daher gibt es keine Testschlüssel.

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

Währung: Malaysia — MYR, sowie USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP oder THB, falls die Mehrwährungsoption in Ihrem iPay88-Konto aktiviert ist; Philippines — PHP oder USD; Indonesia — IDR; Thailand — THB. Kann die Warenkorbwährung in Ihrer Region nicht belastet werden, wird die Zahlungsmethode an der Kasse ausgeblendet.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

1. Gehen Sie im Back-Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox iPay88 Payment in der Modulliste und klicken Sie auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Wählen Sie Ihre iPay88 region, geben 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 schalten Sie den Testmodus danach wieder aus.

Bei der Installation legt das Modul zwei Bestellstatus an: Awaiting iPay88 payment und iPay88 payment on hold. PrestaShop aktiviert das neue Zahlungsmodul für alle Währungen, Länder und Kundengruppen. Sie können dies unter Payment > Preferences einschränken. Ein Land, das Sie nach der Installation des Moduls aktivieren, muss dort ebenfalls für das Modul angehakt werden; andernfalls sehen Kunden aus diesem Land iPay88 nicht. Die Response- und Backend-URLs werden bei jeder Zahlung übermittelt.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox iPay88 Payment > Configure. Jeder Button Save speichert die gesamte Seite. Oberhalb der Felder zeigt die Seite Geben Sie Merchant Code und Merchant Key von iPay88 ein – bis dahin wird die Zahlungsmethode an der Kasse nicht angezeigt., solange ein Schlüssel fehlt, eine Warnung, wenn die Standardwährung des Shops in der gewählten Region nicht belastet werden kann (die Zahlungsmethode wird dann an der Kasse ausgeblendet), und eine Warnung, solange der Testmodus aktiv ist.

iPay88

Enable/Disable: Enable iPay88 Payment Gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsmethode in der Bestellung gespeichert. Standard: iPay88.

Description: der Text, der an der Kasse unter der Zahlungsmethode angezeigt wird. Standard: Pay securely via iPay88 (credit card, online banking, e-wallet).

iPay88-Konto

iPay88 region: das Land Ihres iPay88-Händlerkontos. Sie 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. Der gespeicherte Schlüssel wird nie wieder angezeigt: Das Feld bleibt leer und zeigt Gespeichert – zum Beibehalten leer lassen. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern wollen. Der Schlüssel wird genau so gespeichert, wie Sie ihn eingeben, einschließlich Anführungszeichen und Backslashes.

Clear saved secret: Setzen Sie den Haken bei Merchant Key und klicken Sie auf Save, um den gespeicherten Schlüssel zu entfernen. Ein leeres Feld behält den gespeicherten Wert bei.

Signature type: wie Zahlungsanfragen signiert werden. Antworten werden in beiden Formaten geprüft, daher bleiben Zahlungen, die vor einer Umstellung gestartet wurden, prüfbar.

Zahlung

Payment method: wählen Sie eine iPay88-Zahlungsmethode aus der Malaysia-PaymentId-Liste vor oder lassen Sie Let the customer choose on the iPay88 page (Standard) stehen. 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. Er wird vor der Warenkorbnummer in der iPay88-Referenz (RefNo) eingefügt, zum Beispiel SHOP1-. Verwenden Sie in jedem Shop, der dasselbe iPay88-Konto nutzt, ein anderes Präfix, damit die Antwort eines Shops nie auf den Warenkorb eines anderen angewendet wird. Erlaubt sind Buchstaben, Ziffern, „-“ und „_“, bis zu 10 Zeichen. Andere Zeichen werden beim Speichern entfernt, und ein Präfix, das auf eine Ziffer endet, erhält „-“ am Ende, weil die Warenkorbnummer am Ende der RefNo gelesen wird. Die Seite zeigt danach den gespeicherten Wert an. Wenn Sie mit demselben iPay88-Konto von WooCommerce zu PrestaShop wechseln, legen Sie ein Präfix fest, damit neue Referenzen nie alte Bestellnummern wiederholen.

Test mode: Charge a fixed test amount instead of the order total. iPay88 hat keine separate Sandbox: Testzahlungen sind echte Transaktionen auf der Live-Seite 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, zeigt die Kasse TEST MODE: only a test amount of ... will be charged. an. Eine im Testmodus gestartete Zahlung wird immer gegen den Testbetrag geprüft, auch wenn Sie den Testmodus ausschalten, bevor iPay88 antwortet. Lassen Sie den Testmodus in einem Live-Shop niemals aktiviert. Standard: aus.

Response- und Backend-URLs

Das Modul übermittelt beide URLs bei jeder Zahlung, daher ist nichts zu konfigurieren. Falls iPay88 sie anfordert, kopieren Sie sie aus diesem Abschnitt. Mit suchmaschinenfreundlichen URLs sehen sie so aus: https://your-shop/module/wcp_ipay88_payment/response (Response URL, die Rückkehr des Kunden) und https://your-shop/module/wcp_ipay88_payment/backend (Backend URL, die serverseitige Benachrichtigung), gegebenenfalls mit einem Sprachkürzel wie /en/. Der Abschnitt zeigt außerdem die Adresse Ihrer Website, die bei iPay88 als Request URL registriert sein muss.

Beide Antworten von iPay88 werden gleich geprüft: die Pflichtfelder, die mit Ihrem Merchant Key erzeugte Signatur und die Referenz einer Zahlung, die dieser Shop für diesen Warenkorb gestartet hat. Antworten ohne gültige Signatur werden abgelehnt und ändern nie einen Warenkorb oder eine Bestellung. Die Backend-Benachrichtigung wird erst nach der Verarbeitung mit RECEIVEOK beantwortet; andernfalls sendet iPay88 sie erneut. Sie funktioniert auch, wenn der Shop im Wartungsmodus ist, und wird nicht durch die Ländereinschränkung Ihres Shops blockiert. iPay88 meldet diese Zahlungsstatus:

Erweitert

Debug log: protokolliert Zahlungsanfragen und Antworten von iPay88 in logs/ipay88_p_debug.log.php im Modulordner. Die Datei kann nicht über das Web aufgerufen werden. Es werden keine personenbezogenen Daten, kein Merchant Key und keine Signaturen protokolliert. Fehler und Warnungen werden immer protokolliert, auch wenn der Schalter aus 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: löscht beim Deinstallieren des Moduls die Einstellungen, Protokolle und iPay88-Zahlungsdaten. Bestellungen und Bestellstatus werden nie gelöscht. Standard: aus.

Kasse

Im Zahlungsschritt wählt der Kunde die Zahlungsmethode (standardmäßig iPay88) und bestätigt. Die nächste Seite zeigt Redirecting to iPay88 payment gateway... und Please do not close this window., während ein Formular an die iPay88-Zahlungsseite Ihrer Region gesendet wird. Ohne JavaScript klickt der Kunde auf Pay Now. Zu diesem Zeitpunkt existiert noch keine Bestellung. Das Modul übergibt die Warenkorbsumme in der Warenkorbwährung (im Testmodus den Testbetrag), die Produktnamen sowie Name, E-Mail-Adresse und Telefonnummer des Kunden. Auf der iPay88-Seite zahlt der Kunde per Karte, FPX-Online-Banking, E-Wallet oder einer anderen Methode, die Ihr Konto anbietet.

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. Nach einer erfolgreichen Zahlung wird die Bestellung angelegt, und der Kunde sieht die übliche Bestellbestätigungsseite 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 auf Wartestellung zeigt sie We have received a payment notification from iPay88 and are reviewing it. We will contact you if anything is needed. Befindet sich die Bestellung in Payment error oder wurde sie storniert, zeigt sie The payment was not completed. Please contact us.

Wenn die Bestätigung im selben Moment durch die Backend-Benachrichtigung verarbeitet wird, 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 Buttons Check again und Back to checkout.

Ist die Zahlung fehlgeschlagen oder wurde sie abgebrochen, wird keine Bestellung angelegt und der Warenkorb bleibt erhalten. Der Kunde kehrt zur Kasse zurück, mit The payment was not completed: und dem Grund von iPay88, gefolgt von You can try again or choose another payment method. Jeder Versuch mit demselben Warenkorb 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 einem Button Return to the store.

Kann die Zahlung nicht gestartet werden, kehrt der Kunde zur Kasse zurück, mit This payment method is temporarily unavailable. Please choose another payment method. (Schlüssel fehlen oder Gesamtsumme null) oder iPay88 cannot accept payments in ... Please choose another payment method. (Währung in der Region nicht belastbar). Hat der Warenkorb bereits eine Bestellung (bezahlt oder wartend auf eine ausstehende Zahlung), wird kein zweites Zahlungsformular erzeugt und der Kunde wird zur Bestellbestätigungsseite geleitet.

Das Modul unterstützt nur Einmalzahlungen. Es bietet keine Erstattungen aus PrestaShop, keine gespeicherten Karten, keine Abonnements, keine Vorautorisierung und Erfassung und keine Kartenfelder auf Ihrer Website. Den Zahlungsstatus fragt es bei iPay88 nicht erneut ab: Bestellungen werden nur durch die Antwort von iPay88 und die Backend-Benachrichtigung aktualisiert.

Bestellungen

Order statuses

No order yet: Der Kunde wurde zu iPay88 geschickt, und noch ist kein Ergebnis eingegangen, oder die Zahlung ist fehlgeschlagen. Es existiert nur der Warenkorb.

Payment accepted: iPay88 hat eine erfolgreiche Zahlung mit dem erwarteten Betrag und der erwarteten Währung gemeldet. Die Zahlung wird mit der iPay88-TransId als Transaktions-ID erfasst. Eine interne Notiz zeigt TransID, PaymentID, Betrag und Währung. Im Testmodus weist eine zweite Notiz darauf hin, dass statt der Bestellsumme der Testbetrag belastet wurde.

Awaiting iPay88 payment: iPay88 hat die Zahlung als ausstehend gemeldet. Die Bestellung wechselt zu Payment accepted, sobald iPay88 sie bestätigt, oder zu Payment error, falls sie fehlschlägt.

Payment error: Eine ausstehende Zahlung ist danach fehlgeschlagen. Die Notiz zeigt den Grund von iPay88. Zu diesem Warenkorb existiert bereits eine Bestellung, daher kann der Kunde nicht erneut zahlen, sondern legt eine neue Bestellung an.

iPay88 payment on hold: iPay88 hat eine erfolgreiche Zahlung mit einem anderen Betrag oder einer anderen Währung als die Bestellung gemeldet, oder die Zahlung ist eingegangen, nachdem die Bestellung storniert worden war. Die Bestellung wurde NICHT als bezahlt markiert. Die Notiz erklärt dies. Prüfen Sie die Zahlung im iPay88-Portal und bearbeiten Sie die Bestellung oder erstatten Sie die Zahlung.

Eine bezahlte oder erstattete Bestellung wird durch eine spätere Antwort nie verändert. Trifft dafür eine weitere erfolgreiche Zahlung ein, fordert eine Notiz Sie auf, sie im iPay88-Portal zu prüfen und bei einem Duplikat zu erstatten. Eine fehlgeschlagene Antwort verändert nie eine bezahlte, erstattete oder stornierte Bestellung. Wiederholte Antworten bringen nichts Neues.

iPay88-Zahlungsblock

Die Bestellseite zeigt einen Block iPay88 payment mit RefNo, TransId, Status, angefordertem Betrag, erhaltenem Betrag, PaymentId, AuthCode, Fehler und Region sowie ein Abzeichen TEST MODE für Testzahlungen.

Erstattungen

Erstattungen werden von PrestaShop aus nicht an iPay88 übermittelt. Erstatten Sie die Zahlung im iPay88-Händlerportal und erfassen Sie die Erstattung anschließend manuell in PrestaShop.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox iPay88 Payment ist der erste Block unter Modules > Module Manager > VibeFox iPay88 Payment > Configure, 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: presta-payment-ipay88 und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (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 nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch in einem Multistore-Setup. Das Entfernen des Schlüssels aus dem Shop gibt dessen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne einen aktiven Schlüssel wird iPay88 Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird die Zahlungsmethode auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber in der Kasse nicht testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cronjob ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

iPay88 erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Merchant Code und Merchant Key eingetragen sind und die Warenkorbwährung in der gewählten iPay88 region belastet werden kann. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie unter Payment > Preferences, ob das Modul für die Warenkorbwährung, das Land des Kunden und die Kundengruppe zugelassen ist.

Die Zahlung ist durchgegangen, aber es wurde keine Bestellung angelegt: Weder die Rückkehr des Kunden noch die Backend-Benachrichtigung hat 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 exakt dem entspricht, den Sie von iPay88 erhalten haben, und ob Ihr Server Anfragen von iPay88 an der Backend URL in den Einstellungen annimmt.

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

Die Backend-Benachrichtigung antwortet BAD SIGNATURE: Die Signatur passt nicht zum Merchant Key. Prüfen Sie den Merchant Key. Es wurde nichts verändert.

Die Backend-Benachrichtigung antwortet NOT CONFIGURED: Merchant Code oder Merchant Key sind 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 oder weil die iPay88-Zahlungsdaten bei der Deinstallation gelöscht wurden.

Die Backend-Benachrichtigung antwortet RETRY: Der Warenkorb wurde im selben Moment durch die Rückkehr des Kunden bestätigt, oder die Bestellung konnte nicht angelegt werden (zum Beispiel weil das Modul deaktiviert ist). 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 iPay88 payment on hold: iPay88 hat eine Zahlung gemeldet, die nicht zur Bestellung passt, oder die Bestellung war storniert worden. Prüfen Sie die Bestellnotiz und die Zahlung im iPay88-Portal und schließen Sie dann die Bestellung ab oder erstatten Sie die Zahlung.

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

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

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox iPay88 Payment und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus dieses Moduls werden immer entfernt. Die Bestätigung besagt, dass Einstellungen und iPay88-Zahlungsdaten erhalten bleiben, sofern Delete data on uninstall nicht aktiviert ist. Ist es aktiviert, werden Einstellungen, Protokolle und iPay88-Zahlungsdaten entfernt. Ist es deaktiviert, bleibt alles für eine spätere Neuinstallation erhalten. Die Bestellstatus Awaiting iPay88 payment und iPay88 payment on hold bleiben immer erhalten. Bestellungen werden nie gelöscht und behalten ihre Zahlungsnotizen und Transaktions-IDs.

iPay88 ist eine Marke ihres jeweiligen Inhabers. Dieses Modul steht in keiner Verbindung zu iPay88 und wird von iPay88 nicht unterstützt.