VibeFox Klarna 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.

Klarna-Händlerkonto: Sie benötigen die Klarna-API-Zugangsdaten (Benutzername und Passwort) Ihres Händlerkontos für eine API-Region sowie die Testzugangsdaten aus dem Klarna Playground-Portal (siehe Konfiguration). Jede API-Region hat eigene Zugangsdaten. Pro Shop kann nur ein Händlerkonto (eine API-Region) verwendet werden.

Währung: eine Klarna-Währung Ihrer Region: EUR, SEK, NOK, DKK, GBP, CHF, PLN, CZK, HUF oder RON in Europa; USD, CAD oder MXN in Nordamerika; AUD oder NZD in Ozeanien. Die Währung muss unter System > Localisation > Currencies vorhanden sein.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket wcp_klarna_payment-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_klarna_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_klarna_payment-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 aus diesem Paket in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments, suchen Sie VibeFox Klarna Payments und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

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

4. Wählen Sie die API region Ihres Klarna-Händlerkontos.

5. Geben Sie Benutzername und Passwort für die Testumgebung aus dem Klarna Playground-Portal ein, lassen Sie Test mode eingeschaltet, aktivieren Sie Enable/Disable, klicken Sie auf Save und führen Sie eine Testbestellung durch.

6. Geben Sie Benutzername und Passwort für den Live-Betrieb aus dem Klarna Merchant Portal ein, schalten Sie Test mode aus und wählen Sie, wann Bestellungen erfasst werden (Standard: wenn die Bestellung versendet oder abgeschlossen ist).

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_klarna_payment.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 und wählen Sie den Typ Payments. Suchen Sie VibeFox Klarna Payments, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

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

Eine Neuinstallation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus. Die Benachrichtigungs-URL wird mit jeder Klarna-Bestellung übermittelt, daher müssen Sie bei Klarna nichts konfigurieren.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite TEST MODE: Klarna playground, no real payments. oder LIVE: real Klarna payments. an. Sie warnt, wenn Benutzername oder Passwort des aktiven Modus fehlen (Klarna wird dann an der Kasse ausgeblendet), und wenn Klarna die Standardwährung des Shops in der gewählten API-Region nicht unterstützt. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein (höchstens 128 Zeichen), Sort Order muss eine ganze Zahl sein (negative Zahlen sind erlaubt), Total muss eine Zahl größer oder gleich 0 sein, und API-Region, Erfassungsmodus, Geozone und Bestellstatus müssen gültig sein. Andernfalls wird nichts gespeichert, und die Seite nennt das betreffende Feld. Fehlende Zugangsdaten verhindern das Speichern nicht.

Klarna Payments

Enable/Disable: schaltet die Zahlungsart ein oder aus. Standard: aus. Klarna wird an der Kasse nur angezeigt, wenn Benutzername und Passwort des aktiven Modus ausgefüllt sind und das Rechnungsland des Kunden ein Klarna-Markt der API-Region ist, wobei in der Währung dieses Landes bezahlt wird.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: Klarna. Pflichtfeld.

Description: der Text, der dem Kunden im Schritt Confirm Order über dem Klarna-Widget angezeigt wird. Standard: Pay now, later or in instalments with Klarna.

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

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

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

API-Zugangsdaten

Klarna-API-Zugangsdaten (Benutzername und Passwort) werden im Klarna Merchant Portal unter Settings > Klarna API credentials erstellt (dort sind die Links zum Abschnitt). Die Testzugangsdaten stammen aus dem Playground-Portal: eine für Europa, eine für Nordamerika und Ozeanien. Jede API-Region hat eigene Zugangsdaten.

Test mode: verwendet die Klarna-Testumgebung (Testzugangsdaten, keine echten Zahlungen). Standard: an. Solange der Testmodus aktiv ist, sehen Kunden im Schritt Confirm Order den Hinweis TEST MODE: Klarna playground, no real payment is made.. Bestellungen behalten die Umgebung, in der sie aufgegeben wurden: Erfassungen und Erstattungen von Testbestellungen verwenden immer die Testzugangsdaten.

API region: die Region Ihres Klarna-Händlerkontos. Kunden können nur aus den Ländern dieser Region mit Klarna bezahlen, und zwar in der Währung ihres Landes. Das Land wird aus der Zahlungsadresse der Bestellung übernommen.

Live username (UID): der API-Benutzername für den Produktivbetrieb, zum Beispiel PK12345_abcdef012345.

Live password: das API-Passwort für den Produktivbetrieb (gemeinsames Geheimnis).

Test username (UID): der API-Benutzername der Testumgebung.

Test password: das API-Passwort der Testumgebung (gemeinsames Geheimnis).

Gespeicherte Passwörter werden nie erneut angezeigt. 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.

Bestellverwaltung

Eine aufgegebene Klarna-Bestellung ist eine Autorisierung: Der Kunde wird erst belastet, wenn die Bestellung erfasst wird. Nicht erfasste Autorisierungen verfallen, in der Regel nach 28 Tagen. Versenden Sie Bestellungen daher rechtzeitig oder nutzen Sie die automatische Erfassung.

Capture: der Zeitpunkt, zu dem der Kunde belastet wird. Erstattungen sind nur für erfasste Beträge möglich.

Cancellation: storniert die Klarna-Bestellung (gibt die Autorisierung frei), wenn eine noch nicht erfasste Bestellung auf den unten genannten Canceled Status gesetzt wird. Standard: an.

Bestellstatus

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Einen Status erhält sie erst, nachdem Klarna die Klarna-Bestellung für den im Widget bestätigten Kauf angelegt hat. Ein Kauf, den Klarna nicht genehmigt, lässt die Bestellung ohne Status, und der Kunde bleibt im Schritt Confirm Order. Jedes der folgenden Felder listet Ihre OpenCart-Bestellstatus auf.

Order Status After Payment: Klarna hat den Kauf akzeptiert (Betrugsstatus ACCEPTED). Der Betrag wird autorisiert und gemäß Capture erfasst. Standard: In Bearbeitung.

Awaiting Fraud Review Status: Klarna hat die Bestellung als PENDING (Betrugsprüfung) angelegt. Versenden Sie sie nicht, bevor die Benachrichtigung von Klarna sie akzeptiert; die Bestellung wird automatisch aktualisiert. Standard: Zahlung ausstehend.

On Hold Status: Klarna hat einen unerwarteten Betrugsstatus zurückgegeben, oder Betrag bzw. Währung laut Klarna stimmen nicht mit der Bestellung überein. Eine Notiz erklärt, was zu prüfen ist. Standard: Zahlung ausstehend.

Payment Error Status: Klarna hat den Kauf nach der Betrugsprüfung abgelehnt oder gestoppt. Versenden Sie die Bestellung nicht. Standard: Fehlgeschlagen.

Canceled Status: Wird eine noch nicht erfasste Bestellung auf diesen Status gesetzt, wird die Klarna-Bestellung storniert (siehe Cancellation). Meldet Klarna die Klarna-Bestellung als storniert, abgelaufen oder geschlossen, wird dieser Status gesetzt. Standard: Storniert.

Refunded Status: Der erfasste Betrag wurde auf der Registerkarte VibeFox Klarna Payments der Bestellseite vollständig erstattet. Teilerstattungen fügen nur eine Notiz hinzu. Standard: Erstattet.

OpenCart hat keine eigenen Status für eine Betrugsprüfung oder eine zurückgehaltene Zahlung. Sie können sie unter System > Localisation > Order Statuses anlegen und hier auswählen.

Benachrichtigungen

Klarna meldet das Ergebnis einer Betrugsprüfung (als ausstehend angelegte Bestellungen) an die Adresse, die unter Notification URL angezeigt wird. Auf OpenCart 3 hat sie die Form https://your-store/index.php?route=extension/payment/wcp_klarna_payment/notification, auf OpenCart 4 die Form https://your-store/index.php?route=extension/wcp_klarna_payment/payment/wcp_klarna_payment.notification. Die URL wird automatisch mit jeder Bestellung übermittelt, daher ist bei Klarna nichts einzurichten. Der Inhalt der Benachrichtigung wird nie ungeprüft übernommen: Jede Benachrichtigung wird über die Klarna Order Management API überprüft, und zwar mit den Zugangsdaten der Umgebung und Region, in der die Bestellung aufgegeben wurde. Die Klarna-Bestellung muss sich auf diese Bestellnummer beziehen. Die Erweiterung handelt auf Grundlage dessen, was Klarna meldet:

Akzeptiert Klarna einen Kauf, nachdem Sie die Bestellung storniert oder erstattet haben, wird die Bestellung nicht wieder geöffnet, und die Klarna-Autorisierung wird freigegeben. Die Benachrichtigung funktioniert auch, wenn der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die die Benachrichtigung und die Rückkehr des Kunden von Klarna durchlässt.

Erweitert

Debug log: protokolliert API-Aufrufe und Zahlungsereignisse in wc_kl_debug.log.php im Logordner von OpenCart (storage/logs). Die Datei kann nicht über das Web geöffnet werden. Fehler werden immer protokolliert. Das Protokoll enthält nie Zugangsdaten, Autorisierungstoken oder Kundendaten. 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 eingeschaltet, werden beim Deinstallieren der Erweiterung die Einstellungen des Gateways, das Protokoll und die temporären Widget-Sitzungen entfernt. Bestelldaten (Klarna-Bestell-IDs, Erstattungen) bleiben immer erhalten. Standard: aus.

Import / Export

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

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

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Klarna). OpenCart legt die Bestellung im Schritt Confirm Order an, weiterhin ohne Status. In diesem Schritt sieht der Kunde das Klarna-Badge, Ihre Beschreibung und das Klarna-Widget. Die Erweiterung erstellt die Klarna-Sitzung auf dem Server aus dieser Bestellung: Produkte mit ihren Optionen, Geschenkgutscheine, Versand, Rabatte aus Coupons, Gutscheinen und Bonuspunkten, Steuern und Adressen. Im Widget wählt der Kunde Jetzt bezahlen, Später bezahlen oder Ratenzahlung, je nach dem, was Klarna anbietet. Klickt der Kunde auf Confirm Order, autorisiert Klarna den Kauf im Widget, und die Erweiterung legt die Klarna-Bestellung serverseitig mit den Daten der OpenCart-Bestellung an. Die Klarna-Bestellung enthält die OpenCart-Bestellnummer als Händlerreferenz.

Bei OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options. Das Klarna-Widget erscheint dann im Block zur Bestellbestätigung unten auf der Kasse, über der Schaltfläche Confirm Order. OpenCart 4 kennt keine Geschenkgutscheine, daher werden keine an Klarna übermittelt. Standardmäßig fragt OpenCart 4 nicht nach einer Zahlungsadresse; die Erweiterung verwendet dann die Lieferadresse als Rechnungsadresse und deren Land als Kaufland.

Das Ergebnis hängt vom Betrugsstatus von Klarna ab:

Kann Klarna die Bestellung nicht annehmen, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel Klarna could not accept this order. Please check your billing details or choose another payment method., Klarna did not respond. Please try again in a moment. oder, wenn die Autorisierung abgelaufen ist, mit der Aufforderung, erneut auf „Confirm Order“ zu klicken. Die Details werden im Protokoll festgehalten, und die Bestellung erhält eine Notiz. Stimmen Land und Währung des Kunden mit keinem Klarna-Markt Ihrer Region überein, sieht der Kunde Klarna is not available for your billing country and currency. Please choose another payment method.

Doppelklicks, das Neuladen der Seite oder die Bezahlung desselben Warenkorbs in einem zweiten Browsertab erzeugen nie eine zweite Klarna-Bestellung (OpenCart 3 legt jedes Mal eine neue Bestellung an, wenn der Schritt Confirm Order angezeigt wird; OpenCart 4 aktualisiert die Bestellung der Kasse, sodass der Kunde nach einer abgelehnten Zahlung dieselbe Bestellung bezahlt). Hat Klarna den Kauf genehmigt, der Bestellstatus aber nicht gesetzt werden konnte, sieht der Kunde Your Klarna purchase was approved, but the order could not be completed automatically. Please contact us — do not pay again. Der nächste Versuch oder die Benachrichtigung von Klarna setzt den Status anhand der gespeicherten Klarna-Bestellung, ohne eine neue Autorisierung. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

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 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 hat sich 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. In beiden Fällen bezahlt das nächste Confirm Order eine neue Bestellung des Warenkorbs. Diese Meldungen werden über der Kasse angezeigt.

Die Erweiterung unterstützt weder Klarna Checkout (KCO, vollständiger Ersatz der Kasse), Klarna Express Checkout-Schaltflächen, On-site messaging oder Sign in with Klarna, keine Abonnements oder gespeicherten Zahlungsmethoden und keine Teilerfassungen je Bestellposition. Bestellpositionen werden nicht erneut an Klarna übermittelt, wenn Sie eine Bestellung nach dem Aufgeben bearbeiten.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde hat die Klarna-Autorisierung nicht abgeschlossen, oder Klarna hat den Kauf abgelehnt. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (default Processing): Klarna hat den Kauf akzeptiert. Eine Notiz zeigt die Klarna-Bestell-ID und den Zeitpunkt der Erfassung.

Awaiting Fraud Review Status (default Pending): Der Kauf wartet auf die Betrugsprüfung durch Klarna. Die Benachrichtigung von Klarna setzt die Bestellung auf Order Status After Payment, Payment Error Status oder Canceled Status.

On Hold Status (default Pending): Klarna hat einen unerwarteten Betrugsstatus zurückgegeben, oder Betrag bzw. Währung laut Klarna stimmen nicht mit der Bestellung überein. Die Notiz erklärt dies. Prüfen Sie die Bestellung im Klarna Merchant Portal.

Payment Error Status (default Failed): Klarna hat den Kauf nach der Betrugsprüfung abgelehnt oder gestoppt. Versenden Sie die Bestellung nicht.

Canceled Status (default Canceled): Sie haben die Bestellung storniert, oder Klarna meldet die Klarna-Bestellung als storniert, abgelaufen oder geschlossen. Ist Cancellation aktiv, storniert das Stornieren einer noch nicht erfassten Bestellung auch die Klarna-Bestellung und gibt die Autorisierung frei, sodass der Kunde nicht belastet wird. Eine bereits erfasste Bestellung wird bei Klarna nicht storniert: Erstatten Sie sie, um das Geld zurückzugeben.

Refunded Status (default Refunded): Der erfasste Betrag wurde über die Erweiterung vollständig erstattet.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht. Sie beginnen mit dem Wort Klarna.

Capture

Bei When the order is shipped / completed erfasst das Ändern des Status einer Bestellung unter Sales > Orders (Add History) auf einen abgeschlossenen Status den Bestellbetrag, bevor der neue Status gespeichert wird. Lehnt Klarna die Erfassung ab, etwa weil der Bestellbetrag nach einer Bearbeitung über den noch autorisierten Betrag gestiegen ist, bleibt der Status unverändert, es wird keine E-Mail versendet, und die Bestellseite zeigt den Grund statt der Erfolgsmeldung. Eine Notiz besagt, dass der Kunde NICHT belastet wurde. Beheben Sie das Problem und ändern Sie den Status erneut, um es erneut zu versuchen, oder erfassen Sie im Klarna Merchant Portal und stellen Sie Capture auf manuell. Eine erfolgreiche Erfassung fügt eine Notiz mit dem erfassten Betrag und der Erfassungs-ID hinzu. Der erste Status einer neuen Bestellung und ein Wechsel von einem abgeschlossenen Status zu einem anderen abgeschlossenen Status erfassen nichts. Erfassungen und Stornierungen funktionieren weiter, solange die Erweiterung installiert, aber ausgeschaltet ist. Auf OpenCart 4.1 zeigt die abgelehnte Statusänderung den Grund zusätzlich auf der Bestellseite; auf OpenCart 4.0.x wird der Status ebenfalls abgelehnt, der Grund wird aber nur in der Notiz des Bestellverlaufs angezeigt.

Registerkarte VibeFox Klarna Payments

Öffnen Sie unter Sales > Orders eine mit Klarna bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox Klarna Payments die Klarna-Bestell-ID mit Umgebung und Region, ein Etikett Playground für Testbestellungen, den Betrugsstatus und den Klarna-Status, den Betrag Authorized, die Beträge Captured / refunded, das Erstattungsformular, den Erstattungsverlauf und die Klarna notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie auf der Registerkarte VibeFox Klarna Payments den Amount ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Klarna. Bestätigen Sie die Frage Refund this amount through Klarna? This cannot be undone. Vollständige und Teilerstattungen sind für erfasste Beträge möglich, maximal bis zu dem Betrag, den Klarna als erfasst abzüglich bereits erstatteter Beträge meldet. Sie benötigen das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups). Die Erstattung wird an die Umgebung und Region gesendet, in der die Bestellung aufgegeben wurde, daher müssen die Zugangsdaten dieser Umgebung hinterlegt sein. Akzeptiert Klarna die Erstattung nicht, zeigt die Registerkarte den Fehler an, und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Klarna-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, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht. Eine wiederholte Erstattung wird nie zweimal ausgeführt.

Eine noch nicht erfasste Bestellung kann nicht erstattet werden: Stornieren Sie sie stattdessen, um die Autorisierung freizugeben. Ist Capture auf manuell gestellt, weiß der Shop nicht, was Sie im Klarna Merchant Portal erfasst haben. Das Erstattungsformular wird dann mit leerem Betrag angezeigt, und Klarna prüft den Betrag beim Absenden.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über Klarna. Im Klarna Merchant Portal vorgenommene Erstattungen werden nicht in die Registerkarte übernommen, zählen aber zu dem Betrag, den Klarna noch erstatten lässt.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Klarna Payments ist der erste Block unter Extensions > Extensions > Payments > VibeFox Klarna Payments > 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, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-klarna und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht 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. Nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Klarna Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 gibt es diese Vorschau nicht: 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 bleiben unberührt: Klarna-Benachrichtigungen werden weiterhin verarbeitet, und Bestellungen lassen sich weiterhin erfassen, stornieren und erstatten.

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 des Admin-Bereichs öffnen: täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Klarna erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Zugangsdaten des aktiven Modus ausgefüllt sind: Benutzername und Passwort für den Test im Testmodus, die Live-Zugangsdaten im Live-Modus. Die Einstellungsseite zeigt eine Warnung, wenn sie fehlen. Das Zahlungsland des Kunden muss ein Klarna-Land Ihrer API region sein, und der Kunde muss in der Währung dieses Landes zahlen (ein Kunde aus Schweden zahlt zum Beispiel in SEK). Prüfen Sie außerdem, ob die Zahlungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total-Betrag erreicht.

Die Zahlung ist eingegangen, die Bestellung bleibt aber in Awaiting Fraud Review Status: Der Kauf wartet auf die Betrugsprüfung durch Klarna, und die Bestellung wird aktualisiert, sobald die Benachrichtigung von Klarna eintrifft. Prüfen Sie, ob Ihr Shop Anfragen von Klarna an der Notification URL aus den Einstellungen empfangen kann und ob die Zugangsdaten der Umgebung, in der die Bestellung aufgegeben wurde, noch hinterlegt sind. Schalten Sie Debug log ein und sehen Sie im Feld Log auf der Seite der Erweiterung nach.

Die Benachrichtigung antwortet Not configured: Die Zugangsdaten der Umgebung (Test oder Live), in der die Bestellung aufgegeben wurde, fehlen, daher kann die Benachrichtigung nicht überprüft werden. Tragen Sie sie ein. Klarna wiederholt die Benachrichtigung.

Die Benachrichtigung antwortet Verification failed: Die Klarna-Bestellung konnte nicht über die Order Management API gelesen werden. Klarna wiederholt die Benachrichtigung.

Die Benachrichtigung antwortet Busy: Die Bestellung wurde im selben Moment durch eine andere Anfrage aktualisiert. Klarna wiederholt die Benachrichtigung.

Die Benachrichtigung antwortet mismatch_ref oder Unknown order: Die Klarna-Bestellung bezieht sich nicht auf diese Bestellung, oder die Erweiterung kennt sie nicht. Die Bestellung wird nicht geändert.

Das Widget wird nicht geladen: Der Kunde sieht Klarna could not be loaded. Please try again or choose another payment method. oder Klarna is not available for this purchase. Prüfen Sie die Zugangsdaten des aktiven Modus sowie Land und Währung des Kunden.

Die Statusänderung auf Complete oder Shipped wird abgelehnt: Die Erfassung bei Klarna ist fehlgeschlagen. Lesen Sie den Grund auf der Bestellseite oder in der Notiz. Der Bestellbetrag benötigt möglicherweise mehr als den noch autorisierten Betrag, die Klarna-Bestellung ist eventuell noch nicht akzeptiert, oder die Autorisierung ist abgelaufen. Beheben Sie das Problem und ändern Sie den Status erneut oder erfassen Sie im Klarna Merchant Portal.

Die Erstattung schlägt fehl: Lesen Sie die Meldung auf der Registerkarte. Die Bestellung ist möglicherweise noch nicht erfasst (stornieren Sie sie stattdessen), der Betrag übersteigt möglicherweise den noch erstattbaren Betrag, oder die Zugangsdaten der Umgebung der Bestellung fehlen.

Kein Erstattungsformular auf der Registerkarte: Die Registerkarte nennt den Grund: Es ist noch nichts erfasst, der erfasste Betrag ist vollständig erstattet, oder Ihre Benutzergruppe hat kein Recht, die Erweiterung zu bearbeiten.

Der Kunde sieht This order is already being paid: Eine andere Anfrage für denselben Kauf läuft, zum Beispiel durch einen Doppelklick. Warten Sie einen Moment und prüfen Sie, ob die Bestellung einen Status erhalten hat.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Klarna Payments 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 Abschnitt Order statuses, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Auch die OpenCart-Ereignisse der Erweiterung werden entfernt, sodass Statusänderungen keine Klarna-Bestellungen mehr erfassen oder stornieren (auf OpenCart 4 zusätzlich deren Startup-Aktion, die Benachrichtigung und Kundenrückkehr im Wartungsmodus durchlässt). Ist Delete data on uninstall eingeschaltet, werden die übrigen Einstellungen des Gateways (Titel, Beschreibung, Testmodus, API-Region, Zugangsdaten, Erfassung, Stornierung, Protokollierung), das Protokoll und die temporären Widget-Sitzungen entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die Klarna-Bestellungen und -Erstattungen bleiben immer erhalten, sodass früher aufgegebene Bestellungen nach einer Neuinstallation weiter erfasst und erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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