VibeFox ECPay 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.
Währung: Neuer Taiwan-Dollar (TWD). ECPay rechnet nur in TWD ab, daher wird die Zahlungsart nur angezeigt, wenn der Kunde in TWD zur Kasse geht. Fügen Sie TWD mit dem Code TWD unter System > Localisation > Currencies hinzu, falls Ihr Shop diese Währung nicht hat. Beträge werden in ganzen TWD übermittelt, da ECPay keine Dezimalstellen akzeptiert: Bestellsummen werden auf den nächsten Dollar gerundet. Verwenden Sie für TWD 0 Dezimalstellen, um Rundungen zu vermeiden.
ECPay-Konto: Für Live-Zahlungen benötigen Sie die MerchantID, den HashKey und den HashIV Ihres ECPay-Händlerkontos aus dem Händler-Backoffice von ECPay (vendor.ecpay.com.tw). Zum Testen wird kein ECPay-Konto benötigt.
Zugriff auf die Website: Ihr Shop muss über HTTP/HTTPS auf Port 80/443 aus dem Internet erreichbar sein, damit ECPay Zahlungsbenachrichtigungen zustellen kann. Eine Firewall oder eine Basis-Authentifizierung vor der Website blockiert sie.
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 Paket für OpenCart 3 wcp_ecpay_payment_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_ecpay_payment_gateway.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_ecpay_payment_gateway-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.
2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox ECPay Payment Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.
3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzblock am Seitenanfang ein und klicken Sie auf Activate (siehe Lizenzschlüssel).
4. Aktivieren Sie Enable/Disable, wählen Sie die Zahlungsarten aus und lassen Sie Test Mode für Ihre ersten Tests eingeschaltet. Klicken Sie auf Save.
5. Für Live-Zahlungen tragen Sie die Merchant ID, den Hash Key und den Hash IV ein (siehe Konfiguration), schalten Test Mode aus und klicken Sie auf Save.
OpenCart 4
1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_ecpay_payment_gateway.ocmod.zip aus. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung 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 ECPay Payment Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).
4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist anders (siehe Zahlungsbenachrichtigungen).
Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus. Die Benachrichtigungs-URL wird bei jeder Zahlung übermittelt, daher muss bei ECPay nichts eingerichtet werden.
Konfiguration
Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite einen Fehler an, wenn die Standardwährung Ihres Shops nicht TWD ist und keine aktivierte TWD-Währung vorhanden ist (ECPay wird dann an der Kasse nicht angezeigt), oder eine Warnung, wenn TWD nur eine zweite Währung ist (ECPay wird dann nur Kunden angezeigt, die in TWD bezahlen). Ein Fehler erscheint, wenn der Live-Modus keine MerchantID, keinen HashKey und keinen HashIV hat. Solange der Testmodus eingeschaltet 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. Deshalb muss der Testmodus ausgeschaltet sein, bevor Sie echte Bestellungen annehmen. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.
Beim Speichern darf Title nicht leer sein (maximal 128 Zeichen), Sort Order muss eine ganze Zahl sein und Total eine Zahl von 0 oder größer; andernfalls wird nichts gespeichert. Andere Korrekturen werden mit einer Meldung oberhalb der Einstellungen gespeichert (siehe die Felder unten).
ECPay (綠界)
Enable/Disable: Enable ECPay Payment schaltet die Zahlungsart ein oder aus. Standard: aus.
Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: ECPay (綠界). Pflichtfeld.
Description: der Text, der dem Kunden im Schritt Confirm Order angezeigt wird. Standard: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode).
Sort Order: die Position von ECPay unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.
Geo Zone: bietet ECPay nur für Rechnungsadressen in der ausgewählten Geozone an. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.
Total: die Warenkorbsumme in der Standardwährung des Shops, die eine Bestellung erreichen muss, bevor ECPay angeboten wird. Lassen Sie das Feld leer, um ECPay bei jeder Summe anzubieten.
ECPay-Konto
Ihre MerchantID, Ihren HashKey und Ihren HashIV finden Sie im Händler-Backoffice von ECPay (vendor.ecpay.com.tw) unter System development management > System integration settings (系統開發管理 > 系統介接設定).
Test Mode: sendet Zahlungen an die ECPay-Sandbox (payment-stage.ecpay.com.tw) mit dem öffentlichen ECPay-Testhändler 3002607. Es wird kein echtes Geld eingezogen. Die unten stehenden Zugangsdaten werden nur verwendet, wenn der Testmodus ausgeschaltet ist. Standard: eingeschaltet. Solange er eingeschaltet ist, sehen Kunden im Schritt Confirm Order den Hinweis TEST MODE — ECPay sandbox, no real money is charged.
Merchant ID: Ihre ECPay Merchant ID (Produktion). Wird im Testmodus ignoriert.
Hash Key: Ihr ECPay Hash Key (Produktion). Wird im Testmodus ignoriert.
Hash IV: Ihr ECPay Hash IV (Produktion). Wird im Testmodus ignoriert.
Leerzeichen und Zeilenumbrüche in eingefügten Zugangsdaten führen bei jeder Signatur zu Fehlern. Sie werden daher beim Speichern entfernt, und die Seite weist Sie darauf hin. Ein gespeicherter Hash Key und ein gespeicherter Hash IV werden nie wieder angezeigt: Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.
Zahlungsoptionen
Enabled Payment Methods: die Zahlungsarten, die Kunden angeboten werden. Bei mehr als einer wählt der Kunde im Schritt Confirm Order. Bestellungen mit ATM, CVS und Barcode bleiben im wartenden Status, bis der Kunde bezahlt. Es muss mindestens eine Zahlungsart ausgewählt sein; ist keine ausgewählt, wird Credit Card aktiviert und die Seite zeigt einen Hinweis. Standard: Credit Card.
Default Payment Method: die vorausgewählte Zahlungsart. Sie muss eine der aktivierten Zahlungsarten sein; andernfalls wird die erste aktivierte Zahlungsart verwendet. Standard: Credit Card.
Order Prefix: das Präfix der ECPay-Transaktionsnummer (MerchantTradeNo), bis zu 5 Buchstaben oder Ziffern. Andere Zeichen werden beim Speichern mit einer Meldung entfernt. Nützlich, wenn mehrere Shops ein ECPay-Konto teilen: Geben Sie jedem Shop ein eigenes Präfix. Standard: EC.
Zahlungsbenachrichtigungen
ECPay sendet Zahlungsergebnisse sowie die Angaben zu ATM, CVS und Barcode an Ihren Shop. Dieser Abschnitt zeigt die Notification URL. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_ecpay_payment_gateway/notify, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_ecpay_payment_gateway/payment/wcp_ecpay_payment_gateway.notify. Die URL wird bei jeder Zahlung übermittelt, daher muss bei ECPay nichts konfiguriert werden. Sie muss aber über Port 80/443 aus dem Internet erreichbar sein, ohne Firewall oder Basis-Authentifizierung davor. Der Wartungsmodus blockiert sie nicht.
Jede Benachrichtigung wird anhand ihrer CheckMacValue-Signatur mit den Schlüsseln der Umgebung (Test oder Live) geprüft, in der die Zahlung gestartet wurde, sowie anhand der MerchantID dieser Zahlung. Benachrichtigungen ohne gültige Signatur werden abgelehnt, und ECPay sendet sie erneut. Ohne die Benachrichtigung erhält die Bestellung keinen Status; prüfen Sie die Zahlung dann im Händler-Backoffice von ECPay.
Bestellungen
OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Sie erhält einen Status erst durch die signierte Benachrichtigung von ECPay. Eine fehlgeschlagene oder abgebrochene Kartenzahlung lässt die Bestellung ohne Status, und der Kunde kann erneut bezahlen. Jedes Feld unten listet Ihre OpenCart-Bestellstatus auf.
Payment accepted: der Status, wenn ECPay die Zahlung mit dem erwarteten Betrag bestätigt. Standard: Processing.
Awaiting ECPay payment: der Status, wenn der Kunde eine virtuelle ATM-Kontonummer, einen CVS-Zahlungscode oder Barcodes erhalten hat und später am Automaten oder im Laden bezahlt. Standard: Pending.
ECPay payment on hold: der Status, wenn ECPay einen anderen Betrag oder eine andere Währung meldet, eine Sandbox-Zahlung im Live-Modus eintrifft oder die Zahlung erst eingeht, nachdem der Bestellstatus geändert wurde (zum Beispiel storniert). Der Bestellvermerk erklärt den 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.
Payment error: der Status, wenn die letzte ATM-, CVS- oder Barcode-Zahlung einer wartenden Bestellung fehlgeschlagen ist. Standard: Failed.
Erweitert
Enable Logging: schreibt Bestellnummern, Transaktionsnummern, Beträge und Rückgabecodes von ECPay in ecpay_p_debug.log.php im Protokollordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach ecpay_p_debug.old.log.php verschoben. Schlüssel und Kundendaten werden nicht protokolliert. Fehler werden immer protokolliert, auch wenn dieser 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: wenn eingeschaltet, entfernt das Deinstallieren der Erweiterung ihre Einstellungen und das Protokoll. Die Zahlungsdatensätze von ECPay bleiben immer erhalten, sodass bestehende Bestellungen nach einer Neuinstallation weiter funktionieren. Standard: aus.
Import / Export
Export: Download JSON speichert die Einstellungen als JSON-Datei. Hash Key und Hash IV werden nicht exportiert.
Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte Hash Keys und Hash IVs bleiben erhalten.
Kasse
Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig ECPay (綠界)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the ECPay payment page to complete the payment. Sind mehrere Zahlungsarten aktiviert, wählt der Kunde unter Payment Method außerdem Credit Card, ATM (Virtual Account), CVS (Convenience Store) oder Barcode. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order; die Auswahl der ECPay-Zahlungsart wird oberhalb dieser Schaltfläche angezeigt.
Wenn der Kunde auf Confirm Order klickt, zeigt die Seite Redirecting to ECPay for payment. Please wait... und leitet den Kunden auf die Zahlungsseite von ECPay weiter. Der Bestellbetrag wird in ganzen TWD zusammen mit den Namen und Mengen der Produkte übermittelt. Die ECPay-Seite öffnet sich auf Traditionell-Chinesisch für taiwanesische und Hongkonger Sprachen, auf Vereinfacht-Chinesisch, Koreanisch oder Japanisch für diese Sprachen und sonst auf Englisch, je nach Sprache des Kunden im Shop.
Die Bestellung wird erst als bezahlt markiert, nachdem ECPay die Zahlung über eine signierte Benachrichtigung des Servers bestätigt hat. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Aktualisierung des Lagerbestands. Klickt der Kunde auf der ECPay-Seite auf den Link zurück zum Shop und hat die Bestellung bereits einen Status, öffnet sich die Erfolgsseite der OpenCart-Bestellung. Sie zeigt Your ECPay payment has been received. bei einer bezahlten Bestellung, Your ECPay payment was received and is being reviewed by the store. bei einer Bestellung in Wartestellung und die Zahlungsanweisungen bei einer wartenden ATM-, CVS- oder Barcode-Bestellung. Ist die Benachrichtigung noch nicht eingegangen, zeigt eine Seite Payment confirmation an: We have not received a payment confirmation from ECPay for this order yet. Your order will be confirmed as soon as ECPay confirms the payment. mit den Schaltflächen Check again und Back to checkout. Hat ECPay gemeldet, dass die Zahlung fehlgeschlagen ist, landet der Kunde wieder an der Kasse mit The payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.
Bei ATM, CVS und Barcode erhält der Kunde zuerst die Zahlungsdetails. Die Bestellung erhält den Status Awaiting ECPay payment. Die Bankleitzahl und das virtuelle Konto, der Zahlungscode des Convenience-Stores bzw. die Barcodes, der Betrag und das Datum Pay before werden unter ECPay payment instructions auf der Erfolgsseite der Bestellung angezeigt und, bei angemeldeten Kunden, in den Bestelldaten des Kundenkontos. Wenn der Kunde bezahlt, sendet ECPay eine weitere Benachrichtigung, und die Bestellung wird als bezahlt markiert. Die Zahlungsanweisungen werden nicht in die E-Mails von OpenCart übernommen.
Jeder Versuch erzeugt eine neue ECPay-Transaktionsnummer, da ECPay bereits verwendete Nummern ablehnt. Wiederholungen nach einer fehlgeschlagenen Zahlung funktionieren daher, und wenn der Kunde im Browser zurückgeht und erneut auf Confirm Order klickt, wird ein neuer Versuch gestartet. Ein Warenkorb kann bis zu 30 Zahlungsversuche haben. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse, sodass ein neuer Versuch dieselbe Bestellung mit einer neuen Transaktionsnummer bezahlt. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder wartet sie auf ihre ATM- oder CVS-Zahlung, gelangt der Kunde zur Erfolgsseite, und es wird keine neue Zahlung gestartet.
Bei OpenCart 4 bleibt die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel weil ihre ATM- oder CVS-Zahlung fehlgeschlagen ist oder Sie sie storniert haben), wird der Kunde zur Kasse zurückgeschickt, mit Your previous order was cancelled or its payment failed. Please confirm the order again., und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Ist die Bestellung bereits bezahlt (oder wartet auf ihre ATM- oder Convenience-Store-Zahlung), hat sich der Warenkorb aber seitdem geändert, auch bei einer neuen Menge, lautet die Meldung Your previous order is already paid (or awaits its ATM / convenience store payment). Please confirm the order again: the cart will be paid with a new order. Ein bezahlter Auftrag wird nie als bezahlt für einen anderen Warenkorb angezeigt.
Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel The order total is too small for ECPay., wenn der Betrag nach der Rundung unter 1 TWD liegt. Die eigenen Betragsgrenzen von ECPay je Zahlungsart werden auf der ECPay-Seite geprüft, nicht an der Kasse.
Benachrichtigungen zu bereits gestarteten Zahlungen werden auch angenommen, wenn Sie die Zahlungsart ausschalten. Der Kunde sieht weiterhin die Zahlungsanweisungen bereits aufgegebener Bestellungen.
Die Erweiterung verarbeitet nur einmalige Zahlungen auf der ECPay-Seite. Sie bietet keine Erstattungen aus OpenCart, keine gespeicherten Karten, keine Abonnements oder periodischen Zahlungen (定期定額), keine Ratenzahlungen, kein Apple Pay, keine E-Rechnungen oder Logistik und keine serverseitige Statusabfrage. Kann Ihr Shop die Benachrichtigung nicht empfangen, prüfen Sie die Zahlung im Händler-Backoffice von ECPay.
Bestellungen
Bestellstatus
No status (missing order): Der Kunde wurde zu ECPay weitergeleitet und hat nicht bezahlt, die Kartenzahlung ist fehlgeschlagen oder die Benachrichtigung ist noch nicht eingegangen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.
Awaiting ECPay payment (default Pending): der Kunde hat ATM, CVS oder Barcode gewählt und die Zahlungsdetails erhalten. Der Vermerk zeigt die Bankleitzahl und das virtuelle Konto, den Zahlungscode oder die Barcodes sowie die Frist.
Payment accepted (default Processing): die Zahlung wurde bestätigt. Ein Vermerk zeigt die ECPay-TradeNo, die Zahlungsart, den Betrag und die Transaktionsnummer (mit einer Testmodus-Markierung bei Sandbox-Zahlungen).
ECPay payment on hold (default Pending): ECPay hat einen anderen Betrag oder eine andere Währung als bei der Bestellung gemeldet (zum Beispiel wurde der Warenkorb in einem anderen Tab geändert, nachdem die Zahlung begonnen hatte), eine Sandbox-Zahlung ist nach dem Umschalten in den Live-Modus eingegangen (es wurde kein echtes Geld eingezogen) oder die Zahlung ist eingegangen, nachdem Sie den Bestellstatus geändert haben, zum Beispiel auf storniert. Der Vermerk erklärt es. Vergleichen Sie mit dem Händler-Backoffice von ECPay und erfüllen Sie die Bestellung oder erstatten Sie die Zahlung dort.
Payment error (default Failed): ECPay hat gemeldet, dass die letzte ATM-, CVS- oder Barcode-Zahlung einer wartenden Bestellung fehlgeschlagen ist. Der Vermerk zeigt den Rückgabecode und die Meldung von ECPay.
Wiederholte Benachrichtigungen werden ignoriert. Eine bezahlte Bestellung wird durch einen späten Fehler nie wieder geöffnet. Eine zweite Zahlung für eine bereits bezahlte Bestellung, zum Beispiel aus zwei Browser-Tabs, wird einmal als Vermerk erfasst, damit Sie sie im Händler-Backoffice von ECPay erstatten können. Simulierte Zahlungen, die aus dem Händler-Backoffice von ECPay gestartet werden, werden nur vermerkt und markieren eine Bestellung nie als bezahlt, da ECPay dafür kein Geld einzieht.
Vermerke sind Einträge im History der Bestellung, die der Kunde nicht sieht.
Reiter VibeFox ECPay Payment Gateway
Öffnen Sie unter Sales > Orders eine mit ECPay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, listet der Reiter VibeFox ECPay Payment Gateway jeden Zahlungsversuch der Bestellung auf: die MerchantTradeNo mit einer Markierung Test mode bei Sandbox-Versuchen, die Zahlungsart, den Betrag in TWD, den Status, die ECPay-TradeNo, die Zahlungsart und das Datum, den ECPay-Rückgabecode und das Startdatum. Darunter stehen die ECPay notes der Bestellung. Bei einer Bestellung im Status „on hold“ erinnert der Reiter daran, sie mit dem Händler-Backoffice von ECPay abzugleichen. Der Reiter ist schreibgeschützt und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.
Erstattungen
Erstattungen aus OpenCart sind nicht verfügbar. Erstatten Sie die Zahlung im Händler-Backoffice von ECPay und aktualisieren Sie danach den Bestellstatus in OpenCart manuell. Produktrücksendungen unter Sales > Returns erstatten kein Geld über ECPay.
Lizenzschlüssel
Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox ECPay Payment Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel unter 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 zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-ecpay 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. Ist der Lizenzserver nicht erreichbar, 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 den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird ECPay Kunden an 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, gekennzeichnet mit (unlicensed — visible to admins only). So können Sie die Erweiterung einrichten und testen, bevor Sie einen Schlüssel kaufen. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Dashboard des Admin-Bereichs eine Erinnerung. Mit × schließen Sie sie und blenden sie 7 Tage aus. 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 Dashboard oder die Seite Edit im Admin-Bereich ö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
ECPay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der Kunde in TWD zur Kasse geht und im Live-Modus Merchant ID, Hash Key und Hash IV gesetzt sind. Die Einstellungsseite zeigt eine Meldung zur Währung und zu den Live-Zugangsdaten an. Prüfen Sie außerdem, ob die Rechnungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung die in den Einstellungen festgelegte Total erreicht.
Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Die Benachrichtigung von ECPay hat Ihren Shop nicht erreicht (Website nicht erreichbar, Firewall, Basis-Authentifizierung). ECPay wiederholt den Versuch mehrfach. Sie können die Transaktion auch im Händler-Backoffice von ECPay prüfen. Schalten Sie Enable Logging ein, um die empfangenen Benachrichtigungen zu sehen; abgelehnte Benachrichtigungen werden in jedem Fall als Fehler protokolliert.
Die Benachrichtigung antwortet 0|CheckMacValue verification failed: der Hash Key oder der Hash IV passt nicht zu Ihrem ECPay-Konto, oder die Zahlung wurde in der anderen Umgebung gestartet. Kopieren Sie die Werte erneut aus dem Händler-Backoffice von ECPay.
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 vergeben, zum Beispiel wenn mehrere Shops ein ECPay-Konto teilen. Geben Sie jedem Shop ein eigenes Order Prefix.
Die Benachrichtigung antwortet 0|Retry: die Bestellung wurde im selben Moment von einer anderen Benachrichtigung verarbeitet oder der Bestellstatus konnte nicht gesetzt werden. ECPay sendet die Benachrichtigung erneut. Schalten Sie Enable Logging ein, um den Grund zu sehen.
Die Benachrichtigungs-URL zeigt 0|Method not allowed in the browser: das ist normal. Die URL akzeptiert nur Anfragen von ECPay.
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 ausgeschaltet. Der Kunde lädt die Kasse neu.
Der Kunde sieht The order total is too small for ECPay.: die Bestellsumme liegt nach der Rundung unter 1 TWD und kann nicht mit ECPay bezahlt werden.
Der Kunde sieht Too many payment attempts for this order: der Warenkorb hat 30 Zahlungsversuche erreicht. Bitten Sie den Kunden, einen neuen Warenkorb zu beginnen.
Die Bestellung hat den Status on hold: Lesen Sie die Vermerke im Reiter VibeFox ECPay Payment Gateway (siehe Bestellstatus), gleichen Sie sie mit dem Händler-Backoffice von ECPay ab und erfüllen Sie dann die Bestellung oder erstatten Sie die Zahlung dort.
Für Entwickler: Bevor das Zahlungsformular an ECPay gesendet wird, löst die Erweiterung das OpenCart-Ereignis ecpay_p_request_params mit den Parametern und der Bestellung aus. Der Händler, die Transaktionsnummer und der Betrag können dadurch nicht geändert werden.
Deinstallation
Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox ECPay Payment Gateway auf Uninstall (die rote −-Schaltfläche). Lizenzschlüssel und 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 Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch die OpenCart-Ereignisse der Erweiterung werden entfernt (bei OpenCart 4 zusätzlich deren Startaktion, die die Benachrichtigung im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Einstellungen (Titel, Beschreibung, Testmodus, Zugangsdaten, Zahlungsoptionen, Protokollierung) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungsdatensätze von ECPay bleiben immer erhalten, sodass verspätete Benachrichtigungen zu alten Zahlungen auch nach einer Neuinstallation geprüft werden. Bestehende Bestellungen behalten ihre Zahlungsvermerke.
Um bei OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken Sie in der Liste der installierten Erweiterungen neben VibeFox ECPay Payment Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.
ECPay ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit ECPay verbunden und wird von ECPay nicht unterstützt.