VibeFox ECPay for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv.

PHP: 8.0 oder neuer.

Shopwährung: neuer Taiwan-Dollar (TWD). ECPay rechnet ausschließlich in TWD ab, und die Zahlungsmethode wird ausgeblendet, wenn der Shop oder die zu bezahlende Bestellung eine andere Währung verwendet. Beträge werden in ganzen TWD gesendet, da ECPay keine Dezimalstellen akzeptiert: Bestellsummen werden auf den nächsten Dollar gerundet. Verwenden Sie 0 Dezimalstellen für TWD-Preise, um Rundungen zu vermeiden.

ECPay-Konto: Für Live-Zahlungen benötigen Sie MerchantID, HashKey und HashIV Ihres ECPay-Händlerkontos aus dem ECPay-Händler-Backoffice (vendor.ecpay.com.tw). Zum Testen ist kein ECPay-Konto erforderlich.

Zugriff auf die Website: Ihre Website muss aus dem Internet über HTTP/HTTPS auf Port 80/443 erreichbar sein, damit ECPay Zahlungsbenachrichtigungen zustellen kann. Wartungsmodus, eine Firewall oder eine Basisauthentifizierung vor der Website blockieren sie.

VibeFox-Lizenzschlüssel: gekauft auf vibefox.net. 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. Sie können den Ordner wcp_ecpay_payment_gateway auch per FTP in /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate. WooCommerce muss aktiv sein.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > ECPay (綠界) > Manage, oder klicken Sie auf Settings unter dem Plugin-Namen auf der Plugins-Seite.

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

5. Aktivieren Sie Enable/Disable, wählen Sie die Zahlungsmethoden aus und lassen Sie Test Mode für Ihre ersten Tests aktiviert. In der Sandbox können Sie mit der ECPay-Testkarte 4311-9522-2222-2222 bezahlen (beliebiges zukünftiges Ablaufdatum, CVV 222, 3-D-Secure-Code von der Sandbox-Seite).

6. Geben Sie für Live-Zahlungen MerchantID, HashKey und HashIV ein (siehe Konfiguration) und deaktivieren Sie Test Mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > ECPay (綠界). Über den Feldern zeigt die Seite einen Fehler, wenn die Shopwährung nicht TWD ist (ECPay wird dann an der Kasse nicht angezeigt) und wenn im Live-Modus MerchantID, HashKey und HashIV fehlen. Solange der Testmodus aktiviert ist, warnt die Seite, dass Zahlungen an die ECPay-Sandbox mit dem öffentlichen Testhändler 3002607 gehen, dass kein Geld eingezogen wird und dass jeder, der die öffentlichen Sandbox-Schlüssel kennt, Testbestellungen bestätigen könnte, weshalb der Testmodus deaktiviert werden muss, bevor Sie echte Bestellungen annehmen.

Allgemein

Enable/Disable: Enable ECPay Payment schaltet die Zahlungsmethode ein oder aus. Standard: deaktiviert.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: ECPay (綠界).

Description: der Text, der unter der Zahlungsmethode an der Kasse angezeigt wird. Standard: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode).

ECPay-Konto

Sie finden Ihre MerchantID, HashKey und HashIV im ECPay-Händler-Backoffice (vendor.ecpay.com.tw) unter System development management > System integration settings (系統開發管理 > 系統介接設定).

Test Mode: Enable sandbox/test mode sendet Zahlungen an die ECPay-Sandbox (payment-stage.ecpay.com.tw) mit dem öffentlichen ECPay-Testhändler 3002607. Kein echtes Geld. Die untenstehenden Zugangsdaten werden nur verwendet, wenn der Testmodus deaktiviert ist. Standard: aktiviert.

Merchant ID: Ihre ECPay Merchant ID (Produktion). Wird im Testmodus ignoriert.

Hash Key: Ihr ECPay Hash Key (Produktion). Wird im Testmodus ignoriert.

Hash IV: Ihre ECPay Hash IV (Produktion). Wird im Testmodus ignoriert.

Leerzeichen und Zeilenumbrüche in eingefügten Zugangsdaten machen jede Signatur ungültig, daher werden sie beim Speichern entfernt, und die Seite weist Sie darauf hin.

Zahlungsoptionen

Enabled Payment Methods: die den Kunden angebotenen Methoden. Bei mehr als einer wählt der Kunde an der Kasse. ATM-, CVS- und Barcode-Bestellungen bleiben In Wartestellung, bis der Kunde bezahlt. Mindestens eine Methode muss ausgewählt sein; ist keine ausgewählt, wird Credit Card aktiviert. Standard: Credit Card.

Default Payment Method: die vorausgewählte Methode. Sie muss eine der aktivierten Methoden sein; andernfalls wird die erste aktivierte Methode verwendet. Standard: Credit Card.

Order Prefix: das Präfix der ECPay-Transaktionsnummer (MerchantTradeNo), bis zu 5 Buchstaben oder Ziffern. Andere Zeichen werden beim Speichern entfernt. Nützlich, wenn sich mehrere Shops ein ECPay-Konto teilen: Geben Sie jedem Shop sein eigenes Präfix. Standard: EC.

Zahlungsbenachrichtigungen

ECPay sendet Zahlungsergebnisse an Ihren Shop. Dieser Abschnitt zeigt die Benachrichtigungs-URL. Sie sieht so aus: https://your-site/wc-api/ecpay_p_callback/. Die URL wird mit jeder Zahlung gesendet, sodass in ECPay nichts konfiguriert werden muss, sie muss jedoch aus dem Internet über Port 80/443 erreichbar sein, ohne Wartungsmodus, Firewall oder Basisauthentifizierung davor.

Jede Benachrichtigung wird anhand ihrer CheckMacValue-Signatur mit den Schlüsseln der Umgebung (Test oder Live) geprüft, in der die Zahlung gestartet wurde. Benachrichtigungen ohne gültige Signatur werden abgelehnt, und ECPay sendet sie erneut. Ohne die Benachrichtigung wird keine Bestellung als bezahlt markiert; prüfen Sie die Zahlung im ECPay-Backoffice.

Erweitert

Enable Logging: Log payment events and API calls schreibt Bestell-IDs, Transaktionsnummern, Beträge und ECPay-Rückgabecodes in WooCommerce > Status > Logs, Quelle wcp_ecpay_payment_gateway. Es werden keine Schlüssel oder Kundendaten protokolliert. Standard: deaktiviert.

Delete Data on Uninstall: Delete all plugin data when uninstalling. Entfernt alle Einstellungen, Protokolle und Bestellmetadaten dieses Plugins. Standard: deaktiviert.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig ECPay (綠界)). Sind mehrere Methoden aktiviert, wählt der Kunde zusätzlich Credit Card, ATM (Virtual Account), CVS (Convenience Store) oder Barcode. Solange der Testmodus aktiviert ist, zeigt die Zahlungsmethode TEST MODE — ECPay sandbox, no real money is charged.

Nach der Bestellung sieht der Kunde Redirecting to ECPay for payment. Please wait... und wird auf die ECPay-Zahlungsseite weitergeleitet, mit einer Schaltfläche Proceed to ECPay für den Fall, dass die Weiterleitung nicht startet. Die Bestellsumme wird in ganzen TWD mit den Namen und Mengen der Artikel gesendet. Die ECPay-Seite öffnet sich in traditionellem Chinesisch für die Websprachen Taiwanesisch und Hongkong-Chinesisch, in vereinfachtem Chinesisch, Koreanisch oder Japanisch für diese Sprachen und in Englisch für alle anderen.

Die Bestellung wird erst als bezahlt markiert, wenn ECPay sie mit einer signierten Servermeldung bestätigt. Kehrt der Kunde zur Seite „Bestellung erhalten“ zurück, bevor die Bestätigung eingetroffen ist, zeigt die Seite We have not received a payment confirmation from ECPay for this order yet. If you did not complete the payment, you can try again: mit einer Schaltfläche Pay.

Bei ATM, CVS und Barcode erhält der Kunde zunächst die Zahlungsdetails. Die Bestellung wird auf In Wartestellung gesetzt, und der Bankcode und das virtuelle Konto, der Zahlungscode für Convenience-Stores oder die Barcodes, der Betrag und das Datum Pay before werden unter ECPay payment instructions auf der Dankeseite, unter My account > Orders und in der E-Mail zur Bestellung in Wartestellung angezeigt. Wenn der Kunde zahlt, sendet ECPay eine weitere Benachrichtigung, und die Bestellung wird als bezahlt markiert.

Jeder Aufruf der Zahlungsseite erzeugt eine neue ECPay-Transaktionsnummer, da ECPay wiederverwendete Nummern ablehnt. So funktionieren die Seite Pay for order und Wiederholungsversuche nach einer fehlgeschlagenen Zahlung, und Benachrichtigungen für jede dieser Nummern werden der Bestellung zugeordnet. Eine Bestellung kann bis zu 30 Zahlungsversuche haben.

Die eigenen Betragslimits von ECPay je Methode, zum Beispiel für Zahlungen in Convenience-Stores, werden auf der ECPay-Seite geprüft, nicht an der Kasse.

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 akzeptiert nur Einmalzahlungen auf der ECPay-Seite. Es unterstützt keine Erstattungen aus WooCommerce, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen (定期定額), keine Ratenzahlungen, Apple Pay, TWQR, WeChat Pay, BNPL, WebATM, E-Rechnungen oder Logistik, und keine serverseitige Statusabfrage: Kann Ihre Website die Benachrichtigung nicht empfangen, prüfen Sie die Zahlung im ECPay-Backoffice.

Bestellungen

Bestellstatus

Pending payment: Der Kunde wurde zu ECPay weitergeleitet und hat noch nicht bezahlt, oder die Benachrichtigung ist noch nicht eingetroffen.

On hold, waiting for payment: Der Kunde hat ATM, CVS oder Barcode gewählt und die Zahlungsdetails erhalten. Die Bestellnotiz zeigt den Bankcode und das virtuelle Konto, den Zahlungscode oder die Barcodes und die Frist.

Processing: Die Zahlung wurde bestätigt (der WooCommerce-Standard; Bestellungen mit ausschließlich virtuellen herunterladbaren Produkten werden zu Abgeschlossen). Die Bestellnotiz zeigt die ECPay-TradeNo, die Zahlungsart, den Betrag und die Transaktionsnummer. Die Transaktions-ID ist die ECPay-TradeNo.

On hold after payment: ECPay meldete einen anderen Betrag oder eine andere Währung als die Bestellung, eine Sandbox-Zahlung traf ein, nachdem Sie in den Live-Modus gewechselt hatten (es wurde kein echtes Geld eingezogen), oder die Zahlung traf ein, nachdem die Bestellung storniert worden war. Die Bestellnotiz erklärt dies. Vergleichen Sie mit dem ECPay-Backoffice und schließen Sie die Bestellung manuell ab oder erstatten Sie sie.

Failed: ECPay meldete, dass der letzte Zahlungsversuch fehlgeschlagen ist. Die Notiz zeigt den ECPay-Rückgabecode und die Meldung. Der Kunde kann es erneut versuchen.

Wiederholte Benachrichtigungen werden ignoriert. Eine bezahlte, stornierte oder erstattete Bestellung wird durch eine alte Benachrichtigung nie wieder geöffnet. Eine zweite Zahlung für eine bereits bezahlte Bestellung, zum Beispiel aus zwei Browser-Tabs, wird als Bestellnotiz erfasst, damit Sie sie im ECPay-Backoffice erstatten können. Simulierte Zahlungen, die aus dem ECPay-Backoffice gestartet werden, werden nur vermerkt und markieren die Bestellung nie als bezahlt, da ECPay dafür kein Geld einzieht.

Erstattungen

Erstattungen aus WooCommerce sind nicht verfügbar. Erstatten Sie die Zahlung im ECPay-Backoffice und erfassen Sie die Erstattung anschließend manuell in WooCommerce.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben auf WooCommerce > Settings > Payments > ECPay (綠界). 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 aktiv ist, und Ihre Domain. Verwenden Sie Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um ihn von dieser Website zu entfernen. 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 den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird ECPay den 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), sodass Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Ein Hinweis erscheint auf der Plugins-Seite und auf den WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt.

Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

ECPay wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable aktiviert ist, die Shopwährung TWD ist und im Live-Modus Merchant ID, Hash Key und Hash IV eingetragen sind. Die Einstellungsseite zeigt in jedem dieser Fälle einen Fehler an.

Die Zahlung wurde durchgeführt, aber die Bestellung bleibt bei Zahlung ausstehend: Die ECPay-Benachrichtigung hat Ihre Website nicht erreicht (Website nicht erreichbar, Firewall, Wartungsmodus, Basisauthentifizierung). ECPay versucht es mehrmals erneut. Sie können die Transaktion auch im ECPay-Backoffice prüfen und die Bestellung manuell abschließen. Aktivieren Sie Enable Logging, um die vom Plugin empfangenen Benachrichtigungen zu sehen.

Die Benachrichtigung antwortet 0|CheckMacValue verification failed: Der Hash Key oder die Hash IV stimmt nicht mit Ihrem ECPay-Konto überein. Kopieren Sie sie erneut aus dem ECPay-Backoffice.

Die Benachrichtigung antwortet 0|MerchantID mismatch: Die Benachrichtigung gehört zu einem anderen ECPay-Händler als dem, mit dem die Zahlung gestartet wurde.

Die Benachrichtigung antwortet 0|Order not found: Die Transaktionsnummer wurde nicht von diesem Shop ausgestellt, zum Beispiel wenn sich mehrere Shops ein ECPay-Konto teilen. Geben Sie jedem Shop sein eigenes Order Prefix.

Der Kunde sieht The order total is too small for ECPay.: Die Bestellsumme liegt nach der Rundung unter 1 TWD und kann mit ECPay nicht bezahlt werden.

Die Bestellung ist In Wartestellung mit einer Notiz zu einer Betragsabweichung: Der von ECPay gemeldete Betrag weicht von der Bestellsumme ab, zum Beispiel weil die Bestellung bearbeitet wurde, nachdem der Kunde mit dem Bezahlen begonnen hatte. Vergleichen Sie mit dem ECPay-Backoffice und schließen Sie die Bestellung manuell ab oder erstatten Sie sie.

Die Bestellung ist In Wartestellung nach einer Sandbox-Zahlung: Die Zahlung wurde im Testmodus vorgenommen, der Shop befindet sich jetzt aber im Live-Modus. Es wurde kein echtes Geld eingezogen. Prüfen Sie die Bestellung manuell.

Der Kunde sieht Too many payment attempts for this order: Die Bestellung hat 30 Zahlungsversuche erreicht. Bitten Sie den Kunden, eine neue Bestellung aufzugeben.

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

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. Deaktivieren und löschen Sie es zum Entfernen auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen, die bei den Bestellungen gespeicherten ECPay-Daten und die Protokolle werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

ECPay ist eine Marke des jeweiligen Inhabers. Dieses Plugin steht in keiner Verbindung zu ECPay und wird nicht von ECPay empfohlen.