Klarna im JTL-Shop einrichten: Plugin, API-Keys und die häufigsten Stolperfallen

Auf einen Blick

• ✓Klarna läuft im JTL-Shop ausschließlich über das Klarna-Payments-Plugin aus dem JTL-Extension-Store. Wir sehen in fast jedem zweiten Audit, dass Händler das Plugin zwar gekauft, aber nie unter „Plugins verwalten“ aktiviert haben.
• ✓Die häufigste Fehlerquelle bei Klarna im JTL-Shop einrichten ist die Verwechslung von Merchant-ID und API-Key-ID: In das Plugin gehört die Schlüssel-ID (API-Username) aus dem Klarna Merchant Portal, nicht die MID. Wer die MID einträgt, sieht im Frontend „Klarna ist derzeit nicht verfügbar“.
• ✓Aus mehr als 40 Klarna-Projekten der Vlarom E-Commerce Agentur wissen wir: Wer den Test-Modus aktiv lässt, verliert echte Bestellungen. Klarna prüft im Test-Modus keine echten Bonitätsdaten, akzeptiert jede Bestellung und meldet später keinen Geldeingang in die Wawi zurück.

Klarna ist eine der wichtigsten Conversion-Zahlarten im deutschen E-Commerce, aber auch eine der fehleranfälligsten in der Einrichtung. Die Vlarom E-Commerce Agentur ist JTL Service Partner Gold aus Ahrensfelde bei Berlin, betreut über 300 Händler im JTL-Ökosystem und richtet Klarna-Setups regelmäßig ein, sowohl bei Neuinstallationen als auch bei Migrationen aus dem alten Klarna-Checkout-v3 zur neuen ONE-Klarna-Lösung. Dieser Beitrag fasst zusammen, was wir in der Praxis lernen mussten und was sich nicht in der offiziellen Doku findet.

Die Supportanfragen rund um Klarna im JTL-Shop folgen einem klaren Muster. Aus den letzten zwölf Monaten kristallisieren sich fünf wiederkehrende Fehlerbilder heraus. Jedes davon hat eine konkrete Ursache, die sich vermeiden lässt.

primary

API-Key statt Merchant-ID eingeben

Der mit Abstand häufigste Fehler. Im Klarna-Plugin gibt es ein Feld ‚Händler-ID‘ oder ‚Username‘. Viele tragen dort die Merchant-ID (MID) ein, die sie aus dem Vertragsdokument kennen. Das ist falsch.

Ins Plugin gehört die Schlüssel-ID (API-Username) aus dem Klarna Merchant Portal unter ‚Einstellungen > Klarna API‘. Beim Anlegen eines neuen Schlüssels zeigt Klarna zwei Werte: Schlüssel-ID und Schlüssel-Geheimnis. Beide werden ins Plugin übertragen, die MID nicht.

warning

Test-Modus bleibt im Live-Betrieb aktiv

Klarna trennt strikt zwischen Playground (Test) und Production (Live). Im Test-Modus akzeptiert Klarna jede Bestellung ohne echte Bonitätsprüfung. Die Daten kommen aus dem Sandbox-Portal portal.playground.klarna.com.

Live-Schlüssel kommen ausschließlich aus portal.klarna.com. Die häufigste Folge des vergessenen Wechsels: Bestellungen im Shop laufen scheinbar durch, aber es kommt nie ein Geldeingang, und die Klarna-Auszahlung findet nicht statt. Wer das nach drei Wochen merkt, hat ein Buchhaltungsproblem.

highlight

Zahlungsarten in der Wawi fehlen

Ein Händler im JTL-Forum: ‚Klarna funktioniert im Shop, aber die Bestellung kommt in der Wawi mit Zahlart unbekannt an.‘ Die Ursache liegt nicht im Shop, sondern in der JTL-Wawi.

Unter ‚Zahlungen > Zahlungsarten‘ müssen die einzelnen Klarna-Zahlarten manuell angelegt werden. Abhängig vom Plugin sind das ‚Klarna Rechnung‘, ‚Klarna Sofort bezahlen‘, ‚Klarna Ratenkauf‘ oder bei der neuen Variante ‚ONE Klarna‘. Ohne diese Anlage findet das Mapping zwischen Shop-Bestellung und Wawi-Zahlart nicht statt.

muted

B2B-Bestellung wird abgelehnt

Klarna prüft B2B-Käufer anders als B2C, nämlich über Firmenname und Handelsregister statt Geburtsdatum. Wenn die Firmen-Felder im Checkout nicht durchgereicht werden, behandelt Klarna die Bestellung als B2C, fragt nach dem Geburtsdatum und lehnt ab.

Im Plugin gibt es einen separaten Toggle ‚B2B aktivieren‘. Zusätzlich muss in JTL-Shop unter ‚Kundengruppen‘ die Gruppe Geschäftskunde so konfiguriert sein, dass Firmenname als Pflichtfeld läuft. Erst dann reicht der Shop die Firma korrekt an Klarna durch.

warning

Webhook-Bestätigung kommt nicht in der Wawi an

Klarna meldet eine erfolgreiche Zahlung per Webhook zurück an den Shop. Diese Meldung muss der JTL-Shop dann über den dbeS-Sync an die Wawi durchreichen. Wenn der Webhook-Endpunkt nicht erreichbar ist, bleibt die Bestellung in der Wawi auf Status ‚offen‘.

Häufige Ursachen: WAF blockiert eingehende POST-Requests von Klarna-IPs, .htaccess-Regel sperrt /api/-Pfade oder die Shop-URL im Klarna-Portal stimmt nicht mit der echten Shop-URL überein (Tippfehler, http statt https, fehlendes www). Die Webhook-Logs im Klarna-Portal zeigen, ob die Anfrage angekommen ist und welchen HTTP-Code der Shop zurückgegeben hat.

Die folgenden fünf Schritte aus der Praxis der Vlarom E-Commerce Agentur decken die komplette Klarna-Einrichtung ab, vom Plugin-Kauf bis zur ersten echten Bestellung. Halte vor dem Start die Klarna-Vertragsunterlagen und einen Zugang zum Klarna Merchant Portal bereit. **Wichtiger Hinweis:** Mache vor jedem Eingriff in das produktive Shop-Backend ein vollständiges Backup von Datenbank und /includes-Verzeichnis. Plugin-Konflikte sind nicht ausgeschlossen.

Logge dich in dein JTL-Konto ein und kaufe das Plugin ‚Klarna Payments‘ im Extension Store. Im Shop-Backend unter ‚Plugins > Mein Plugin-Manager‘ aktualisierst du die Lizenzliste. Anschließend findest du das Plugin unter ‚Plugins > Plugins verwalten‘ im Reiter ‚Verfügbar‘. Klick auf ‚Installieren‘ und danach auf ‚Aktivieren‘. Wir sehen in der Praxis häufig, dass der zweite Klick vergessen wird. Ohne Aktivierung erscheint Klarna nirgends im Backend. Hintergrund findest du im Extension Store des JTL-Guides.

Logge dich in portal.klarna.com ein (nicht im Playground-Portal). Unter ‚Einstellungen > Klarna API > API-Schlüssel anlegen‘ generierst du ein neues Schlüsselpaar. Klarna zeigt das Schlüssel-Geheimnis nur ein einziges Mal an, also kopiere es sofort in einen Passwort-Safe. Lege parallel ein zweites Schlüsselpaar im Playground-Portal (portal.playground.klarna.com) an, das du später für Tests brauchst. Beide Paare solltest du klar beschriften, sonst kommt es im Live-Betrieb zur Verwechslung.

Im JTL-Shop-Backend öffnest du das Klarna-Plugin und trägst ein: Schlüssel-ID (NICHT Merchant-ID), Schlüssel-Geheimnis, Land (DE), Währung (EUR). Setze den Modus zunächst auf ‚Test‘. Aktiviere die Zahlarten, die du anbieten willst, typischerweise Rechnungskauf, Sofortüberweisung und Ratenkauf. Bei B2B-Verkauf zusätzlich den B2B-Toggle setzen. Speichern. Im Frontend prüfst du auf einer Test-Bestellseite, ob das Klarna-Widget erscheint.

Wechsel in die JTL-Wawi und öffne ‚Einstellungen > Zahlungen > Zahlungsarten‘. Lege für jede aktive Klarna-Zahlart eine eigene Zahlart in der Wawi an: ‚Klarna Rechnung‘, ‚Klarna Sofort bezahlen‘, ‚Klarna Ratenkauf‘. Wichtig ist die exakte Schreibweise, denn der Shop reicht den Zahlart-Namen 1:1 an die Wawi durch. Anschließend Wawi-Sync auslösen und in den Bestellungen prüfen, ob die Klarna-Bestellung mit korrekter Zahlart ankommt. Details zum Hintergrund findest du in der Lizenz-Aktivierung des Zahlungsmoduls.

Bevor du den Test-Modus deaktivierst, führe mindestens drei Test-Bestellungen durch, eine pro Zahlart. Klarna stellt im Playground Test-IBANs und Test-Personen-Daten bereit. Prüfe nach jeder Bestellung, ob sie in der Wawi mit korrekter Zahlart und Status ‚bezahlt‘ ankommt. Erst wenn alle drei sauber durchlaufen, tauschst du im Plugin Schlüssel-ID und Geheimnis gegen die Live-Werte aus und schaltest den Modus auf ‚Live‘. Direkt danach: eine echte Test-Bestellung mit kleinem Betrag (5 Euro Rechnungskauf, dann sofort stornieren), um den Live-Webhook zu prüfen. Im Klarna-Portal unter ‚Einstellungen > Webhooks‘ siehst du, ob die Bestätigung mit HTTP 200 angekommen ist.