VibeFox Netopia 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 mit den Erweiterungen OpenSSL, DOM und SimpleXML.

Währung: der Kunde muss in RON, EUR, USD oder GBP bezahlen. EUR, USD und GBP müssen in Ihrem Netopia-Konto aktiviert sein. Für andere Währungen wird die Zahlungsart an der Kasse ausgeblendet. Die Bestellung wird in ihrer eigenen Währung belastet.

Netopia-Konto: Sie benötigen ein Verkäuferkonto bei Netopia Payments mit einem Verkaufspunkt. Aus dessen technischen Einstellungen benötigen Sie die Kontosignatur und für jede verwendete Umgebung (Sandbox und Live) das öffentliche Zertifikat (.cer) und den privaten Schlüssel (.key). Auf Netopia-Seite muss nichts eingerichtet werden: Die IPN-Adresse wird mit jeder Zahlungsanfrage gesendet.

Öffentlich erreichbarer Shop: Die IPN-(Bestätigungs-)URL muss aus dem Internet erreichbar sein, nicht hinter einer Anmeldung, einer Basisauthentifizierung oder einer Firewall. Bestellungen erhalten ihren Status nur über die IPN von Netopia.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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_netopia_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_netopia_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_netopia_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 Netopia 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. Öffnen Sie im Netopia-Admin Ihren Verkaufspunkt, kopieren Sie die Kontosignatur und laden Sie Zertifikat und privaten Schlüssel der Sandbox- und der Live-Umgebung herunter. Fügen Sie die Signatur und den vollständigen Dateiinhalt in die Einstellungen ein (siehe Konfiguration).

5. Schalten Sie Enable/Disable ein und klicken Sie auf Save. Testen Sie eine Zahlung im Sandbox-Modus und schalten Sie danach Test mode 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_netopia_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 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, wählen Sie den Typ Payments, suchen Sie VibeFox Netopia Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Bleistift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die Kontosignatur, die Zertifikate und die privaten 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 IPN-URL ist anders (siehe Konfiguration).

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 Netopia Gateway > Edit. Die Abschnitte stehen links; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt Sie die Seite, wenn Kontosignatur, Zertifikat oder privater Schlüssel der aktiven Umgebung fehlen (die Zahlungsart wird dann an der Kasse ausgeblendet), und zeigt Test mode is on: payments go to the Netopia sandbox and no real money is charged. an, 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 höchstens 128 Zeichen lang sein, Sort order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Minimum total muss eine Zahl von 0 oder größer sein, und die Geo Zone sowie die Bestellstatus müssen existieren; ist einer dieser Werte falsch, wird nichts gespeichert. Ein ungültiges Zertifikat oder ein ungültiger privater Schlüssel wird mit einer roten Fehlermeldung abgelehnt, und der bisherige Wert bleibt erhalten, während die übrigen Felder gespeichert werden (Settings saved, except the values shown in red.). Ist die Zahlungsart aktiviert, die aktive Umgebung aber unvollständig, zeigt das Speichern eine Warnung.

IPN-(Bestätigungs-)URL

Der erste Abschnitt zeigt die IPN (confirm) URL schreibgeschützt an. Bei OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_netopia_gateway/notify, bei OpenCart 4 so: https://your-store/index.php?route=extension/wcp_netopia_gateway/payment/wcp_netopia_gateway.notify. Sie wird aus der Shop-Adresse Ihrer OpenCart-Installation gebildet. Sie wird mit jeder Zahlungsanfrage als Bestätigungs-URL gesendet, daher müssen Sie sie nicht im Netopia-Admin eintragen. Netopia sendet die IPN an diese URL. Die Erweiterung entschlüsselt sie mit dem privaten Schlüssel der Umgebung, in der die Zahlung gestartet wurde, und prüft Ihre Kontosignatur und die Zahlungsanfrage. Netopia meldet diese Aktionen:

Eine Benachrichtigung mit einem Netopia-Fehlercode (zum Beispiel eine abgelehnte Karte) setzt eine ausstehende Bestellung auf den Status für Zahlungsfehler; eine Bestellung ohne Status bleibt ohne Status, und der Kunde kann erneut bezahlen. Benachrichtigungen, die nicht entschlüsselt werden können, eine andere Kontosignatur tragen oder auf keine Zahlungsanfrage dieser Bestellung in dieser Umgebung antworten, werden abgelehnt und ändern nichts. Benachrichtigungen zu bereits gestarteten Zahlungen werden auch dann angenommen, wenn Sie die Zahlungsart deaktivieren.

Kasse

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

Title: der Titel der Zahlungsart, der an der Kasse angezeigt wird. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Bis zu 128 Zeichen; leer lassen, um den Standardwert zu verwenden. Standard: Card Payment (Netopia).

Description: der Text, der dem Kunden im Schritt Confirm Order angezeigt wird. Standard: Pay securely with your credit or debit card via Netopia.

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

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

Minimum total: der Bestellwert in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Netopia angeboten wird. Lassen Sie das Feld leer, wenn es kein Minimum geben soll.

Netopia-Konto

Gehen Sie im Netopia-Admin zu Seller accounts > your point of sale > Technical settings: Kopieren Sie die Kontosignatur und laden Sie das öffentliche Zertifikat (.cer) und den privaten Schlüssel (.key) jeder Umgebung herunter. Öffnen Sie die Dateien in einem Texteditor und fügen Sie den vollständigen Inhalt ein, einschließlich der BEGIN/END-Zeilen. Der Abschnitt verlinkt auf die Netopia-v1-Dokumentation.

Account signature: die Kontosignatur des Verkäuferkontos (Format XXXX-XXXX-XXXX-XXXX-XXXX), für Sandbox und Live dieselbe.

Test mode: nutzt die Netopia-Sandbox (sandboxsecure.mobilpay.ro) und die Sandbox-Schlüssel. Standard: aktiviert. Schalten Sie ihn aus, um mit den Live-Schlüsseln echte Zahlungen anzunehmen (secure.mobilpay.ro). Solange er eingeschaltet ist, sieht der Kunde im Schritt Confirm Order den Hinweis Test mode (Netopia sandbox): no real money is charged.

Sandbox public certificate (.cer): der Inhalt der öffentlichen Zertifikatsdatei der Sandbox. Er wird zur Verschlüsselung der Zahlungsanfrage verwendet.

Sandbox private key (.key): der Inhalt der privaten Schlüsseldatei der Sandbox. Er wird zur Entschlüsselung der IPN verwendet.

Live public certificate (.cer): der Inhalt der öffentlichen Zertifikatsdatei für die Live-Umgebung.

Live private key (.key): der Inhalt der privaten Schlüsseldatei für die Live-Umgebung.

Gespeicherte private Schlüssel werden nie wieder angezeigt. Das Feld bleibt leer, und sein Hilfetext beginnt mit A private key is saved. Lassen Sie das Feld leer, um den gespeicherten Schlüssel zu behalten, oder fügen Sie einen neuen Schlüssel ein, um ihn zu ersetzen. Um einen gespeicherten Schlüssel zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved private key on save und klicken Sie auf Save. Ein leeres Zertifikatsfeld entfernt das Zertifikat.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Sie erhält erst dann einen Status, wenn Netopia die Zahlung meldet. OpenCart hat keine eigenen Netopia-Bestellstatus, daher listet jedes Feld unten Ihre OpenCart-Bestellstatus auf. Notizen zur Bestellung erklären jede Änderung.

Order status after payment: der Status einer bezahlten Bestellung.

Processing status: Standard: In Bearbeitung.

Completed status: Standard: Abgeschlossen.

Awaiting Netopia payment: eine Vorautorisierung, die auf die Erfassung im Netopia-Admin wartet, oder eine Zahlung, die bei Netopia geprüft wird. Standard: Ausstehend.

Netopia payment on hold: die Zahlung benötigt Ihre Prüfung (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. Die Erweiterung hält die Fälle „ausstehend“ und „in Wartestellung“ auseinander, auch wenn beide denselben Status verwenden.

Canceled status: Netopia hat die Zahlung einer ausstehenden Bestellung storniert. Standard: Storniert.

Payment error status: Netopia hat bei einer ausstehenden Bestellung einen Fehler gemeldet, zum Beispiel eine abgelehnte Karte. Standard: Fehlgeschlagen.

Refunded status: nach den Erstattungen im Netopia-Admin ist nichts mehr zu erstatten. Standard: Erstattet.

Erweitert

Debug log: schreibt Anfragen und die IPN-Verarbeitung in netopia_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über den Webbrowser geöffnet werden; bei 5 MB wird sie nach netopia_p_debug.old.log.php verschoben. Kartendaten, Schlüssel und Kundendaten werden nicht protokolliert. Fehler, zum Beispiel abgelehnte IPNs, werden immer protokolliert, auch wenn die Option ausgeschaltet ist. 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. Bestellungen und die Netopia-Zahlungsdaten bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen einschließlich der Zertifikate als JSON-Datei. Private Schlüssel werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Card Payment (Netopia)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the Netopia secure page to pay with your card. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung die Zahlungsanfrage, verschlüsselt sie mit dem Netopia-Zertifikat der aktiven Umgebung und leitet den Kunden direkt auf die Zahlungsseite von Netopia weiter. Die Anfrage enthält den Bestellbetrag in der Bestellwährung, Order # mit der Bestellnummer sowie die Rechnungs- und Lieferkontaktdaten mit der Telefonnummer der Bestellung. Im Sandbox-Modus geht sie an die Netopia-Sandbox. Bei 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.

Der Kunde bezahlt mit Karte auf der Netopia-Seite und kehrt in Ihren Shop zurück. Die Rückkehr allein bezahlt nie eine Bestellung. Die Bestellung wird erst als bezahlt markiert, wenn Netopia sie per IPN bestätigt. Danach erhält die Bestellung ihren Status auf die übliche OpenCart-Weise, mit der üblichen Bestell-E-Mail und Bestandsaktualisierung, und der Kunde sieht die OpenCart-Erfolgsseite der Bestellung. Bei einer ausstehenden Bestellung zeigt die Seite Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. Bei einer Bestellung in Wartestellung zeigt sie Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. Wenn eine ausstehende oder wartende Bestellung später ihren endgültigen Status erhält (bezahlt, Zahlungsfehler oder storniert), wird der Kunde per E-Mail über den neuen Status informiert. Bei einer stornierten Bestellung zeigt die Seite The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. Bei einer Bestellung mit Zahlungsfehler zeigt sie The payment was declined by Netopia.

Ist die IPN noch nicht eingegangen, wenn der Kunde zurückkehrt, zeigt eine Seite Payment confirmation denselben Text „noch nicht bestätigt“ mit den Schaltflächen Check again und Back to checkout. Die Bestellung erhält ihren Status, sobald die IPN eingeht.

Hat Netopia bei einer Bestellung ohne Status eine Stornierung oder Ablehnung gemeldet, kehrt der Kunde zur Kasse zurück, mit The payment was cancelled at Netopia. You can try again or choose another payment method. oder The payment was declined by Netopia. You can try again or choose another payment method. Bei OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt. Der Warenkorb bleibt erhalten. Jeder neue Versuch ist eine neue Zahlungsanfrage; frühere Anfragen bleiben gültig, sodass eine verspätete IPN eines früheren Versuchs trotzdem erfasst wird. 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 und bezahlt dieselbe Bestellung erneut mit einer neuen Zahlungsanfrage. Ist eine andere Bestellung desselben Warenkorbs bereits bezahlt oder ausstehend oder in Wartestellung, gelangt der Kunde zur Erfolgsseite, und es wird keine neue Zahlung gestartet.

OpenCart 4 behält die Bestellung für die Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel wurde ihre Vorautorisierung storniert, sie wurde abgelehnt, nachdem sie ausstehend war, oder Sie haben sie storniert oder erstattet), wird der Kunde mit Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Eine bezahlte und danach stornierte oder erstattete Bestellung des Warenkorbs blockiert ihn nicht mehr.

Kann die Zahlung nicht gestartet werden, bleibt der Kunde im Schritt Confirm Order mit einer Meldung über der Schaltfläche: Netopia gateway is not configured properly. Please contact the store administrator., Netopia cannot process payments in mit der Währung, This order has nothing to pay. oder Payment encryption failed. Please try again or contact support. Der technische Grund wird im Protokoll festgehalten.

Die IPN funktioniert auch, wenn der Shop im Wartungsmodus ist, da OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und bei OpenCart 4 die Erweiterung dafür eine Startaktion hinzufügt, die auch die Rückkehr des Kunden von Netopia ermöglicht.

Die Erweiterung nimmt Kartenzahlungen ausschließlich über das Netopia-v1-Kartenprotokoll an. Sie bietet keine Erstattungen oder Erfassungen aus OpenCart, keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements, Ratenzahlungen oder anderen Zahlungsarten und keine Netopia-API v2.

Bestellungen und Erstattungen

Order statuses

No status (missing order): der Kunde wurde zu Netopia weitergeleitet und hat nicht bezahlt, Netopia hat die IPN noch nicht gesendet, oder die Zahlung wurde vor einem Ergebnis storniert oder abgelehnt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Processing or Completed status: Netopia hat die Zahlung bestätigt. Der Status richtet sich nach Order status after payment. Eine Notiz zeigt den Betrag, die maskierte Kartennummer und die Netopia-Transaktion; Sandbox-Zahlungen sind mit [sandbox] markiert.

Awaiting Netopia payment: die Zahlung ist eine Vorautorisierung, die auf die Erfassung im Netopia-Admin wartet, oder sie wird bei Netopia geprüft. Die Bestellung wechselt in den bezahlten Status, sobald Netopia die Zahlung bestätigt.

Netopia payment on hold: der Rechnungsbetrag oder die Rechnungswährung weicht von der Bestellung ab, nur ein Teil der Zahlung wurde eingezogen, Netopia hat die Zahlung einer stornierten Bestellung oder einer Bestellung mit einer anderen Zahlungsart bestätigt, oder eine Sandbox-(Test-)Zahlung wurde bestätigt, während der Shop im Livemodus ist (es ist kein echtes Geld eingegangen). Die Bestellung wird nicht als bezahlt markiert; die Notiz erklärt es. Prüfen Sie die Transaktion im Netopia-Admin und bearbeiten Sie dann die Bestellung oder erstatten Sie die Zahlung dort.

Payment error status: Netopia hat bei einer ausstehenden Bestellung einen Fehler gemeldet, zum Beispiel eine abgelehnte Karte.

Canceled status: Netopia hat die Zahlung einer ausstehenden Bestellung storniert.

Refunded status: die Zahlung wurde im Netopia-Admin vollständig erstattet.

Verspätete Benachrichtigungen stufen nie eine bezahlte oder abgeschlossene Bestellung herab. Bestätigt Netopia eine weitere Zahlung für eine bereits bezahlte Bestellung, bittet eine Notiz Sie, das Duplikat im Netopia-Admin zu erstatten. Bezahlt der Kunde eine zweite Bestellung desselben Warenkorbs, bleibt diese Bestellung ohne Status, und die Zahlungsanfrage wird als doppelte Zahlung des Warenkorbs markiert.

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

Reiter VibeFox Netopia Gateway

Öffnen Sie unter Sales > Orders eine mit Netopia bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox Netopia Gateway den Block Netopia Payments: die Netopia-Transaktion, die Umgebung (Sandbox oder Live), die Zahlungsanfrage, den Anfragestatus, die letzte IPN-Aktion, die maskierte Karte, die bezahlten, erstatteten und verbleibenden Beträge, den Erstattungsverlauf und die Netopia notes der Bestellung. Der Reiter ist schreibgeschützt und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen und Erfassungen werden nicht aus OpenCart heraus vorgenommen, da das Netopia-v1-Kartenprotokoll keinen Erstattungsaufruf kennt. Erstatten Sie die Transaktion im Netopia-Admin. Netopia sendet dann eine Gutschrift-IPN, und die Erweiterung erfasst die Erstattung automatisch in der Bestellung mit der Notiz Netopia refund processed: und dem Betrag. Eine Teilerstattung behält den Bestellstatus bei; ist nichts mehr zu erstatten, wird die Bestellung auf Refunded status gesetzt. Bei Bestellungen in EUR, USD und GBP wird der erstattete Betrag, den Netopia in RON meldet, in die Bestellwährung zurückgerechnet. Eine Erstattung wird nie doppelt erfasst und nie für mehr als den verbleibenden Betrag. Meldet Netopia einen Fehler bei der Erstattung, wird nur eine Notiz hinzugefügt.

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

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Netopia Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox Netopia 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-netopia 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 Netopia 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 steht diese Vorschau nicht zur Verfügung: 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. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und im Netopia-Admin vorgenommene Erstattungen werden weiterhin erfasst.

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

Netopia does not appear at checkout: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, die aktive Umgebung vollständig ist (Account signature plus Zertifikat und privater Schlüssel der Sandbox im Testmodus bzw. der Live-Umgebung im Livemodus) und der Kunde in RON, EUR, USD oder GBP bezahlt. Die Einstellungsseite zeigt eine Warnung, wenn etwas fehlt. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo zone liegt und ob die Bestellung den Minimum total erreicht.

The payment went through, but the order stays without a status: die IPN hat Ihren Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie, ob die IPN-(Bestätigungs-)URL aus den Einstellungen aus dem Internet erreichbar ist (ohne Basisauthentifizierung oder Firewall). Sehen Sie sich das Feld Log auf der Seite der Erweiterung an: Abgelehnte IPNs werden immer protokolliert. Schalten Sie Debug log ein, um jede IPN zu sehen. Die Rückkehr des Kunden allein bezahlt nie eine Bestellung.

Log shows failed decrypting data: der private Schlüssel passt nicht zu dem Zertifikat, das Netopia verwendet hat. Die IPN wird mit dem gespeicherten privaten Schlüssel jeder Umgebung entschlüsselt. Behalten Sie daher den Schlüssel der anderen Umgebung gespeichert, solange deren Zahlungen noch offen sind. Netopia wiederholt die IPN.

Log shows signature mismatch: die Account signature unterscheidet sich von dem Verkaufspunkt, der die IPN gesendet hat. Kopieren Sie sie erneut aus dem Netopia-Admin.

Log shows unknown payment request: die IPN bezieht sich auf keine Zahlungsanfrage, die Ihr Shop für diese Bestellung in dieser Umgebung (Sandbox oder Live) gestellt hat. Es wird nichts verändert.

Log shows gateway not configured: es ist kein privater Schlüssel oder keine Kontosignatur gespeichert. Netopia wiederholt die IPN, und die Zahlung wird erfasst, sobald die Einstellungen vollständig sind.

Log shows busy, retry later or processing failed: der Warenkorb wurde im selben Moment von einer anderen Anfrage verarbeitet, oder der Bestellstatus konnte nicht gesetzt werden. Netopia wiederholt die IPN automatisch.

Error on save about the certificate or private key: der eingefügte Text ist kein gültiges Zertifikat oder kein gültiger Schlüssel. Fügen Sie den vollständigen Dateiinhalt einschließlich der BEGIN/END-Zeilen ein. Der bisherige Wert wurde beibehalten.

The customer sees This payment method is not available. Please reload the checkout page.: die Kassensitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Order is in the on-hold status after payment: lesen Sie die Notizen im Reiter VibeFox Netopia Gateway (siehe Order statuses). Betrag oder Währung waren abweichend, nur ein Teil wurde eingezogen, die Bestellung war storniert, oder eine Sandbox-Zahlung wurde bestätigt, während der Shop im Livemodus ist. Prüfen Sie die Transaktion im Netopia-Admin.

A refund made in Netopia does not appear on the order: die Gutschrift-IPN hat den Shop nicht erreicht oder wurde abgelehnt. Prüfen Sie das Protokoll.

Für Entwickler: Die Liste der akzeptierten Währungen kann mit dem OpenCart-Ereignis netopia_p_supported_currencies geändert werden.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Netopia 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, Minimum total und die OpenCart-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 die IPN im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Kontosignatur, Testmodus, Zertifikate, private Schlüssel, Bestellstatus nach Zahlung, Protokollierung) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Netopia-Zahlungsdaten bleiben immer erhalten, sodass eine verspätete IPN einer vor der Neuinstallation gestarteten Zahlung ihre Bestellung noch findet. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Netopia Payments und mobilPay sind Marken ihrer jeweiligen Inhaber. Diese Erweiterung ist nicht mit Netopia Payments verbunden und wird von Netopia Payments nicht unterstützt.