Klarna verbinden
Aktualisiert am
Klarna wird direkt mit den API-Zugangsdaten aus dem Klarna Händlerportal verbunden. Die Besonderheit: Klarna bietet keine Webhooks an, Rechnungskit ruft neue Daten deshalb automatisch ab.
Einrichtung
- Im Klarna Händlerportal unter Einstellungen die Klarna API-Zugangsdaten öffnen und neue Zugangsdaten erstellen. Du erhältst einen Benutzernamen und einen API-Schlüssel.
- Beide unter Einstellungen → Connect bei Klarna eintragen. Rechnungskit prüft die Zugangsdaten direkt gegen die Klarna-API. Wichtig: Verwende die Zugangsdaten deines Live-Kontos, auch wenn du Rechnungskit erst testest. Rechnungskit liest nur mit und löst keine Zahlungen aus. Playground-Zugangsdaten verbinden Klarnas leere Testumgebung, in der deine echten Zahlungen nie erscheinen.
- Ob es sich um Live- oder Playground-Zugangsdaten (Klarnas Testumgebung) handelt, erkennt Rechnungskit automatisch.
Mehr ist nicht nötig: Es gibt keine Webhook-URL zum Eintragen, weil Klarna keine Webhooks unterstützt.
Wie die Daten hereinkommen
- Alle 4 Stunden holt Rechnungskit neue Klarna-Transaktionen ab: Zahlungen (Captures), Erstattungen und verlorene Käuferstreitfälle. Wichtig: Klarna stellt eine Zahlung in diesen Abrechnungsdaten erst bereit, wenn sie für die Auszahlung verarbeitet wurde; direkt nach dem Kauf ist sie dort noch nicht sichtbar (siehe Grenzen).
- Sofort-Abruf: Der Button "Jetzt synchronisieren" (unter /payments oder Einstellungen → Connect) holt Transaktionen und Auszahlungen auf Knopfdruck, zum Beispiel direkt nach dem Verbinden oder zum Testen.
- Täglich werden zusätzlich die Auszahlungen abgeglichen: Jede Klarna-Auszahlung wird in ihre Bestandteile zerlegt (Zahlungen, Erstattungen, Gebühren je Transaktion, Klarna-Provision) und gegen den Auszahlungsbetrag geprüft.
- Der Auszahlungsrhythmus spielt keine Rolle: Auch bei wöchentlicher oder monatlicher Klarna-Auszahlung werden alle enthaltenen Zahlungen vollständig übernommen, denn jede Auszahlung bringt ihre eigenen Transaktionen mit.
- Die Zuordnung zur Bestellung läuft über die Bestellnummer, die dein Shop-Plugin bei Klarna hinterlegt.
Was automatisch passiert
- Aus jeder Klarna-Zahlung entsteht die passende Rechnung, sobald die Bestellung zugeordnet ist.
- Erstattungen erzeugen automatisch die Stornorechnung.
- Ein bei Klarna verlorener Käuferstreitfall wird wie eine Rücklastschrift behandelt: Der Posten öffnet sich wieder und landet zur Klärung in den Aufgaben, ohne automatischen Storno.
- Klarna-Gebühren werden je Zahlung ausgewiesen (Gebühren-Spalte und Detail-Ansicht unter /payments) und fließen getrennt in den DATEV-Export, auf ein eigenes Verrechnungskonto.
Grenzen, ehrlich benannt
- Klarna stellt Zahlungen mit Verzögerung bereit, und zwar auch in Live-Konten: Eine Klarna-Zahlung ist sofort im Klarna Händlerportal sichtbar, taucht in Klarnas Abrechnungsdaten (der einzigen Datenquelle, die Klarna Systemen wie Rechnungskit anbietet) aber erst auf, wenn Klarna sie für die Auszahlung verarbeitet hat. Je nach Auszahlungsrhythmus des Klarna-Vertrags kann das einen bis mehrere Tage nach dem Kauf sein. Das ist normales Klarna-Verhalten, keine Störung. Sobald Klarna die Daten bereitstellt, übernimmt Rechnungskit sie mit dem nächsten Abruf, spätestens nach 4 Stunden.
- Wer nach der Bereitstellung nicht auf den Abruf warten will, nutzt "Jetzt synchronisieren".
- In der Playground-Umgebung (Test) gilt dieselbe Verzögerung, teils noch stärker; Test-Auszahlungen erzeugt die Playground-Umgebung nicht in jedem Fall.
- Wird eine Bestellung in mehreren Schritten versendet (Teil-Captures), entsteht je Capture eine eigene Zahlung; Abweichungen zur Bestellsumme landen als Aufgabe zur Klärung.
- Läuft Klarna bei dir über Mollie, Stripe oder Unzer, brauchst du diese Verbindung nicht: Die Zahlungen kommen dann bereits über den jeweiligen Anbieter herein.
Wo in der App
- /settings/connect, Klarna verbinden
- /payments, Zahlungen, Erstattungen und Klärfälle mit Gebühr je Zahlung
- /payouts, Auszahlungen mit Zerlegung und Abweichungen