VibeFox ePay.bg 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: bulgarischer Lew (BGN), Euro (EUR) oder US-Dollar (USD). Die Bestellung wird in ihrer eigenen Währung mit 2 Dezimalstellen belastet. Wenn der Kunde in einer anderen Währung zur Kasse geht, wird die Zahlungsart ausgeblendet.

ePay.bg-Konto: Sie benötigen die Kundennummer (MIN) und den geheimen Schlüssel aus Ihrem Händlerprofil bei ePay.bg: die Live-Daten von www.epay.bg, die Testdaten von demo.epay.bg (ein Testkonto wird separat registriert). Außerdem müssen Sie die Benachrichtigungs-URL Ihres Shops im Händlerprofil hinterlegen.

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_epaybg_gateway-oc3-(Version).ocmod.zip und das OpenCart-4-Paket wcp_epaybg_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_epaybg_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 ePay.bg 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. Geben Sie die MIN und den geheimen Schlüssel für den Test- und/oder Live-Betrieb ein (siehe Konfiguration).

5. Kopieren Sie die URL aus dem Abschnitt Payment notifications (IPN) in das Feld URL for receiving notifications Ihres Händlerprofils bei ePay.bg, sowohl im Demo- als auch im Live-Profil. Ohne sie erhält keine Bestellung einen Status.

6. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Legen Sie eine Testbestellung im Testmodus an und schalten Sie danach Test Mode aus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_epaybg_gateway.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 in der Liste der installierten Erweiterungen auf derselben Seite. 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 ePay.bg Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die ePay.bg-Zugangsdaten und die Benachrichtigungs-URL ein wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL ist anders (siehe Zahlungsbenachrichtigungen (IPN)).

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox ePay.bg 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 des Shops nicht BGN, EUR oder USD ist, eine Warnung, wenn die Zahlungsart aktiviert ist, aber die MIN oder der geheime Schlüssel des gewählten Modus leer ist (sie wird dann an der Kasse ausgeblendet, und beim Speichern erscheint dieselbe Warnung), sowie Test mode is on: payments go to demo.epay.bg and no real money is charged., solange der Testmodus eingeschaltet ist. 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 (bis zu 128 Zeichen), Sort Order muss eine ganze Zahl sein und Total eine Zahl von 0 oder größer; ist ein Feld fehlerhaft, wird nichts gespeichert.

ePay.bg

Enable/Disable: Enable ePay.bg Payment Gateway 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: ePay.bg. Pflichtfeld.

Description: der Text, der dem Kunden im Schritt Confirm Order angezeigt wird. Standard: Pay securely via ePay.bg with a bank card or your ePay.bg account.

Sort Order: die Position von ePay.bg unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: bietet ePay.bg 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 ePay.bg angeboten wird. Lassen Sie das Feld leer, um ePay.bg bei jeder Summe anzubieten.

ePay.bg-Konto

Die Kundennummer (MIN) und der geheime Schlüssel stehen in Ihrem Händlerprofil auf www.epay.bg (live) und demo.epay.bg (Testkonto, separat registriert).

Test Mode: aktiviert den Testmodus. Kunden werden an die Demoumgebung von ePay.bg weitergeleitet, und die Anfragen werden mit den Testdaten signiert. Standard: an. Solange er aktiviert ist, sehen Kunden im Schritt Confirm Order den Hinweis Test mode (demo.epay.bg): no real payment is taken.

Test Merchant ID (MIN): die Kundennummer (MIN) Ihres Händlerkontos bei demo.epay.bg.

Test Secret Key: der geheime Schlüssel Ihres Händlerkontos bei demo.epay.bg (64 Zeichen).

Live Merchant ID (MIN): die Kundennummer (MIN) Ihres Händlerkontos bei www.epay.bg.

Live Secret Key: der geheime Schlüssel Ihres Händlerkontos bei www.epay.bg (64 Zeichen), der für die HMAC-SHA1-Signatur verwendet wird.

Gespeicherte geheime Schlüssel 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 Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved key on save und klicken Sie auf Save. Leerzeichen und Zeilenumbrüche in eingefügten Schlüsseln werden beim Speichern entfernt.

Zahlungsbenachrichtigungen (IPN)

Die Benachrichtigung teilt Ihrem Shop mit, dass eine Zahlungsanfrage bezahlt, abgelehnt wurde oder abgelaufen ist. Das Feld Notification URL zeigt die URL, die Sie als URL for receiving notifications im Händlerprofil bei ePay.bg eintragen, sowohl im Live- als auch im Demo-Profil. Unter OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_epaybg_gateway/notify, unter OpenCart 4 so: https://your-store/index.php?route=extension/wcp_epaybg_gateway/payment/wcp_epaybg_gateway.notify. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Kopieren Sie die URL genau so, wie die Einstellungen sie anzeigen. Bestellungen erhalten einen Status nur durch diese signierten Benachrichtigungen; ein Kunde, der in den Shop zurückkehrt, bezahlt eine Bestellung damit nicht.

ePay.bg meldet für jede Rechnung diese Ergebnisse:

Benachrichtigungen ohne gültige Prüfsumme werden abgelehnt, und ePay.bg sendet sie weiter. Die Prüfsumme wird mit dem geheimen Schlüssel jedes Modus geprüft, der einen hat, sodass Zahlungen, die vor dem Wechsel zwischen Test und Live gestartet wurden, weiterhin bestätigt werden. Eine Zahlung muss in dem Modus eingehen, in dem die Anfrage gestellt wurde; andernfalls wechselt die Bestellung in den Status „on hold“. Ohne die Benachrichtigungs-URL im Händlerprofil erhält keine Bestellung einen Status.

Zahlungsanfrage

Invoice Prefix: nur Ziffern (bis zu 10), die der OpenCart-Bestell-ID vorangestellt werden, um die ePay.bg-Rechnungsnummer zu bilden, zum Beispiel 00001 + 123 = 00001123. Verwenden Sie unterschiedliche Präfixe für verschiedene Shops auf einem ePay.bg-Konto. Andere Zeichen werden beim Speichern mit einer Warnung entfernt, die das gespeicherte Präfix anzeigt. Ein späterer Wechsel des Präfixes ist unbedenklich: offene Zahlungsanfragen werden über die jeweils gespeicherte Rechnung gefunden. Standard: 00001.

Expiration Time: die Zeitspanne, nach der eine unbezahlte Zahlungsanfrage abläuft; ePay.bg meldet sie dann als abgelaufen, und die Bestellung erhält keinen Status. Wählen Sie 1, 3, 6, 12, 24, 48 oder 72 Stunden. Die Zeit wird in bulgarischer Zeit übermittelt, unabhängig von der Zeitzone Ihres Shops. Standard: 24 Stunden.

Language: die Sprache der ePay.bg-Zahlungsseite, Englisch oder Bulgarisch. Standard: English.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Sie erhält einen Status erst, wenn ePay.bg die Zahlung meldet. Eine abgelehnte, abgelaufene oder abgebrochene Zahlung lässt die Bestellung ohne Status, und der Kunde kann erneut bezahlen. Die Statusfelder unten listen Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status, der nach einer erfolgreichen Zahlung gesetzt wird.

Processing status: der OpenCart-Status für Default und Processing. Standard: Processing.

Completed status: der OpenCart-Status für Completed. Standard: Complete.

On Hold status: der OpenCart-Status für On Hold und für Zahlungen, die manuell geprüft werden müssen: Der Bestellbetrag oder die Währung hat sich nach der Zahlungsanfrage geändert, die Benachrichtigung kam im anderen Modus an oder der Bestellstatus wurde geändert, bevor die Zahlung einging (zum Beispiel storniert). Eine solche Bestellung wird nicht als bezahlt markiert; ein Vermerk 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.

Erweitert

Logging: schreibt Zahlungsanfragen und Benachrichtigungen in epay_bp_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 epay_bp_debug.old.log.php verschoben. Geheime Schlüssel und Kartendaten werden nicht protokolliert. Standard: aus. Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist.

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 die Gateway-Einstellungen und das Protokoll. Die Zahlungsdatensätze und Bestellungen von ePay.bg bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Geheime Schlüssel werden nicht exportiert.

Import: fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte geheime Schlüssel bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig ePay.bg). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to ePay.bg to pay with a bank card or your ePay.bg account. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status. In OpenCart 4 wählt der Kunde die Zahlungsart über die Schaltfläche Choose des Zahlungsartblocks im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, leitet die Erweiterung ihn mit einer signierten Zahlungsanfrage über den Bestellbetrag in der Bestellwährung, mit der Rechnungsnummer und der Ablaufzeit, zu ePay.bg weiter. Die Zahlung erscheint bei ePay.bg als Order mit der Bestellnummer. Bei ePay.bg bezahlt der Kunde mit einer Bankkarte oder einem ePay.bg-Konto.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn ePay.bg dies mit der signierten Benachrichtigung bestätigt. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Lageraktualisierung. Ist die Benachrichtigung bereits eingegangen, sieht der Kunde die OpenCart-Erfolgsseite der Bestellung. Falls nicht, zeigt eine Seite Payment confirmation an: Thank you. Your payment is being confirmed by ePay.bg — your order is confirmed as soon as ePay.bg reports the payment. mit den Schaltflächen Check again und Back to checkout.

Bricht der Kunde bei ePay.bg ab, landet er wieder an der Kasse mit The ePay.bg payment was cancelled. You can try again or choose another payment method. Hat ePay.bg die Anfrage als abgelehnt oder abgelaufen gemeldet, lautet die Meldung The payment was not completed. You can try again or choose another payment method. Der Warenkorb bleibt erhalten. In OpenCart 4 erscheinen diese Meldungen oberhalb der Kassenseite. Ein neuer Versuch für dieselbe Bestellung verwendet dieselbe Rechnungsnummer. 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 Zahlungsanfrage bezahlt; ist eine andere Bestellung desselben Warenkorbs bereits bezahlt, gelangt der Kunde zur Erfolgsseite, und es wird keine neue Zahlung gestartet.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (etwa von Ihnen 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, und der nächste Klick auf Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Ist diese Bestellung bereits bezahlt, der Warenkorb seitdem aber geändert, auch durch eine neue Menge, wird der Kunde zur Kasse zurückgeschickt, und der nächste Klick auf Confirm Order bezahlt den neuen Warenkorb mit einer neuen Bestellung. Eine bezahlte Bestellung wird niemals als bezahlt für einen anderen Warenkorb angezeigt.

Kann die Bestellung nicht mit ePay.bg bezahlt werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung oberhalb der Schaltfläche, zum Beispiel ePay.bg payments are temporarily unavailable. Please choose another payment method. oder dass ePay.bg keine Zahlungen in der Bestellwährung annimmt.

Die Benachrichtigung funktioniert auch während der Wartung des Shops, da OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und die Erweiterung auf OpenCart 4 dafür eine Startup-Aktion ergänzt. Benachrichtigungen zu bereits gestarteten Zahlungen werden auch dann angenommen, wenn Sie die Zahlungsart ausschalten.

Die Erweiterung verarbeitet nur einmalige Zahlungen bei ePay.bg. Sie bietet keine Erstattungen aus OpenCart, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen und keine Barzahlungscodes von EasyPay oder B-Pay.

Bestellungen

Bestellstatus

No status (missing order): Der Kunde wurde zu ePay.bg weitergeleitet und hat nicht bezahlt, die Benachrichtigung ist noch nicht eingegangen, oder ePay.bg hat die Anfrage als abgelehnt oder abgelaufen gemeldet. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Processing, Completed oder On Hold status: die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Ein Vermerk zeigt die Rechnungsnummer, das Zahlungsdatum, die STAN und den BORICA-Code.

On Hold status nach Zahlung: Die Zahlung ist eingegangen, passt aber nicht zu dem, was die Bestellung jetzt besagt: Der Bestellbetrag oder die Währung hat sich nach der Zahlungsanfrage geändert, die Benachrichtigung kam im anderen Modus (Test oder Live) als die Anfrage, oder die Zahlungsart der Bestellung ist nicht mehr ePay.bg. Die Zahlung wird nicht als bezahlt erfasst. Dasselbe passiert, wenn Sie der Bestellung bereits einen anderen Status gegeben haben, zum Beispiel storniert. Der Vermerk erklärt den Grund. Prüfen Sie die Zahlung im Händlerkonto bei ePay.bg und erfüllen oder erstatten Sie die Bestellung manuell.

Geht eine Zahlung für eine bereits bezahlte Bestellung ein, bleibt der Status unverändert, und ein Vermerk bittet Sie, im Händlerkonto bei ePay.bg auf eine Doppelzahlung zu prüfen. Hat der Kunde zwei Bestellungen desselben Warenkorbs bezahlt, erhält die zweite einen Vermerk über eine mögliche Doppelzahlung. Eine späte Ablehnungs- oder Ablaufmeldung ändert nie eine bezahlte Bestellung; eine Bestellung mit einem Status erhält nur einen Vermerk.

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

Reiter VibeFox ePay.bg Gateway

Öffnen Sie unter Sales > Orders eine mit ePay.bg bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox ePay.bg Gateway die Rechnung, die Umgebung (Test oder Live) mit einer Markierung Test mode bei Testzahlungen, den angefragten Betrag und die Währung, den Status der Zahlungsanfrage, das Ergebnis der Benachrichtigung, das Zahlungsdatum, die STAN, den BORICA-Code und die ePay.bg notes der Bestellung. Der Reiter ist schreibgeschützt und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus OpenCart sind nicht verfügbar, da die WEB-API von ePay.bg keinen Erstattungsaufruf kennt. Erstatten Sie die Zahlung im Händlerkonto bei ePay.bg und aktualisieren Sie den Bestellstatus in OpenCart manuell. Produktrücksendungen unter Sales > Returns erstatten kein Geld über ePay.bg.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox ePay.bg Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox ePay.bg 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-epaybg 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 ePay.bg 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. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung nicht, daher wird ohne aktiven Schlüssel die Zahlungsart 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

ePay.bg erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, MIN und geheimer Schlüssel des gewählten Modus gesetzt sind und der Kunde in BGN, EUR oder USD zur Kasse geht. Die Einstellungsseite zeigt eine Warnung, wenn die Zugangsdaten fehlen. 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 Bestellung erhält ihren Status nur aus der Benachrichtigung von ePay.bg. Prüfen Sie, ob die Benachrichtigungs-URL im Händlerprofil bei ePay.bg des von Ihnen genutzten Modus (Demo oder Live) genau so eingetragen ist, wie sie unter Notification URL angezeigt wird, und ob der geheime Schlüssel dieses Modus stimmt. Sehen Sie sich das Feld Log auf der Erweiterungsseite an; schalten Sie Logging ein, um jede Benachrichtigung zu sehen.

Die Benachrichtigung antwortet ERR=Not valid CHECKSUM: Kein gespeicherter geheimer Schlüssel passt zu dem Händlerprofil, das die Benachrichtigung gesendet hat. ePay.bg versucht es weiter, daher erhält die Bestellung ihren Status, sobald der Schlüssel stimmt.

Die Benachrichtigung antwortet ERR=Not configured: Es ist kein geheimer Schlüssel gespeichert. Geben Sie ihn ein.

Die Benachrichtigung antwortet STATUS=NO für eine Rechnung: Die Rechnung wurde nicht von diesem Shop ausgestellt, zum Beispiel von einem anderen Shop auf demselben ePay.bg-Konto. Geben Sie jedem Shop ein eigenes Invoice Prefix.

Die Benachrichtigung antwortet STATUS=ERR: ein vorübergehender Fehler, zum Beispiel zwei Benachrichtigungen für dieselbe Bestellung im selben Moment, oder der Bestellstatus konnte nicht gesetzt werden. ePay.bg sendet die Benachrichtigung erneut. Der Grund steht im Protokoll.

Die Benachrichtigungs-URL zeigt ERR=Method not allowed in the browser: Das ist normal. Die URL akzeptiert nur Anfragen von ePay.bg.

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 This order has nothing to pay.: Der Bestellbetrag ist null, daher gibt es nichts an ePay.bg zu senden.

Die Bestellung ist nach der Zahlung im Status On Hold: Lesen Sie die Vermerke im Reiter VibeFox ePay.bg Gateway (siehe Bestellstatus), prüfen Sie die Zahlung im Händlerkonto bei ePay.bg und erfüllen oder erstatten Sie die Bestellung anschließend dort.

Die Rechnungspräfix wurde beim Speichern geändert: Das Präfix darf nur Ziffern enthalten, bis zu 10. Andere Zeichen werden entfernt.

Für Entwickler: Bevor das Zahlungsformular an ePay.bg gesendet wird, löst die Erweiterung das OpenCart-Ereignis epay_bp_form_fields mit den Formularfeldern und der Bestellung aus, zum Beispiel um die direkte Kartenzahlungsseite (PAGE=credit_paydirect) zu verwenden; die signierten Daten und die Prüfsumme können dadurch nicht geändert werden.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox ePay.bg 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 OpenCart-Status im Abschnitt Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auf OpenCart 4 werden außerdem das Ereignis der Erweiterung (die Meldung an der Kasse) und ihre Startup-Aktion entfernt, die die Benachrichtigung im Wartungsmodus durchlässt. Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, MIN und geheime Schlüssel, Zahlungsanfrage, Bestellstatus nach Zahlung, Protokollierung) und das Protokoll entfernt. Ist es ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungsdatensätze von ePay.bg bleiben immer erhalten, sodass eine Zahlung, die vor einer Neuinstallation gestartet wurde, weiterhin bestätigt wird. Bestehende Bestellungen behalten ihre Zahlungsvermerke.

Auf OpenCart 4 entfernen Sie die Dateien der Erweiterung außerdem, indem Sie nach der Deinstallation zu Extensions > Installer gehen, neben VibeFox ePay.bg Gateway in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) klicken und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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