VibeFox MultiSafepay 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: die Währung der Kasse muss eine Währung sein, die MultiSafepay akzeptiert, zum Beispiel EUR, USD, GBP, PLN, CHF, SEK, DKK oder NOK. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet.

MultiSafepay-Konto: Sie benötigen den API-Schlüssel Ihrer Website in MultiSafepay Control. Test- und Live-Konten haben unterschiedliche Schlüssel. In MultiSafepay muss sonst nichts eingerichtet werden: Die Benachrichtigungsadresse wird bei jeder Zahlung mitgesendet.

Öffentlich erreichbarer Shop: MultiSafepay muss Ihren Shop erreichen können, um Benachrichtigungen zu senden. Andernfalls erhalten Bestellungen trotzdem ihren Status, wenn der Kunde von MultiSafepay zurückkehrt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine Domain.

Installation

Die Download-Datei 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_multisafepay_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_multisafepay_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_multisafepay_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält 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, wählen Sie den Typ Payments, suchen Sie VibeFox MultiSafepay 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 Bleistift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in das Feld License key ein und klicken Sie auf Activate (siehe License key).

4. Fügen Sie den Test- und/oder Live-API-Schlüssel aus MultiSafepay Control ein (siehe Configuration).

5. Aktivieren Sie Enable/Disable und klicken Sie auf Save. Testen Sie eine Zahlung bei aktiviertem Test mode und schalten Sie ihn danach aus, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_multisafepay_gateway.ocmod.zip. 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 MultiSafepay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Bleistift-Schaltfläche).

4. Fügen Sie den Lizenzschlüssel und die API-Schlüssel wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Notification URL unterscheidet sich (siehe Notification URL).

Nach einer Neuinstallation ist die Zahlungsart zunächst deaktiviert und der Testmodus aktiviert.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox MultiSafepay Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Test mode: new payments use the MultiSafepay test environment (no real payments). an, solange der Testmodus aktiviert ist. Außerdem warnt sie, wenn die Zahlungsart aktiviert ist, der aktuelle Modus aber keinen API-Schlüssel hat (die Zahlungsart wird dann an der Kasse nicht angezeigt), und wenn MultiSafepay die Standardwährung Ihres Shops nicht akzeptiert. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl von 0 oder größer sein, und die Geo Zone sowie die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert, und die Seite nennt das Problem. Ist die Zahlungsart ohne API-Schlüssel des aktuellen Modus aktiviert, werden die Einstellungen mit einer Warnung gespeichert.

Checkout

Enable/Disable: Enable MultiSafepay schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den der Kunde an der Kasse sieht. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: MultiSafepay. Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order über der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

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

Geo Zone: bietet MultiSafepay nur für Rechnungsadressen in der gewählten Geo Zone an. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Warenkorbwert in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor MultiSafepay angeboten wird. Lassen Sie das Feld leer, um MultiSafepay bei jedem Betrag anzubieten.

API-Schlüssel

Den API-Schlüssel finden Sie unter MultiSafepay Control > Manage settings > Website settings. Der Abschnitt verlinkt auf das Testkonto (testmerchant.multisafepay.com) und das Livekonto (merchant.multisafepay.com). Sie haben unterschiedliche Schlüssel. Der Testmodus verwendet nur den Testschlüssel, der Livemodus nur den Live-Schlüssel.

Test mode: verwendet die Testumgebung von MultiSafepay (keine echten Zahlungen). Dabei werden sowohl die API-Adresse als auch der API-Schlüssel umgeschaltet. Bereits getätigte Zahlungen verwenden für Statusprüfungen und Erstattungen weiterhin die Umgebung, in der sie getätigt wurden. Standard: aktiviert. Solange er aktiviert ist, sieht der Kunde im Schritt Confirm Order den Hinweis Test mode: no real payment will be made.

Test API key: der API-Schlüssel Ihres MultiSafepay-Testkontos.

Live API key: der API-Schlüssel Ihres MultiSafepay-Livekontos.

Gespeicherte 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.

Benachrichtigungen

Hier gibt es nichts einzurichten. Das Feld Notification URL zeigt die Adresse, die bei jeder Zahlung an MultiSafepay gesendet wird. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_multisafepay_gateway/webhook, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_multisafepay_gateway/payment/wcp_multisafepay_gateway.webhook. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Eine Benachrichtigung teilt der Erweiterung nur mit, welche Zahlung sich geändert hat: Status, Betrag und Währung werden immer über die MultiSafepay-API mit dem API-Schlüssel der Umgebung der Zahlung gelesen, bevor die Bestellung geändert wird. Benachrichtigungen zu Zahlungen, die nicht in Ihrem Shop gestartet wurden, werden ignoriert. Die Benachrichtigung funktioniert auch, wenn der Shop im Wartungsmodus ist, da OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und OpenCart 4 dafür eine Startaktion der Erweiterung ergänzt, die auch die Rückkehr des Kunden von MultiSafepay ermöglicht.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn MultiSafepay die Zahlung gemeldet hat. Jedes Feld unten listet Ihre Bestellstatus aus OpenCart auf.

Order status after payment: der Status einer bezahlten Bestellung. Standard: In Bearbeitung. Wählen Sie Complete, um bezahlte Bestellungen sofort abzuschließen.

MultiSafepay payment on hold status: die Zahlung benötigt Ihre Aufmerksamkeit (siehe Order statuses). Standard: Ausstehend, da OpenCart keinen Status In Wartestellung hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Payment error status: eine nicht abgeschlossene oder reservierte Zahlung wurde nachträglich abgelehnt, abgelaufen oder storniert. Standard: Fehlgeschlagen.

Refunded status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: protokolliert API-Aufrufe und Benachrichtigungen in mspg_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Webbrowser geöffnet werden. Fehler und Warnungen werden immer protokolliert. API-Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Protokolls an. Klicken Sie auf Clear log, um es zu leeren.

Delete data on uninstall: ist die Option aktiviert, entfernt die Deinstallation der Erweiterung die Einstellungen des Gateways und das Protokoll. Die MultiSafepay-Zahlungsdaten der Bestellungen bleiben immer erhalten, damit Erstattungen alter Bestellungen möglich bleiben. Das Deaktivieren der Erweiterung löscht nie etwas. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig MultiSafepay). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to MultiSafepay to choose a payment method and pay. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine MultiSafepay-Zahlung über den Bestellbetrag in der Bestellwährung und leitet den Kunden zur Zahlungsseite von MultiSafepay weiter. Dort wählt der Kunde eine beliebige in Ihrem MultiSafepay-Konto aktivierte Zahlungsart und zahlt. Bei OpenCart 4 wählt der Kunde die Zahlungsart über die Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Rechnungsadresse, E-Mail-Adresse, Telefonnummer und Sprache des Kunden werden an MultiSafepay übergeben, und die Zahlung wird als Order #, mit der Bestellnummer und dem Namen Ihres Shops angezeigt.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn MultiSafepay die Zahlung bestätigt hat: durch die Benachrichtigung oder durch eine Prüfung mit der MultiSafepay-API, wenn der Kunde zurückkehrt. Anschließend erhält die Bestellung ihren Status auf die übliche OpenCart-Weise mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your payment with MultiSafepay has been received. Bei einer Bestellung in Wartestellung zeigt die Seite We are confirming your payment with MultiSafepay. The order will be updated automatically — please do not pay again. Schlägt die Zahlung später fehl, zeigt die Seite Your MultiSafepay payment was not completed. Please contact us about this order. Hat MultiSafepay die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt (etwa wenn eine Banküberweisung noch aussteht), zeigt eine Seite Payment confirmation denselben „wir bestätigen“-Text und eine Schaltfläche Check again. Die Benachrichtigung setzt den Bestellstatus, sobald MultiSafepay die Zahlung meldet.

Bricht der Kunde auf der MultiSafepay-Seite ab oder wird die Zahlung abgelehnt oder läuft sie ab, kehrt der Kunde zur Kasse zurück, der Warenkorb bleibt erhalten, und es erscheint eine dieser Meldungen: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. oder The payment session has expired. Please try again. Bei OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird. OpenCart 4 behält eine Bestellung für die Kasse bei und bezahlt dieselbe Bestellung erneut. Bevor eine neue Zahlung erstellt wird, prüft die Erweiterung bei MultiSafepay die früheren Zahlungen desselben Warenkorbs. Ist eine davon bereits bezahlt oder wird gerade verarbeitet, wird diese Zahlung bestätigt, und der Kunde gelangt zur Erfolgsseite, statt erneut zu zahlen. Ist die Zahlung dieser Bestellung noch offen und stimmen Umgebung, Betrag und Währung überein, wird dieselbe Zahlungsseite wiederverwendet. Andernfalls wird die alte Zahlung bei MultiSafepay storniert, sodass sie nicht mehr bezahlt werden kann.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel, wenn ihre Zahlung nach der Wartestellung abgelehnt wurde oder abgelaufen ist oder Sie sie storniert haben), 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 die nächste Bestätigung über Confirm Order bezahlt eine neue Bestellung. Wurde die Bestellung bezahlt und danach vom Shop geschlossen (zum Beispiel erstattet), lautet die Meldung Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order. Ist die Bestellung der Kasse bereits angelegt und hat sich der Warenkorb seitdem geändert, lautet die Meldung Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. Jede Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung benötigt. Eine Bestellung des Warenkorbs, die bezahlt und danach storniert oder erstattet wurde, hält den Warenkorb nicht mehr.

Kann MultiSafepay die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order und sieht eine kurze Meldung über der Schaltfläche, zum Beispiel Could not connect to MultiSafepay. Please try again in a moment. oder MultiSafepay cannot accept this order amount or currency. Please choose another payment method. Der technische Grund wird im Protokoll festgehalten.

Die Erweiterung bietet eine Zahlungsart, die zur Seite von MultiSafepay führt. Es gibt keine eigenen OpenCart-Zahlungsarten für einzelne MultiSafepay-Zahlungsarten, keine eingebetteten Kartenfelder, keine Apple-Pay- oder Google-Pay-Schnellzahlungsbuttons, keine Abonnements, wiederkehrenden Zahlungen oder gespeicherten Karten und keine Erfassung oder Stornierung aus OpenCart. Es werden keine Warenkorbdaten übertragen, daher bietet MultiSafepay für diese Bestellungen solche Zahlungsarten nicht an, die diese Daten benötigen (zum Beispiel Klarna, in3 oder Riverty).

Bestellungen und Erstattungen

Order statuses

No status (missing order): der Kunde wurde zu MultiSafepay weitergeleitet und hat nicht bezahlt, MultiSafepay hat die Zahlung noch nicht bestätigt, oder die Zahlung wurde storniert, abgelehnt oder ist abgelaufen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order status after payment (default Processing): MultiSafepay hat die Zahlung (abgeschlossen oder versendet) mit dem genauen Bestellbetrag und der Währung bestätigt. Eine Notiz zeigt die Zahlung, die Zahlungsart und die Umgebung.

MultiSafepay payment on hold status (default Pending), before payment: die Zahlung ist nicht abgerechnet (wird von MultiSafepay geprüft) oder reserviert (autorisiert). Erfassen Sie eine reservierte Zahlung in MultiSafepay Control, um das Geld zu erhalten. Die Bestellung wechselt automatisch in Order status after payment, wenn MultiSafepay die Zahlung als abgeschlossen meldet, oder in Payment error status, wenn sie abgelehnt, storniert, abgelaufen oder annulliert wird.

MultiSafepay payment on hold status, after payment: MultiSafepay hat einen anderen Betrag oder eine andere Währung als den Bestellwert bestätigt, eine Testzahlung wurde abgeschlossen, während die Erweiterung im Livemodus war (es ist kein echtes Geld eingegangen), oder die Zahlung wurde abgeschlossen, nachdem der Bestellung ein anderer Status gegeben wurde, zum Beispiel storniert. Die Notiz erklärt dies. Prüfen Sie die Transaktion in MultiSafepay Control und führen Sie die Bestellung aus oder erstatten Sie sie.

MultiSafepay payment on hold status, after a chargeback: MultiSafepay hat für die Zahlung einer bezahlten Bestellung einen Chargeback gemeldet: Das Geld wurde von Ihrem Konto zurückgebucht.

Payment error status (default Failed): eine nicht abgerechnete oder reservierte Zahlung wurde nachträglich abgelehnt, storniert, ist abgelaufen oder wurde annulliert.

Refunded status (default Refunded): die Zahlung wurde über die Erweiterung vollständig erstattet.

Eine bezahlte oder erstattete Bestellung wird durch eine verspätete Benachrichtigung nie wieder geöffnet. Wird für einen bereits bezahlten Warenkorb eine zweite Zahlung abgeschlossen, bleibt die bezahlte Bestellung unverändert. Eine Notiz bittet Sie, das Duplikat in MultiSafepay Control zu erstatten.

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

Reiter VibeFox MultiSafepay Gateway

Öffnen Sie unter Sales > Orders eine mit MultiSafepay bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox MultiSafepay Gateway die MultiSafepay order (mit der Bezeichnung Test environment bei Testzahlungen), die Method, den Status, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die MultiSafepay notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter VibeFox MultiSafepay Gateway den Amount ein (der noch nicht erstattete Betrag ist bereits eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via MultiSafepay. Bestätigen Sie die Abfrage Refund this amount through MultiSafepay? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und der Währung, die MultiSafepay belastet hat. Nach einer Betragsabweichung können Sie daher höchstens den tatsächlich vom Kunden gezahlten Betrag erstatten, nicht den Bestellwert. Die Erstattung wird an die Umgebung gesendet, in der die Zahlung erfolgte (Test oder Live), daher muss der API-Schlüssel dieser Umgebung gesetzt sein. Lehnt MultiSafepay die Erstattung ab, zeigt der Reiter MultiSafepay refund failed: mit dem Fehler von MultiSafepay, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der MultiSafepay-Erstattungs-ID dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, genau wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald MultiSafepay die Zahlung gemeldet hat.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über MultiSafepay.

In MultiSafepay Control vorgenommene Erstattungen werden den Notizen hinzugefügt, sobald MultiSafepay sie meldet. Der Bestellstatus wird nicht automatisch geändert. Aktualisieren Sie ihn bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox MultiSafepay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox MultiSafepay Gateway > Edit, 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: opencart-payment-multisafepay 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 Sprache des Admin-Bereichs (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 Domainplatz 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. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird MultiSafepay 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 selben Browser im Admin-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Bei OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Admin-Anmeldung 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. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern aber 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 Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

MultiSafepay does not appear at checkout: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus einen API-Schlüssel hat: Test API key im Testmodus, Live API key im Livemodus. Die Einstellungsseite zeigt eine Warnung, wenn der Schlüssel fehlt. Der Kunde muss in einer Währung zahlen, die MultiSafepay akzeptiert (der im Shop gewählten Währung). Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Wert erreicht.

The payment went through, but the order stays without a status: die Benachrichtigung hat Ihren Shop nicht erreicht. Prüfen Sie, ob der Shop aus dem Internet erreichbar ist und ob der API-Schlüssel der Umgebung der Zahlung gesetzt ist, weil die Erweiterung den Status über die MultiSafepay-API liest. Kann die API nicht erreicht werden oder fehlt der Schlüssel, antwortet die Benachrichtigung mit ERROR, und MultiSafepay wiederholt sie. Die Bestellung erhält ihren Status auch dann, wenn der Kunde in den Shop zurückkehrt oder versucht, denselben Warenkorb erneut zu bezahlen.

Notification answers Invalid request: die Anfrage enthielt keine gültige Transaktions-ID. Benachrichtigungen von MultiSafepay enthalten immer eine.

The customer sees an error after Confirm Order: aktivieren Sie Debug log und sehen Sie sich das Feld Log auf der Seite der Erweiterung an. This payment method is not available. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde: Der Kunde lädt die Kasse neu. This payment method is temporarily unavailable. Please choose another payment method. bedeutet meist einen falschen oder fehlenden API-Schlüssel. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. bedeutet, dass MultiSafepay Betrag oder Währung abgelehnt hat.

The customer comes back and sees Payment verification failed.: die Rückkehradresse passte zu keiner Zahlung dieses Shops, zum Beispiel wegen eines alten oder veränderten Links. Der Kunde kann über die Kasse erneut bezahlen.

Order is in the on hold status: lesen Sie die Notizen im Reiter VibeFox MultiSafepay Gateway. Die Zahlung ist möglicherweise nicht abgerechnet oder reserviert, der bezahlte Betrag oder die Währung wich von der Bestellung ab, eine Testzahlung ist im Livemodus eingegangen, die Zahlung kam nach der Stornierung der Bestellung, oder es gab einen Chargeback. Prüfen Sie die Transaktion in MultiSafepay Control.

Test payments do not confirm a live order: eine Testzahlung bezahlt eine Bestellung nie, solange die Erweiterung im Livemodus ist; stattdessen wird die Bestellung in Wartestellung gesetzt. Frühere Testzahlungen werden nach dem Wechsel zu Live weiterhin mit dem Testschlüssel geprüft und erstattet.

No refund form in the tab: der Reiter nennt den Grund: Die Zahlung ist noch nicht gemeldet, sie ist vollständig erstattet, oder Ihre Benutzergruppe hat kein Recht, die Erweiterung zu ändern.

Refund fails with a message about the environment: die Zahlung erfolgte in der Test- oder Live-Umgebung, und der API-Schlüssel dieser Umgebung ist nicht gesetzt. Geben Sie ihn ein und versuchen Sie es erneut.

Für Entwickler: Die Erweiterung löst die OpenCart-Ereignisse mspg_supported_currencies und mspg_order_request aus, um die unterstützten Währungen und die an MultiSafepay gesendeten Zahlungsdaten zu ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox MultiSafepay Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der 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 Bereich Orders, die bei einer erneuten Installation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (bei OpenCart 4 seine Ereignisse und seine Startaktion, die Benachrichtigungen im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, API-Schlüssel, Debug-Protokoll) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Zahlungs- und Erstattungsdaten von MultiSafepay bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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 MultiSafepay Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

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