VibeFox Klarna for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

HTTPS: Klarna verlangt HTTPS für echte Zahlungen.

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

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

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

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_klarna_payment per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Klarna Payments > Manage oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

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

6. Geben Sie Benutzername und Passwort der Testumgebung aus dem Klarna-Testportal ein, lassen Sie Test mode aktiviert, schalten Sie Enable/Disable ein und legen Sie eine Testbestellung an.

7. Geben Sie Benutzername und Passwort des Live-Zugangs aus dem Klarna Merchant Portal ein, deaktivieren Sie Test mode und wählen Sie, wann Bestellungen erfasst werden (Standard: wenn die Bestellung als Abgeschlossen markiert wird).

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Klarna Payments. Neben dem Seitentitel zeigt ein Badge TEST MODE oder LIVE an. Die Seite warnt Sie, wenn Benutzername oder Passwort des aktiven Modus fehlen (Klarna wird dann in der Kasse ausgeblendet), und wenn die Shop-Währung in der gewählten API-Region nicht von Klarna verkauft wird. In der Liste der Zahlungsmethoden ist Klarna als einrichtungsbedürftig markiert, bis die Zugangsdaten des aktiven Modus eingegeben sind, und zeigt bei aktivem Testmodus ein Testmodus-Badge an.

Allgemein

Enable/Disable: Enable Klarna Payments schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden in der Kasse sehen. Standard: Klarna.

Description: der Text, den Kunden über dem Klarna-Widget sehen. Standard: Pay now, later or in instalments with Klarna.

API-Zugangsdaten

Die Klarna-API-Zugangsdaten (Benutzername und Passwort) werden im Klarna Merchant Portal (portal.klarna.com) unter Settings > Klarna API credentials erstellt. Testzugangsdaten stammen aus dem Testportal: playground.eu.portal.klarna.com für Europa, playground.us.portal.klarna.com für Nordamerika und Ozeanien.

Test mode: Use the Klarna playground (test credentials, no real payments). Standard: ein. Solange der Testmodus aktiv ist, zeigt die Kasse TEST MODE: Klarna playground, no real payment is made. an. Bestellungen behalten die Umgebung, in der sie angelegt 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.

Europe: Österreich, Belgien, Finnland, Frankreich, Deutschland, Griechenland, Irland, Italien, Niederlande, Portugal, Slowakei und Spanien (EUR), Schweden (SEK), Norwegen (NOK), Dänemark (DKK), Vereinigtes Königreich (GBP), Schweiz (CHF), Polen (PLN), Tschechien (CZK), Ungarn (HUF), Rumänien (RON). Standard.

North America (US, CA, MX): Vereinigte Staaten (USD), Kanada (CAD), Mexiko (MXN).

Oceania (AU, NZ): Australien (AUD), Neuseeland (NZD).

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

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

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

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

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. Schließen Sie (versenden) Bestellungen daher rechtzeitig ab oder nutzen Sie die automatische Erfassung.

Capture: wann der Kunde belastet wird. Erstattungen sind nur für erfasste Beträge möglich. Schlägt eine Erfassung fehl, wird die Bestellung mit einer Notiz auf Zurückgestellt gesetzt.

When the order is Completed (recommended): Erfassung beim Versand, indem Sie die Bestellung als Abgeschlossen markieren (Standard). Der erfasste Betrag ist die Bestellsumme abzüglich des bereits erfassten Betrags und höchstens der noch autorisierte Betrag.

Immediately (auto capture): belastet den Kunden sofort, z. B. für digitale Produkte oder Dienstleistungen.

Manually in the Klarna portal: das Plugin erfasst nicht. Erfassen Sie die Bestellung im Klarna Merchant Portal.

Cancellation: Cancel the Klarna order (release the authorization) when a not yet captured order is Cancelled. Standard: ein.

Benachrichtigungen

Klarna meldet das Ergebnis einer Betrugsprüfung (Bestellungen, die als „pending“ angelegt wurden) an die Benachrichtigungs-URL, die in diesem Abschnitt angezeigt wird. Sie sieht so aus: https://your-site/wc-api/wc_kl_payment/. Die URL wird automatisch mit jeder Bestellung übermittelt, in Klarna muss also nichts eingerichtet werden. Der Inhalt einer Benachrichtigung wird nie als vertrauenswürdig behandelt: Jede Benachrichtigung wird über die Klarna Order Management API geprüft, und die Klarna-Bestellung muss sich auf diese Shop-Bestellung beziehen. Das Plugin handelt entsprechend der Meldung von Klarna:

ACCEPTED: Klarna hat den Kauf akzeptiert. Die Bestellung wird nach Prüfung von Betrag und Währung als bezahlt markiert.

REJECTED or STOPPED: der Kauf hat die Betrugsprüfung nicht bestanden. Die Bestellung wird auf Fehlgeschlagen gesetzt.

Klarna order CANCELLED, EXPIRED or CLOSED: der Kunde wurde nicht belastet. Die Bestellung wird storniert.

Akzeptiert Klarna einen Kauf, nachdem Sie die Bestellung storniert oder erstattet haben, wird die Bestellung nicht wieder geöffnet und die Klarna-Autorisierung wird aufgehoben.

Erweitert

Debug log: Log API calls and payment events unter WooCommerce > Status > Logs, Quelle wcp_klarna_payment. Fehler werden immer protokolliert. Protokolle enthalten nie Zugangsdaten oder Kundendaten. Standard: aus.

Uninstall: Delete the plugin settings and logs when the plugin is deleted. Bestelldaten (Klarna-Bestell-IDs) bleiben immer erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig Klarna), und das Klarna-Widget lädt in der Kasse. Dort wählt der Kunde zwischen sofortiger Zahlung, Zahlung später oder Ratenzahlung, je nachdem, was Klarna anbietet. Wenn der Kunde auf „Zahlungspflichtig bestellen“ klickt, autorisiert Klarna den Kauf im Widget. Im Kassen-Block wird die Klarna-Sitzung zuerst mit dem endgültigen Warenkorb aktualisiert, damit spätere Änderungen bei Versand oder Summen nicht dazu führen, dass Klarna die Bestellung ablehnt. Danach legt das Plugin die Klarna-Bestellung serverseitig mit den Positionen, Summen und Adressen der WooCommerce-Bestellung an.

Das Ergebnis hängt vom Betrugsstatus von Klarna ab:

ACCEPTED: die Bestellung wird sofort als bezahlt markiert und der Kunde gelangt zur Seite „Bestellung eingegangen“. Der Betrag ist autorisiert und wird gemäß Capture erfasst.

PENDING: die Bestellung wird auf Zurückgestellt gesetzt, bis die Benachrichtigung von Klarna eintrifft. Versenden Sie sie vorher nicht.

REJECTED: die Bestellung wird auf Fehlgeschlagen gesetzt, und der Kunde sieht Klarna could not approve this purchase. Please choose another payment method.

Kann Klarna die Bestellung nicht annehmen, sieht der Kunde eine kurze 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, die Aufforderung, erneut auf „Zahlungspflichtig bestellen“ zu klicken. Die Details werden den Bestellnotizen und dem Protokoll hinzugefügt. Stimmen Rechnungsland 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.

Die Zahlungsmethode funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist kompatibel mit WooCommerce High-Performance Order Storage (HPOS).

Das Plugin bietet kein Klarna Checkout (KCO, vollständiger Ersatz der Kasse), keine Klarna-Express-Checkout-Buttons, kein On-site messaging und kein Sign in with Klarna, keine Abonnements oder gespeicherten Zahlungsmethoden und keine Teilerfassungen pro Bestellposition. Bestellpositionen werden nicht erneut an Klarna übermittelt, wenn Sie eine Bestellung nach dem Aufgeben bearbeiten.

Bestellungen und Erstattungen

Bestellstatus

Processing or Completed: Klarna hat den Kauf akzeptiert. WooCommerce setzt den üblichen Status für eine bezahlte Bestellung. Die Bestellnotiz zeigt die Klarna-Bestell-ID und wann sie erfasst wird. Die Transaktions-ID ist die Klarna-Bestell-ID. Wenn die Bestellung erfasst wird, zeigt eine Notiz den erfassten Betrag und die Erfassungs-ID.

On hold: der Kauf wartet auf die Betrugsprüfung, Klarna hat einen unerwarteten Betrugsstatus zurückgegeben, Betrag oder Währung laut Klarna stimmten nicht mit der Bestellung überein, oder eine Erfassung ist fehlgeschlagen. Die Bestellnotizen zeigen, welcher Fall zutrifft.

Failed: Klarna hat den Kauf nach der Betrugsprüfung abgelehnt oder gestoppt. Versenden Sie die Bestellung nicht.

Cancelled: Sie haben die Bestellung storniert, oder Klarna meldet die Klarna-Bestellung als storniert, abgelaufen oder geschlossen. Bei eingeschalteter Cancellation storniert das Stornieren einer noch nicht erfassten Bestellung auch die Klarna-Bestellung und hebt die Autorisierung auf, sodass der Kunde nicht belastet wird. Eine bereits erfasste Bestellung wird bei Klarna nicht storniert: Erstatten Sie sie, um das Geld zurückzugeben.

Erfassung

Bei When the order is Completed erfasst das Markieren der Bestellung als Abgeschlossen die Bestellsumme. Schlägt die Erfassung fehl, z. B. weil die Bestellsumme nach einer Bearbeitung über den autorisierten Betrag gestiegen ist, wird die Bestellung mit einer Notiz auf Zurückgestellt gesetzt, dass der Kunde NICHT belastet wurde, und der Kunde erhält keine E-Mail „Bestellung abgeschlossen“. Beheben Sie das Problem und markieren Sie die Bestellung erneut als Abgeschlossen, oder erfassen Sie im Klarna Merchant Portal.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Klarna Payments. Vollständige und teilweise Erstattungen sind für erfasste Beträge möglich, bis zum erfassten Betrag abzüglich bereits erstatteter Beträge. Die Erstattung wird an die Umgebung und Region gesendet, in der die Bestellung angelegt wurde, daher müssen deren Zugangsdaten hinterlegt sein. Lehnt Klarna die Erstattung ab, zeigt WooCommerce den Fehler an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der Klarna-Erstattungs-ID in den Bestellnotizen vermerkt. Eine wiederholte Erstattung wird nie doppelt ausgeführt.

Eine noch nicht erfasste Bestellung kann nicht erstattet werden: Stornieren Sie sie stattdessen, um die Autorisierung aufzuheben. Erstattungen, die im Klarna Merchant Portal vorgenommen werden, werden nicht mit WooCommerce synchronisiert.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Klarna Payments. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Klarna Kunden in der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Eine Erinnerung erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Benachrichtigungen werden weiter verarbeitet, und Erfassungen, Stornierungen und Erstattungen funktionieren weiterhin.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist aber eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Klarna erscheint nicht in der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Zugangsdaten des aktiven Modus ausgefüllt sind: Testbenutzername und -passwort im Testmodus, Live-Zugangsdaten im Live-Modus. Das Rechnungsland des Kunden muss ein Klarna-Land Ihrer API region sein, und der Kunde muss in der Währung dieses Landes bezahlen (ein Kunde aus Schweden etwa in SEK).

Die Zahlung ist eingegangen, aber die Bestellung bleibt On hold: die Zahlung wartet auf die Betrugsprüfung von Klarna, und die Bestellung wird aktualisiert, sobald die Benachrichtigung von Klarna eintrifft. Prüfen Sie, ob Ihre Website Anfragen von Klarna an die in den Einstellungen angezeigte Benachrichtigungs-URL empfangen kann, und ob die Zugangsdaten der Umgebung, in der die Bestellung angelegt wurde, noch hinterlegt sind. Sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_klarna_payment.

Benachrichtigung antwortet Not configured: die Zugangsdaten der Umgebung (Test oder Live), in der die Bestellung angelegt wurde, fehlen, daher kann die Benachrichtigung nicht geprüft werden. Geben Sie sie ein.

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

Benachrichtigung antwortet mismatch_ref: die Klarna-Bestellung bezieht sich nicht auf diese Shop-Bestellung. Die Bestellung wird nicht verändert.

Das Widget lädt nicht: 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.

Erfassung fehlgeschlagen, Bestellung On hold: lesen Sie die Bestellnotiz. Die Bestellsumme benötigt eventuell mehr als den noch autorisierten Betrag, die Klarna-Bestellung ist möglicherweise noch nicht angenommen oder die Autorisierung ist abgelaufen. Beheben Sie das Problem und markieren Sie die Bestellung erneut als Abgeschlossen, oder erfassen Sie im Klarna Merchant Portal.

Erstattung fehlgeschlagen: lesen Sie die Meldung. Die Bestellung ist eventuell noch nicht erfasst (stornieren Sie sie stattdessen), der Betrag übersteigt den noch erstattungsfähigen Betrag, oder die Zugangsdaten der Umgebung der Bestellung fehlen.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Einstellungen des Gateways und die Protokolle (Quelle wcp_klarna_payment) werden nur entfernt, wenn Uninstall (Delete the plugin settings and logs when the plugin is deleted) eingeschaltet war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

Klarna ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Klarna verbunden noch von Klarna empfohlen.