VibeFox iPay88 for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

iPay88-Händlerkonto: Merchant Code und Merchant Key stellt iPay88 aus, sobald Ihr Händlerkonto freigeschaltet ist. Sie werden außerdem 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.

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

Shopwährung: Malaysia: MYR, und USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP oder THB, sofern die Mehrwährungsoption in Ihrem iPay88-Konto aktiviert ist; Philippines: PHP oder USD; Indonesia: IDR; Thailand: THB.

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_ipay88_payment per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > iPay88 > Manage, oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Wählen Sie Ihre iPay88 region und geben Sie den Merchant Code und den Merchant Key ein (siehe Konfiguration).

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

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > iPay88. Über den Feldern warnt die Seite, wenn Merchant Code oder Merchant Key fehlt (die Zahlungsmethode wird dann nicht an der Kasse angezeigt), wenn die Shopwährung in der gewählten Region nicht belastet werden kann und solange der Testmodus aktiv ist. In der Liste der Zahlungsmethoden ist iPay88 als einrichtungsbedürftig markiert, bis beide Schlüssel eingegeben sind, und zeigt ein Testmodus-Kennzeichen, solange der Testmodus aktiv ist.

Allgemein

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. 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 legt die iPay88-Zahlungsseite und die Währungen fest, die belastet werden können. Die Bestellung wird immer in ihrer eigenen Währung belastet. Standard: Malaysia.

Malaysia (payment.ipay88.com.my): MYR sowie die übrigen Währungen aus den Anforderungen, sofern die Mehrwährungsfunktion in Ihrem Konto aktiviert ist.

Philippines (payment.ipay88.com.ph): PHP, USD.

Indonesia (payment.ipay88.co.id): IDR, ohne Dezimalstellen übermittelt.

Thailand (payment.ipay88.co.th): THB.

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.

Signature type: legt fest, wie Zahlungsanfragen signiert werden. Antworten werden in beiden Formaten geprüft.

SHA256 (recommended): die aktuelle iPay88-Spezifikation (Standard).

SHA1 (legacy): wählen Sie diese Option nur, wenn iPay88 Sie gebeten hat, die alte Signatur zu verwenden.

Zahlung

Payment method: wählen Sie eine iPay88-Zahlungsmethode aus der malaysischen PaymentId-Liste vor, oder lassen Sie Let the customer choose on the iPay88 page (Standard) aktiv. 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 Bestellnummer in der iPay88-Referenz (RefNo) eingefügt, zum Beispiel SHOP1-. Verwenden Sie in jedem Shop, der dasselbe iPay88-Konto nutzt, ein eigenes Präfix, damit eine Antwort des einen Shops nie auf eine Bestellung eines anderen angewendet werden kann. Erlaubt sind Buchstaben, Ziffern, „-“ und „_“, bis zu 10 Zeichen. Ein Präfix, das auf eine Ziffer endet, wird beim Speichern korrigiert, weil die Bestellnummer vom Ende der Referenz gelesen wird.

Test mode: Charge a fixed test amount instead of the order total. iPay88 hat keine getrennte 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, zeigt die Kasse TEST MODE: only a test amount of ... will be charged. Lassen Sie den Testmodus in einem Live-Shop nie eingeschaltet. Standard: aus.

Antwort- und Backend-URLs

Das Plugin übermittelt beide URLs bei jeder Zahlung, daher ist nichts zu konfigurieren. Falls iPay88 sie anfordert, kopieren Sie sie aus diesem Abschnitt der Einstellungen. Sie sehen so aus: https://your-site/wc-api/ipay88_p_response/ (Response URL, die Rückkehr des Kunden) und https://your-site/wc-api/ipay88_p_backend/ (Backend URL, die serverseitige Benachrichtigung). Der Abschnitt zeigt außerdem Ihre Website-Adresse, die bei iPay88 als Request URL registriert sein muss.

Beide Antworten von iPay88 werden gleich geprüft: die Signatur mit Ihrem Merchant Key, die Referenz einer Zahlung, die dieser Shop für diese Bestellung gestartet hat, der Betrag und die Währung. Anfragen 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. iPay88 meldet folgende Zahlungsstatus:

1 (Erfolg): Die Zahlung wurde durchgeführt. Die Bestellung wird nach der Prüfung von Betrag und Währung als bezahlt markiert.

6 (ausstehend): Die Zahlung wartet noch, zum Beispiel auf eine Überweisung am Geldautomaten oder auf ein virtuelles Konto. Die Bestellung wird auf Wartestellung gesetzt, bis iPay88 die Zahlung bestätigt oder fehlschlagen lässt.

Jeder andere Status: Die Zahlung ist fehlgeschlagen oder wurde abgebrochen. Die Bestellung wird mit dem Grund von iPay88 auf Fehlgeschlagen gesetzt.

Erweitert

Debug log: Log payment requests and iPay88 responses unter WooCommerce > Status > Logs, Quelle wcp_ipay88_payment, ohne personenbezogene Daten und Signaturen. Fehler werden immer protokolliert. Standard: aus.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. Bestellungen selbst werden nie gelöscht. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig iPay88) und gibt die Bestellung auf. Die Bestellung bleibt im Status Pending payment, und der Kunde sieht Redirecting to iPay88 payment gateway..., während ein Formular an die iPay88-Zahlungsseite Ihrer Region gesendet wird. Ohne JavaScript klickt der Kunde auf Pay Now. Die Bestellpositionen sowie Name, E-Mail-Adresse und Telefonnummer des Kunden werden an iPay88 übergeben. Auf der iPay88-Seite zahlt der Kunde per Karte, FPX-Online-Banking, E-Wallet oder einer anderen Methode, die Ihr Konto anbietet.

Nach der Zahlung kehrt der Kunde auf die Seite „Bestellung eingegangen“ Ihres Shops zurück. 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. Ist die Bestätigung noch nicht eingegangen, zeigt die Seite We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. Bei einer ausstehenden Zahlung zeigt sie Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.

Ist die Zahlung fehlgeschlagen oder abgebrochen worden, landet der Kunde auf der Seite Pay for order mit The payment was not completed: und dem Grund von iPay88 und kann erneut zahlen oder eine andere Zahlungsmethode wählen. Lässt sich die Antwort nicht prüfen, 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 Link zurück zum Shop.

Der Lagerbestand wird reduziert, sobald die Zahlung bestätigt ist, nicht bei der Weiterleitung des Kunden. Die Zahlungsmethode funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin unterstützt nur Einmalzahlungen. Es bietet keine Erstattungen aus WooCommerce, keine gespeicherten Karten, keine Abonnements, keine Vorautorisierung und Erfassung und keine Kartenfelder auf Ihrer Website. Der Zahlungsstatus wird nicht bei iPay88 abgefragt: Bestellungen werden nur durch die Antwort von iPay88 und die Backend-Benachrichtigung aktualisiert. Die iPay88-Indonesia-API 2.0 (JSON / Zahlungslink) wird nicht verwendet.

Bestellungen

Order statuses

Pending payment: Der Kunde wurde zu iPay88 weitergeleitet und hat noch nicht bezahlt, oder iPay88 hat die Zahlung noch nicht bestätigt.

Processing or Completed: Die Zahlung wurde bestätigt. WooCommerce setzt den üblichen Status für eine bezahlte Bestellung. Die Bestellnotiz zeigt die iPay88-TransID, PaymentID, den Betrag und die Währung. Die Transaktionsnummer ist die iPay88-TransID. Im Testmodus weist eine zweite Notiz darauf hin, dass der Testbetrag statt der Bestellsumme belastet wurde.

On hold, pending at iPay88: iPay88 hat die Zahlung als ausstehend gemeldet. Die Bestellung wird aktualisiert, sobald iPay88 die Zahlung bestätigt oder fehlschlagen lässt.

On hold, for review: 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 wurde. Die Bestellung wurde nicht als bezahlt markiert. Die Bestellnotiz erklärt dies. Prüfen Sie die Zahlung im iPay88-Portal und führen Sie die Bestellung aus oder erstatten Sie die Zahlung.

Failed: Die Zahlung ist fehlgeschlagen oder wurde abgebrochen. Die Notiz zeigt den Grund von iPay88. Der Kunde kann erneut zahlen.

Geht eine weitere erfolgreiche Zahlung für eine Bestellung ein, die bereits bezahlt oder erstattet ist, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, sie im iPay88-Portal zu prüfen und bei einer Doppelzahlung zu erstatten. Eine fehlgeschlagene Antwort ändert nie eine bezahlte, erstattete oder stornierte Bestellung.

Erstattungen

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

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > iPay88. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne 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. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugin-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

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 Shopwährung in der gewählten iPay88 region belastet werden kann. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt.

Die Zahlung war erfolgreich, aber die Bestellung bleibt im Status Pending payment: Weder die Rückkehr des Kunden noch die Backend-Benachrichtigung haben Ihren Shop mit einer gültigen Signatur erreicht. Aktivieren Sie das Debug log und prüfen Sie WooCommerce > Status > Logs, Quelle wcp_ipay88_payment. Kontrollieren Sie, dass der Merchant Key exakt dem von iPay88 erhaltenen entspricht und dass Ihre Website Anfragen von iPay88 an der in den Einstellungen angezeigten Backend URL empfangen kann.

Die iPay88-Seite zeigt „Permission not allow“: Ihre Website-Adresse ist bei iPay88 nicht als Request URL registriert. Bitten Sie iPay88, die im Abschnitt Response and 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.

Die Backend-Benachrichtigung antwortet NOT CONFIGURED: Merchant Code oder Merchant Key sind nicht gesetzt, daher kann die Antwort nicht geprüft 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 Bestellung ist On hold mit einer Notiz zu Betrag oder Währung: iPay88 hat eine Zahlung gemeldet, die nicht zur Bestellung passt, oder die Bestellung war storniert worden. Die Bestellung wurde nicht als bezahlt markiert. Prüfen Sie die Zahlung im iPay88-Portal und schließen Sie sie ab oder erstatten Sie sie.

Der Kunde sieht „iPay88 cannot accept payments in“ mit einer Währung: Die Bestellwä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: Der Test mode ist aktiv. Schalten Sie ihn aus.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Entwickler können die URL der Zahlungsseite, die Währungen, die Dezimalstellen, den Testbetrag und das Symbol mit den Filtern ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount und ipay88_p_icon ändern.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen, die Protokolle und die auf Bestellungen gespeicherten iPay88-Daten werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestellungen selbst werden nie gelöscht und behalten ihre Zahlungsnotizen und Transaktionsnummern.

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