VibeFox Niubiz 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: Peruanische Sol (PEN) oder US-Dollar (USD) müssen unter System > Localisation > Currencies aktiviert sein. Die Zahlungsart wird nur angeboten, wenn der Kunde in einer dieser Währungen bezahlt. Für andere Währungen wird sie in der Kasse ausgeblendet.

Niubiz-Konto: Niubiz stellt für jede Umgebung eine Händler-ID (código de comercio), einen API-Benutzer und ein API-Passwort aus. Die Sandbox-Zugangsdaten erhalten Sie vom Integrationsteam von Niubiz, die Produktivdaten, nachdem Niubiz Ihre Integration zertifiziert hat. Ein Webhook muss nicht eingerichtet werden: Niubiz beantwortet die Autorisierung sofort.

VibeFox-Lizenzschlüssel: Erwerb über vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_niubiz_payment-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_niubiz_payment.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_niubiz_payment-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 und wählen Sie den Typ Payments. Suchen Sie VibeFox Niubiz Payment und klicken Sie auf Install (die grüne Schaltfläche +). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu bearbeiten.

3. Klicken Sie auf Edit (die Schaltfläche mit dem Stift), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel in den Lizenzbereich oben auf der Seite unter License key ein und klicken Sie auf Activate (siehe License key).

4. Lassen Sie Sandbox mode aktiviert und geben Sie die Sandbox-Händler-ID, den API-Benutzer und das API-Passwort ein (siehe Configuration).

5. Aktivieren Sie Enable/Disable, klicken Sie auf Save und führen Sie einige Testzahlungen mit den Testkarten von Niubiz durch.

6. Nachdem Niubiz Ihre Integration zertifiziert hat, geben Sie die Produktivzugangsdaten ein und deaktivieren Sie Sandbox mode.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_niubiz_payment.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 Niubiz Payment, klicken Sie auf Install (die grüne Schaltfläche +) und dann auf Edit (die Schaltfläche mit dem Stift).

4. Geben Sie den Lizenzschlüssel und die Niubiz-Zugangsdaten ein und testen Sie die Zahlungen wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Bei einer neuen Installation ist die Zahlungsart zunächst deaktiviert und der Sandbox-Modus aktiviert.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Niubiz Payment > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen warnt die Seite Sie, wenn im Shop keine Währung PEN oder USD aktiviert ist oder die Zugangsdaten des aktuellen Modus unvollständig sind (in beiden Fällen wird die Zahlungsart in der Kasse ausgeblendet). Ist die Standardwährung des Shops weder PEN noch USD, weist die Seite darauf hin, dass Niubiz nur angeboten wird, wenn der Kunde in PEN oder USD bezahlt. Solange der Sandbox-Modus aktiv ist, zeigt die Seite Sandbox mode is on: payments go to the Niubiz sandbox and no real charges are made. an. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen zwar an, kann sie aber nicht speichern.

Beim Speichern wird ein fehlerhafter Wert nicht übernommen: Die Seite zeigt oberhalb der Einstellungen eine Fehlermeldung an, das Feld kehrt zu seinem vorherigen Wert zurück und die übrigen Felder werden gespeichert. Dies betrifft einen leeren Title oder einen mit mehr als 128 Zeichen, eine Händler-ID, die nicht ausschließlich aus Ziffern besteht, eine Logo-URL, die nicht mit https:// beginnt, eine Sort Order, die keine ganze Zahl ist, und einen Total, der keine Zahl größer oder gleich 0 ist.

Niubiz

Enable/Disable: schaltet Niubiz-Zahlungen ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den der Kunde in der Kasse sieht. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Credit or debit card (Niubiz). Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Standard: Pay securely with Visa, Mastercard, American Express or Diners Club in the Niubiz payment form.

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

Geo Zone: bietet Niubiz nur für Zahlungsadressen in der ausgewählten Geozone an. Standard: All zones. Geozonen werden unter System > Localisation > Geo Zones eingerichtet. Auf OpenCart 4 wird, wenn der Shop keine Zahlungsadresse abfragt, die Lieferadresse verwendet.

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

Niubiz-Zugangsdaten

Niubiz stellt Ihnen eine Händler-ID, einen API-Benutzer und ein API-Passwort für die Sandbox (QA) und nach der Zertifizierung für den Produktivbetrieb bereit. Eine bereits gestartete Zahlung wird immer mit den Zugangsdaten ihres eigenen Modus autorisiert.

Sandbox mode: verwendet die Niubiz-Sandbox ohne echte Belastungen. Dabei werden sowohl die API-Endpunkte als auch die unten stehenden Zugangsdaten umgeschaltet. Standard: on. Deaktivieren Sie die Option, um mit den Produktivzugangsdaten echte Zahlungen anzunehmen. Solange sie aktiviert ist, sehen Kunden im Schritt Confirm Order und auf der Zahlungsseite den Hinweis SANDBOX MODE: use Niubiz test cards — no real charges are made.

Sandbox merchant ID: der Händlercode (código de comercio) Ihres Sandbox-Kontos, nur Ziffern. Leerzeichen werden entfernt.

Sandbox API user: der API-Benutzer der Sandbox, meist eine E-Mail-Adresse.

Sandbox API password: das API-Passwort der Sandbox.

Production merchant ID: der Händlercode Ihres Produktivkontos (angeschlossenes Konto), nur Ziffern.

Production API user: der API-Benutzer des Produktivbetriebs.

Production API password: das API-Passwort des Produktivbetriebs.

Gespeicherte Passwörter werden nie wieder angezeigt und nie an den Browser gesendet. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um ein gespeichertes Passwort zu entfernen, aktivieren Sie unter dem Feld Clear the saved password on save und klicken Sie auf Save.

Zahlungsformular

Logo URL: optionale Adresse Ihres Logos, das im Niubiz-Zahlungsformular angezeigt wird. Sie muss eine https://-Adresse sein. Lassen Sie das Feld leer, um den Shopnamen anzuzeigen.

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst dann einen Status, wenn Niubiz auf die Autorisierung geantwortet hat. Jedes der folgenden Felder listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: Niubiz hat die Zahlung genehmigt, und Zahlungsnummer, Betrag und Währung stimmen mit der Bestellung überein. Standard: Processing.

On Hold Status: Niubiz hat eine Zahlung genehmigt, die nicht zur Bestellung passt, oder hat keine eindeutige Antwort gegeben, sodass die Karte möglicherweise belastet wurde. Standard: Pending, da OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und ihn hier auswählen.

Erweitert

Debug log: schreibt die Anfragen an die Niubiz-API und die Zahlungsschritte in die Datei niubiz_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden; bei 5 MB wird sie nach niubiz_p_debug.old.log.php verschoben. Fehler und Warnungen werden immer protokolliert, auch wenn dieser Schalter deaktiviert ist. Passwörter, Tokens sowie Karten- und Kundendaten werden nie protokolliert. Standard: off.

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 das Deinstallieren der Erweiterung die Gateway-Einstellungen und das Protokoll. Die Niubiz-Zahlungsdaten der Bestellungen (Zahlungsnummern, Transaktions-IDs) werden immer aufbewahrt. Standard: off.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. API-Passwörter werden nicht exportiert.

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit or debit card (Niubiz)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will complete the payment in the secure Niubiz payment form. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Auf 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. Wenn der Kunde auf Confirm Order klickt, fordert die Erweiterung bei Niubiz ein Zugriffstoken und eine Zahlungssitzung für den Bestellbetrag in der Bestellwährung an und öffnet die Seite Niubiz payment Ihres Shops. Kann die Sitzung nicht erstellt werden, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel We could not connect to Niubiz. Please try again in a few minutes.

Auf der Zahlungsseite öffnet sich das Niubiz-Zahlungsformular automatisch. Die Seite weist darauf hin: Complete the payment in the secure Niubiz payment form — your card details are entered on Niubiz, not on this site. Außerdem gibt es eine Schaltfläche Pay mit dem Bestellbetrag, um das Formular erneut zu öffnen, und einen Link Choose another payment method zurück zur Kasse. JavaScript ist erforderlich. Kann das Niubiz-Formular nicht geladen werden, zeigt die Seite The Niubiz payment form could not be loaded. Please reload the page or try again later. an.

Der Kunde gibt die Karte im Niubiz-Formular ein. Niubiz übermittelt Ihrem Shop ein einmaliges Token, und die Erweiterung autorisiert es auf dem Server mit dem Betrag, der Währung und der Zahlungsnummer der Sitzung in der Umgebung, in der die Sitzung erstellt wurde. Die Zahlung wird sofort belastet. Die Bestellung wird erst als bezahlt markiert, wenn Niubiz sie bestätigt und die Antwort mit der Bestellung übereinstimmt. 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.

Abgelehnte Karte: Die Bestellung bleibt ohne Status, und es wird eine Notiz hinzugefügt. Der Kunde kehrt zur Zahlungsseite zurück, mit Your payment was declined: und dem Grund von Niubiz, und kann es mit derselben oder einer anderen Karte erneut versuchen. Das Formular öffnet sich nicht erneut über der Meldung; der Kunde klickt auf Pay.

Keine Antwort von Niubiz: Gibt Niubiz keine eindeutige Antwort (Zeitüberschreitung, Serverfehler, unlesbare Antwort), erhält die Bestellung den On Hold Status, und die Erfolgsseite zeigt We could not confirm your payment with Niubiz. Please do not pay again — the store will verify the payment and contact you. Hat Niubiz eine Zahlung genehmigt, die nicht zur Bestellung passt, zeigt die Erfolgsseite Your payment was received and is being reviewed by the store. We will contact you if anything else is needed.

Anfrage abgelehnt: Lehnt Niubiz die Anfrage selbst ab (zum Beispiel bei ungültigen Zugangsdaten oder einer doppelten Zahlungsnummer), bleibt die Bestellung ohne Status, es wird eine Notiz hinzugefügt, und der Kunde sieht Niubiz could not process the payment and your card was not charged. Ist die Niubiz-API in diesem Moment nicht erreichbar, sieht der Kunde We could not connect to Niubiz and your card was not charged. Please try again in a few minutes.

Bestellung geändert: Stimmt der Bestellbetrag beim Absenden des Formulars nicht mehr mit der Sitzung überein, wird die Zahlung nicht autorisiert, und der Kunde sieht Your order total has changed since the payment form was opened, so your card was not charged. Please check the total and pay again.

Sitzung abgelaufen: Eine Niubiz-Zahlungssitzung ist bis zu 20 Minuten gültig. Wurde sie bereits verwendet, ist sie weniger als 5 Minuten gültig, gehört sie zu einem anderen Modus oder einer anderen Händler-ID oder hat sich der Bestellbetrag geändert, erstellt die Zahlungsseite eine neue Sitzung.

Jeder Zahlungsversuch erhält eine neue Zahlungsnummer: die Bestellnummer, gefolgt von einer dreistelligen Versuchsnummer, da Niubiz für jede Autorisierung eine eindeutige Zahlungsnummer verlangt. 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 aktualisiert sie, sodass der Kunde nach einer abgelehnten Karte dieselbe Bestellung mit einer neuen Zahlungsnummer bezahlt. Ein bereits bezahlter Warenkorb wird jedoch nicht erneut bezahlt: Der Kunde wird stattdessen zur Erfolgsseite der bezahlten Bestellung geleitet.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel haben Sie sie storniert), wird der Kunde mit Your previous order was cancelled or its payment failed. Please confirm the order again. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung. Hat diese Bestellung bereits einen Status und enthält der Warenkorb nun andere Produkte oder Mengen, lautet die Meldung Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. Auf OpenCart 4 werden die Meldungen, die den Kunden zurück zur Kasse schicken, etwa The Niubiz payment could not be found. Please confirm your order again., oberhalb der Kassenseite angezeigt.

Die Zahlungsseite, die Antwort des Niubiz-Formulars und die Rückkehr in den Shop funktionieren auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu.

Die Erweiterung unterstützt nur einmalige Kartenzahlungen. Sie bietet keine Erstattungen oder Stornierungen aus OpenCart, keine gespeicherten Karten, Abonnements oder wiederkehrenden Zahlungen, keine Auswahl von Ratenzahlungen (cuotas) und keine PagoEfectivo, Yape oder andere Wallets und QR-Zahlungen. Bestellungen, die wegen einer verlorenen Antwort angehalten wurden, werden nicht automatisch erneut geprüft.

Bestellungen

Bestellstatus

Kein Status (fehlende Bestellung): Der Kunde befindet sich auf der Zahlungsseite und hat nicht bezahlt, oder die Karte wurde abgelehnt oder die Anfrage wurde verweigert. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt. Ablehnungen und Verweigerungen werden den Bestellnotizen hinzugefügt.

Auf OpenCart 4 kann eine unbezahlte Bestellung der Kasse den Status Voided erhalten, den OpenCart 4 setzt, wenn der Kunde zum Schritt Confirm Order zurückkehrt. Die Erweiterung behandelt eine solche Bestellung wie eine Bestellung ohne Status, und eine spätere Zahlung bestätigt sie trotzdem.

Order Status After Payment (Standard Processing): Niubiz hat die Zahlung genehmigt, und die Antwort stimmte mit der Bestellung überein. Eine Notiz zeigt die Umgebung, die Transaktions-ID, den Autorisierungscode, die Zahlungsnummer und die Kartenmarke mit der maskierten Kartennummer.

On Hold Status (Standard Pending), genehmigt, aber nicht übereinstimmend: Niubiz hat eine Zahlung genehmigt, deren Zahlungsnummer, Betrag oder Währung von der Bestellung abweicht oder deren Antwort keinen Betrag oder keine Währung enthält. Die Bestellung wird nicht als bezahlt markiert. Die Notiz listet die Unterschiede auf. Prüfen Sie die Transaktion in der Niubiz-Konsole.

On Hold Status (Standard Pending), keine eindeutige Antwort: Niubiz hat nicht eindeutig geantwortet, daher wurde die Karte möglicherweise belastet. Die Notiz nennt die Zahlungsnummer. Suchen Sie sie in der Niubiz-Konsole: Ist die Transaktion genehmigt und korrekt, setzen Sie die Bestellung auf den Status für bezahlt; falls nicht, stornieren Sie sie.

Wird für einen bereits bezahlten Warenkorb eine zweite Zahlung beantwortet, wird kein zweiter Status gesetzt. Eine Notiz an der bezahlten Bestellung nennt die Zahlungsnummer, Transaktions-ID und den Betrag, damit Sie sie in der Niubiz-Konsole prüfen und bei Bedarf erstatten oder stornieren können.

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

Registerkarte VibeFox Niubiz Payment

Öffnen Sie unter Sales > Orders eine mit Niubiz bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Niubiz Payment die Zahlungsnummer, die Umgebung (Sandbox oder Produktivbetrieb), die Niubiz answer, die Transaktions-ID, den Autorisierungscode, die Karte, den Betrag (und den von Niubiz genehmigten Betrag), gefundene Probleme, die Anzahl der Versuche und die Niubiz notes der Bestellung. Bei einer Bestellung im Status „On Hold“ erinnert die Registerkarte Sie daran, die Zahlungsnummer in der Niubiz-Konsole zu prüfen. Die Registerkarte ist schreibgeschützt und wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Erstattungen und Stornierungen sind in OpenCart nicht verfügbar. Erstatten oder stornieren Sie die Transaktion in der Niubiz-Konsole und aktualisieren Sie den Bestellstatus manuell. Produktrücksendungen unter Sales > Returns zahlen kein Geld über Niubiz zurück.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich License — VibeFox Niubiz Payment ist der erste Bereich unter Extensions > Extensions > Payments > VibeFox Niubiz Payment > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel unter License key ein und klicken Sie auf Activate. Danach zeigt der Bereich den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv 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, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-niubiz 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 Bereichs folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Bereich den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Klicken Sie nach einer Änderung der Shopadresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, 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 Shopadresse 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 Niubiz Kunden in 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, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich 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.

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 Cronjob ist nicht erforderlich. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

Niubiz erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Händler-ID, API-Benutzer und API-Passwort des aktuellen Modus ausgefüllt sind (Sandbox-Felder im Sandbox-Modus, Produktivfelder sonst) und der Kunde in PEN oder USD bezahlt. Die Einstellungsseite zeigt eine Warnung, wenn die Zugangsdaten oder die Währungen falsch sind. Prüfen Sie außerdem, ob die Zahlungsadresse in der ausgewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

Die Zahlung ging durch, aber die Bestellung bleibt ohne Status: Niubiz hat für dieses Zahlungsformular keinen Webhook, daher erhält die Bestellung ihren Status nur aus der Antwort auf die Autorisierung. Hat der Kunde das Formular nicht abgeschlossen, wurde nichts bezahlt. Andernfalls sehen Sie im Feld Log auf der Seite der Erweiterung nach und suchen die Zahlungsnummer in der Niubiz-Konsole. Hat Niubiz geantwortet, der Status aber nicht gesetzt werden konnte, sieht der Kunde Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again., und die Erweiterung versucht erneut, den Status zu setzen, sobald der Kunde die Zahlungsseite öffnet oder den Warenkorb erneut bestätigt.

Der Kunde sieht We could not connect to Niubiz: Das Zugriffstoken konnte nicht abgerufen werden. Prüfen Sie den API-Benutzer und das API-Passwort des aktuellen Modus sowie ob Ihr Server die Niubiz-API erreichen kann. Aktivieren Sie Debug log für Details.

Der Kunde sieht We could not start the Niubiz payment: Niubiz hat die Zahlungssitzung nicht erstellt. Prüfen Sie die Händler-ID des aktuellen Modus und das Protokoll.

Der Kunde sieht This payment attempt was already processed: Dasselbe Formular wurde zweimal abgeschickt. Der Kunde startet die Zahlung auf der Zahlungsseite erneut; die Karte wird nicht doppelt belastet.

Der Kunde sieht This order is already being paid: Eine andere Anfrage autorisiert im selben Moment denselben Warenkorb. Der Kunde wartet kurz und prüft die E-Mails, bevor er es erneut versucht.

Eine Notiz besagt, dass Niubiz eine doppelte Autorisierung gemeldet hat: Niubiz kennt diese Zahlungsnummer bereits. Prüfen Sie sie in der Niubiz-Konsole; der Kunde kann es mit einer neuen Zahlungsnummer erneut versuchen.

Die Bestellung ist im Status „On Hold“: Lesen Sie die Notizen im Reiter VibeFox Niubiz Payment. Niubiz hat keine eindeutige Antwort gegeben oder eine Zahlung genehmigt, die nicht zur Bestellung passt. Suchen Sie die Zahlungsnummer in der Niubiz-Konsole und setzen Sie die Bestellung auf den Status für bezahlt oder stornieren Sie sie.

Fehler beim Speichern der Einstellungen: Eine Händler-ID darf nur Ziffern enthalten, die Logo-URL muss eine gültige https://-Adresse sein, und der Titel darf nicht leer sein oder mehr als 128 Zeichen haben. Der vorherige Wert bleibt erhalten.

Für Entwickler: Wenn Niubiz verlangt, händlerspezifische Betrugspräventionsfelder (MDD) zu senden, kann eine andere Erweiterung sie über das OpenCart-Ereignis niubiz_p_merchant_define_data hinzufügen. Die mit der Zahlungssitzung gesendeten Karteninhaberdaten lassen sich mit dem Ereignis niubiz_p_cardholder_data ändern.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Niubiz Payment 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 (auf OpenCart 4 seine Ereignisse und seine Startaktion, die die Zahlungsseite, die Antwort des Niubiz-Formulars und die Rückkehr im Wartungsmodus durchlässt). Ist Delete data on uninstall aktiviert, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Sandbox-Modus, Zugangsdaten, Logo, Protokollierung) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die Niubiz-Zahlungsversuche (Zahlungsnummern, Umgebung, Transaktions-IDs) werden immer als Zahlungsverlauf aufbewahrt. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

Niubiz ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Niubiz verbunden und wird von Niubiz weder unterstützt noch empfohlen.