VibeFox ifthenpay 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: nur Euro (EUR). Die Währung EUR muss in Ihrem Shop aktiviert sein, und die Zahlungsart wird nur angezeigt, wenn der Kunde in EUR bezahlt. ifthenpay akzeptiert Beträge von 0,01 bis 99.999,99 EUR.

ifthenpay-Konto: Registrieren Sie sich unter ifthenpay.com. Sie benötigen den Schlüssel der Zahlungsart, die Sie anbieten: Multibanco, MB WAY oder Credit Card (Format ABC-123456). Die Schlüssel werden im ifthenpay-Backoffice (backoffice.ifthenpay.com) angezeigt oder von ifthenpay gesendet, wenn die Zahlungsart für Ihr Konto aktiviert wird. ifthenpay muss außerdem den Callback für Ihren Schlüssel aktivieren (siehe Konfiguration), und Ihr Shop muss aus dem Internet erreichbar sein.

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

Installation

Der Download ist eine einzige 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_ifthenpay_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_ifthenpay_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_ifthenpay_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Modifikationen, 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 ifthenpay Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern. Die Erweiterung erzeugt bei der Installation ihren Anti-Phishing-Schlüssel.

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 oben auf der Seite ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Wählen Sie die Payment Method, geben Sie deren ifthenpay-Schlüssel ein und klicken Sie auf Save, damit die Callback URL zur gewählten Zahlungsart passt.

5. Kopieren Sie den Anti-phishing Key und die Callback URL aus dem Abschnitt Callback und bitten Sie ifthenpay, den Callback für Ihren Schlüssel zu aktivieren (im Backoffice oder über den ifthenpay-Support).

6. Schalten Sie Enable/Disable ein 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_ifthenpay_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 übernimmt den Code der Erweiterung aus 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 ifthenpay 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 Zahlungsart und deren Schlüssel ein und aktivieren Sie den Callback wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Callback-URL unterscheidet sich (siehe Callback).

Bei einer neuen Installation ist die Zahlungsart zunächst ausgeschaltet und der Testmodus ausgeschaltet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox ifthenpay Gateway > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Ohne den Schlüssel der gewählten Zahlungsart wird die Zahlungsart an der Kasse nicht angezeigt. Solange das Gateway ohne diesen Schlüssel aktiviert ist, zeigt die Seite ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss die Zahlungsart gültig sein, der Titel darf höchstens 128 Zeichen haben, Sort Order muss eine ganze Zahl sein, Total muss eine Zahl von 0 oder mehr sein, und die Geo Zone sowie die Bestellstatus müssen existieren; andernfalls wird nichts gespeichert.

ifthenpay

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

Title: der Titel der Zahlungsart, der an der Kasse angezeigt wird. Er ist außerdem der Name der Zahlungsart, der in der Bestellung gespeichert wird. Standard: ifthenpay. Wenn Sie das Feld leer lassen, zeigt die Kasse ifthenpay an.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay via Multibanco, MB WAY or Credit Card. Ändern Sie ihn, damit er zur angebotenen Zahlungsart passt.

Payment Method: die Zahlungsart, die an der Kasse angeboten wird. Nur der Schlüssel dieser Zahlungsart ist erforderlich.

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

Geo Zone: bieten Sie ifthenpay 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 Kassenbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor ifthenpay angeboten wird. Lassen Sie das Feld leer, um ifthenpay bei jedem Betrag anzubieten. ifthenpay selbst wird nur angeboten, wenn der Kunde in EUR bezahlt, für 0,01 bis 99.999,99 EUR.

ifthenpay-Schlüssel

Die Schlüssel (Format ABC-123456) werden im ifthenpay-Backoffice angezeigt (der Abschnitt verlinkt dorthin) oder von ifthenpay gesendet, wenn die Zahlungsart für Ihr Konto aktiviert wird.

Multibanco Key: Ihr ifthenpay-Schlüssel für Multibanco (MB) für dynamische Referenzen.

MB WAY Key: Ihr ifthenpay-Schlüssel für MB WAY.

Credit Card Key: Ihr ifthenpay-Schlüssel für Credit Card. Er prüft außerdem die Signatur der Rückkehr des Kunden von der Kartenseite.

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.

Callback

Der Callback teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Bitten Sie ifthenpay, den Callback für jeden verwendeten Schlüssel zu aktivieren, mit dem Anti-Phishing-Schlüssel und der Callback-URL aus diesem Abschnitt. Multibanco- und MB-WAY-Bestellungen werden nur durch den Callback bestätigt; Kartenzahlungen werden zusätzlich durch die signierte Rückkehr von der Kartenseite bestätigt.

Anti-phishing Key: wird von der Erweiterung erzeugt und zum Kopieren angezeigt. ifthenpay sendet ihn bei jedem Callback zurück; Callbacks ohne ihn werden abgelehnt.

Callback URL: die Callback-URL für die gewählte Zahlungsart mit den ifthenpay-Platzhaltern, zum Kopieren angezeigt. Sie beginnt unter OpenCart 3 mit https://your-store/index.php?route=extension/payment/wcp_ifthenpay_gateway/callback, unter OpenCart 4 mit https://your-store/index.php?route=extension/wcp_ifthenpay_gateway/payment/wcp_ifthenpay_gateway.callback. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet und enthält danach die Parameter der Zahlungsart. Kopieren Sie die vollständige URL genau so, wie die Einstellungen sie anzeigen. Wenn Sie die Payment Method ändern, speichern Sie und kopieren Sie die neue URL.

Der Anti-Phishing-Schlüssel in jedem Callback wird mit Ihrem verglichen. Ein fehlender oder falscher Schlüssel wird mit 403 beantwortet, und die Bestellung wird nicht verändert. Der Callback muss außerdem zu einer Zahlung dieser Erweiterung passen: bei Multibanco nach Entität und Referenz, bei MB WAY nach der Bestellung und einer ihrer MB-WAY-Anfragen, bei Credit Card nach der Bestellung und einer ihrer Kartenanfragen. Ohne funktionierenden Callback werden Multibanco- und MB-WAY-Bestellungen nie bestätigt, und Kartenzahlungen werden nur durch die signierte Rückkehr bestätigt. Der Callback funktioniert auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und unter OpenCart 4 fügt die Erweiterung eine Startaktion hinzu, die den Callback und die Rückkehr des Kunden von der Kartenseite durchlässt.

Bestellungen

OpenCart erstellt die Bestellung im Schritt Confirm Order ohne Status (eine fehlende Bestellung). Bei Multibanco und MB WAY erhält die Bestellung den Status „wartend“, sobald ifthenpay die Referenz oder die MB-WAY-Anfrage ausgestellt hat; bei Credit Card erhält die Bestellung einen Status erst durch den Callback oder die signierte Rückkehr. Eine Bestellung wird nur dann als bezahlt markiert, wenn der Betrag auf den Cent genau dem Bestellbetrag entspricht. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: der Status, der gesetzt wird, wenn die Zahlung bestätigt ist. Standard: In Bearbeitung.

Awaiting payment status: eine Multibanco-Referenz oder eine MB-WAY-Anfrage wurde ausgestellt, und der Kunde muss noch bezahlen. Die Multibanco-Daten werden mit diesem Status in der Bestell-E-Mail und im Bestellverlauf des Kunden gesendet. Standard: Ausstehend.

Payment on hold status: ifthenpay hat eine Zahlung gemeldet, die nicht zur Bestellung passt (Betrag, Währung), eine Zahlung nach der Stornierung der Bestellung oder eine Zahlung zu einer Bestellung, deren Warenkorb bereits bezahlt war. Eine Notiz erklärt den Grund. Standard: Ausstehend, da OpenCart keinen Status On hold hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Erweitert

Test Mode: Credit Card und Multibanco verwenden die Sandbox-Endpunkte von ifthenpay; es wird kein echtes Geld abgebucht, und Sie verwenden die von ifthenpay bereitgestellten Testschlüssel. MB WAY hat keine Sandbox: testen Sie es mit einem Testschlüssel von ifthenpay. Der Schritt Confirm Order zeigt ein Abzeichen TEST MODE. Standard: aus.

Debug Log: API-Anfragen und Callbacks werden in ifthenpay_p_debug.log.php im Protokollordner von OpenCart (storage/logs) geschrieben. Die Datei kann nicht über das Web geöffnet werden und wird bei 5 MB rotiert. Fehler werden immer protokolliert. Schlüssel, der Anti-Phishing-Schlüssel und vollständige Telefonnummern werden nie protokolliert. 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: ist die Option eingeschaltet, entfernt die Deinstallation der Erweiterung die Gateway-Einstellungen, den Anti-Phishing-Schlüssel und das Protokoll. Bestellungen und die ifthenpay-Zahlungsdatensätze bleiben immer erhalten. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig ifthenpay). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis zur Zahlungsart. OpenCart erstellt die Bestellung in diesem Schritt, weiterhin ohne Status.

Unter OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order.

Multibanco. Der Kunde sieht You will receive a Multibanco reference to complete the payment. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung eine dynamische Multibanco-Referenz für den Bestellbetrag, und die Bestellung erhält den Awaiting payment status. Die Erfolgsseite der Bestellung zeigt Multibanco Payment Details: Entität, Referenz und Betrag, mit Please use these details to pay at any Multibanco ATM or through your online banking. Dieselben Angaben werden in der Bestell-E-Mail gesendet und erscheinen im Bestellverlauf des Kunden. Wurde für die Bestellung bereits eine Referenz mit demselben Betrag ausgestellt, wird sie wiederverwendet. Die Bestellung wird bezahlt, wenn ifthenpay den Zahlungs-Callback sendet.

MB WAY. Der Kunde gibt die MB WAY phone number ein (912 345 678, +351 912 345 678 oder 351#912345678 für andere Länder); die Telefonnummer der Bestellung wird übernommen. Die Erweiterung sendet eine Zahlungsanfrage an das Telefon, und die Bestellung erhält den Awaiting payment status. Die Erfolgsseite der Bestellung sagt A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Die Bestellung wird bezahlt, wenn ifthenpay den Callback sendet. Gespeichert wird nur eine maskierte Telefonnummer. Standardmäßig fragt OpenCart 4 an der Kasse keine Telefonnummer ab; das Feld bleibt dann leer und der Kunde gibt die Nummer ein.

Credit Card. Der Kunde sieht You will be redirected to a secure page to enter your card details. und wird zur Kartenseite von ifthenpay weitergeleitet. Die Bestellung bleibt ohne Status, und der Warenkorb bleibt erhalten. Nach einer erfolgreichen Zahlung kehrt der Kunde in Ihren Shop zurück. Die Rückkehr wird nur mit einer gültigen ifthenpay-Signatur, einem Geheimwert dieses Versuchs und einer Kartenanfrage der Bestellung akzeptiert; dann wird die Bestellung als bezahlt markiert, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Lässt sich die Rückkehr nicht prüfen, ändert sich nichts, und eine Seite Payment confirmation zeigt Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. mit den Schaltflächen Check again und Back to checkout; der Callback bestätigt die Zahlung, sobald er eintrifft. Schlägt die Kartenzahlung fehl oder wird sie abgebrochen, kehrt der Kunde mit The card payment was not completed. You can try again or choose another payment method. oder The card payment was cancelled. You can try again or choose another payment method. zur Kasse zurück. Jeder Kartenversuch der Bestellung wird aufbewahrt, sodass eine Zahlung aus einem älteren Tab weiterhin akzeptiert wird. Unter OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt.

Wenn die Zahlung bestätigt wird, erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails. OpenCart 3 erstellt jedes Mal eine neue Bestellung, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung des Checkouts, sodass der Kunde nach einer abgebrochenen oder fehlgeschlagenen Kartenzahlung oder einer abgelehnten MB-WAY-Anfrage mit einem neuen Versuch dieselbe Bestellung bezahlt. Hat derselbe Warenkorb bereits eine bezahlte Bestellung oder eine Bestellung, die auf eine Multibanco- oder MB-WAY-Zahlung wartet, gelangt der Kunde zur Erfolgsseite dieser Bestellung, statt eine neue Zahlung zu starten. Die Multibanco-Daten und der MB-WAY-Hinweis werden auf der Erfolgsseite nur angezeigt, solange die Bestellung auf die Zahlung wartet. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

OpenCart 4 behält die Bestellung im Checkout, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel haben Sie eine auf eine Multibanco-Zahlung wartende Bestellung 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. Ist die Bestellung bereits aufgegeben und der Warenkorb danach geändert worden, lautet die Meldung Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. In beiden Fällen bezahlt das nächste Confirm Order eine neue Bestellung des Warenkorbs.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, zum Beispiel The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. oder The payment service is temporarily unavailable. Please try again in a few minutes. Der technische Grund wird im Protokoll festgehalten.

Die Erweiterung bietet jeweils eine ifthenpay-Zahlungsart an. Sie unterstützt kein Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX oder Pay-by-Link, keine Abonnements oder gespeicherten Karten, kein automatisches Ablaufen oder Stornieren unbezahlter Multibanco-Referenzen und keine Abfrage des Zahlungsstatus.

Bestellungen

Bestellstatus

No status (missing order): eine Kartenzahlung wurde gestartet und ist noch nicht bestätigt, oder sie ist fehlgeschlagen oder abgebrochen worden. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Awaiting payment status (default Pending): eine Multibanco-Referenz wurde ausgestellt oder eine MB-WAY-Anfrage wurde gesendet. Unbezahlte Referenzen und abgelehnte MB-WAY-Anfragen stornieren die Bestellung nicht automatisch; stornieren Sie solche Bestellungen bei Bedarf selbst.

Order Status After Payment (default Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt die Multibanco-Referenz, die MB-WAY-Transaktion oder die ID der Kartenanfrage und wie die Bestätigung erfolgte.

Payment on hold status (default Pending): der eingegangene Betrag wich vom Bestellbetrag ab (zum Beispiel wurde der Warenkorb nach dem Start einer Kartenzahlung geändert), die Zahlung ist nach der Stornierung der Bestellung eingegangen, oder eine andere Bestellung desselben Warenkorbs war bereits bezahlt. Die Notiz erklärt es, und der Kunde wird nicht aufgefordert, erneut zu zahlen. Prüfen Sie die Zahlung im ifthenpay-Backoffice und schließen oder erstatten Sie die Bestellung manuell ab. Eine spätere korrekte Zahlung für eine solche Bestellung ändert sie nicht.

Eine zweite Zahlung für eine bereits bezahlte Bestellung fügt nur eine Notiz hinzu, damit Sie im ifthenpay-Backoffice nach einer doppelten Zahlung suchen. Eine Bestellung, die Sie in einen anderen Status versetzt haben (zum Beispiel erstattet), wird nie wieder geöffnet; stattdessen wird eine Notiz hinzugefügt.

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

Reiter VibeFox ifthenpay Gateway

Öffnen Sie unter Sales > Orders eine mit ifthenpay bezahlte Bestellung. Am Ende der Bestellseite, neben History und Additional, listet der Reiter VibeFox ifthenpay Gateway die Zahlungsversuche der Bestellung auf (Datum, Methode, eine Kennzeichnung Sandbox bei Testzahlungen, Betrag, Multibanco-Entität und -Referenz oder die maskierte MB-WAY-Telefonnummer, ifthenpay-Anfrage-ID und Status), eine Warnung Payment on hold, solange die Bestellung gehalten wird, und die ifthenpay notes der Bestellung. Der Reiter ist schreibgeschützt und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen aus OpenCart werden nicht unterstützt. Erstatten Sie die Zahlung im ifthenpay-Backoffice und erfassen Sie sie manuell in OpenCart. Produktrücksendungen unter Sales > Returns senden kein Geld über ifthenpay zurück. Ein Callback für eine Erstattung (DEVOLVIDO) fügt nur eine Notiz hinzu. Andere Status, die ifthenpay meldet, fügen ebenfalls nur eine Notiz hinzu.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox ifthenpay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox ifthenpay 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 zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-ifthenpay 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. Kann der Lizenzserver nicht erreicht werden, 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 seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird ifthenpay Kunden an der Kasse nicht angezeigt. Wird eine Zahlung dennoch gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der sich im selben Browser im Admin angemeldet hat, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Unter 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 verborgen. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard im Admin. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. 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 öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cronjob wird nicht benötigt. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

ifthenpay erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der Schlüssel der gewählten Payment Method eingetragen ist, der Kunde in EUR bezahlt und der Betrag zwischen 0,01 und 99.999,99 EUR liegt. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den eingestellten Total-Betrag erreicht.

Der Kunde hat bezahlt, aber die Bestellung bleibt im wartenden Status oder ohne Status: der Callback erreicht Ihren Shop nicht. Prüfen Sie, ob ifthenpay die Callback-URL und den Anti-Phishing-Schlüssel für den verwendeten Schlüssel aktiviert hat und ob die URL die der gewählten Zahlungsart ist. Der Shop muss aus dem Internet erreichbar sein, nicht über localhost und nicht hinter einem Login. Schalten Sie Debug Log ein und sehen Sie sich das Feld Log auf der Erweiterungsseite an.

Callback antwortet 403 Forbidden: der Anti-Phishing-Schlüssel im Callback fehlt oder weicht von dem in den Einstellungen ab. Senden Sie den in den Einstellungen angezeigten Schlüssel erneut an ifthenpay.

Callback antwortet 503 Not configured: der Anti-Phishing-Schlüssel wurde noch nicht erzeugt. Öffnen Sie die Einstellungen der Erweiterung einmal; ifthenpay wiederholt den Callback.

Callback antwortet 503 Busy: dieselbe Bestellung wurde in diesem Moment von einer anderen Anfrage verarbeitet. ifthenpay wiederholt den Callback.

Callback antwortet Order not found: die Referenz oder Anfrage gehört nicht zu einer Zahlung dieser Erweiterung, oder die Bestellung wurde mit einer anderen Zahlungsart aufgegeben.

Warum wurde eine bezahlte Bestellung gehalten? Der eingegangene Betrag wich vom Bestellbetrag ab, die Zahlung ist nach der Stornierung der Bestellung eingegangen, oder eine andere Bestellung desselben Warenkorbs war bereits bezahlt. Lesen Sie die Notizen im Reiter VibeFox ifthenpay Gateway, prüfen Sie die Zahlung im ifthenpay-Backoffice und schließen oder erstatten Sie die Bestellung manuell ab.

MB-WAY-Anfrage konnte nicht gesendet werden: die Telefonnummer ist nicht mit MB WAY verknüpft oder hat ein falsches Format. Verwenden Sie 912 345 678 oder 351#912345678 für Nummern anderer Länder.

Testmodus und MB WAY: ifthenpay hat keine Sandbox für MB WAY; verwenden Sie einen von ifthenpay bereitgestellten Testschlüssel.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox ifthenpay 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 des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch das OpenCart-Ereignis der Erweiterung wird entfernt (unter OpenCart 4 auch dessen Ereignisse und Startaktion, die den Callback und die Rückkehr des Kunden im Wartungsmodus durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen, der Anti-Phishing-Schlüssel und das Protokoll entfernt; nach einer Neuinstallation wird ein neuer Anti-Phishing-Schlüssel erzeugt, der erneut an ifthenpay gesendet werden muss. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die ifthenpay-Zahlungsdatensätze (Referenzen und Anfrage-IDs) bleiben immer erhalten, sodass Callbacks für zuvor ausgestellte Referenzen nach einer Neuinstallation weiterhin ihre Bestellungen finden. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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