> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.
# Klarna
> Verwalte Klarna-Zahlungsstreitigkeiten im Posteingang, während du den Kunden im selben Ticket betreust.
Mit der Klarna-Integration siehst und bearbeitest du Zahlungsstreitigkeiten direkt in der Ticket-Seitenleiste — neben dem Kundengespräch — statt ins Klarna Merchant Portal zu wechseln.
## Wann du es nutzt
Nutze Klarna in Chatarmin CX, wenn:
* Kunden mit Klarna zahlen und du Chargebacks, Claims oder Evidence-Anfragen bekommst
* Agenten Bestellkontext und Ticket-Verlauf neben den Streitfall-Details brauchen
* KI-Agenten Streitfälle nachschlagen, Evidence vorbereiten oder Aktionen mit Freigabe vorschlagen sollen
Klarna-Streitfälle erscheinen im Posteingang im Bereich **Streitfälle** am Ticket. Sie werden nicht als separate Klarna-Benachrichtigungs-E-Mails importiert.
## Einrichten
Du brauchst **Disputes-API**-Zugangsdaten (API-Benutzername und -Passwort) für jedes Merchant-Konto, das du verbindest. Dein Klarna-Konto muss für Dispute Management freigeschaltet sein.
Geh zu [Integrationen](https://armin.cx/app/_/settings/integrations) und wähle **Klarna**.
Klick auf **Verbinden**, gib optional einen Anzeigenamen ein und trage API-Benutzername und -Passwort ein. Du kannst **mehrere Klarna-Konten** pro Workspace verbinden — z. B. pro Shop oder Region.
Nach dem Speichern nutze **Verbindung testen** auf der Kontokarte, um die Zugangsdaten zu prüfen.
Beim Verbinden registriert Chatarmin CX **automatisch Dispute-Webhooks** für dein Konto — du musst Webhooks nicht selbst einrichten. Das klappt nur, wenn Klarna deinem Merchant-Konto bereits Webhook-Zugang freigeschaltet hat. Fehlt der Zugang, bitte deinen Klarna-Kontakt um Freischaltung und verbinde das Konto danach erneut oder bearbeite die Integration.
Ist die automatische Webhook-Registrierung für dein Konto nicht verfügbar, zeigt der Integrationsdialog ggf. **Webhook-Setup erforderlich** mit manuellen Feldern. Dieser Weg gilt nur für Merchants, denen Klarna noch keinen Webhook-API-Zugang gegeben hat.
Eine verbundene Shopify-Integration hilft, Streitfälle Kunden zuzuordnen, wenn Klarna keine Käufer-E-Mail liefert. Pflege die E-Mail am Kontakt, wenn keine Streitfälle erscheinen.
## Klarna-Streitfälle im Posteingang
Hat ein Ticket-Kontakt eine E-Mail und existiert ein passender Klarna-Streitfall, listet der Bereich **Streitfälle** im Kundenpanel die Fälle — auch bereits gelöste.
Öffne das Ticket des Kunden, der den Streitfall betrifft.
Der Kontakt braucht eine E-Mail-Adresse. Fehlt sie, ergänze sie — Zuordnung läuft über die E-Mail.
Unter **Streitfälle** öffnest du einen Klarna-Eintrag für Grund, Phase, Betrag, Frist, Aktivität, Bestellreferenzen und Evidence-Anfragen.
Nutze das Aktionsformular unten im Streitfall-Detail. Verfügbare Aktionen hängen von der Streitfall-Phase ab.
### Mögliche Aktionen
| Aktion | Was sie tut |
| ----------------------- | --------------------------------------------------------------------------------------- |
| **Evidence einreichen** | Antwort an Klarna mit Pflichtfeldern, optionaler Teilrückerstattung und PDF-Nachweisen. |
| **Claim akzeptieren** | Verlust am Streitfall akzeptieren. Unwiderruflich; kann dein Konto belasten. |
| **Einspruch** | Text-only-Einspruch in der Pre-Arbitration, wenn Klarna es erlaubt. |
Klarna bietet keine Nachrichten im Streitfall, Vergleichsangebote oder Eskalationen wie PayPal. Nutze **Antwort senden** am Ticket für die Kundenkommunikation.
### Regeln für Evidence-Dateien
Wenn Klarna Nachweise verlangt:
* nur **PDF**
* max. **7 MB** pro Datei
* bis zu **10** Dateien pro Einreichung
* kurze Beschreibung pro Datei
Je nach Streitgrund kommen Zusatzfragen — z. B. ob versendet wurde, Tracking oder ob eine Retoure ankam. Das Formular zeigt nur die von Klarna geforderten Felder.
## KI-Agenten-Aktionen
Gib einem Streitfall-Agenten Klarna-Aktionen, damit er im Ticket arbeiten kann:
| Aktion | Zweck |
| -------------------------------- | ----------------------------------------------------------------- |
| **Klarna-Streitfälle auflisten** | Indexierte Streitfälle zur Kontakt-E-Mail finden. |
| **Klarna-Streitfall abrufen** | Live-Details und erlaubte Aktionen laden. |
| **Klarna-Evidence einreichen** | Representment mit PDF-Anhängen vom Ticket senden. |
| **Klarna-Claim akzeptieren** | Verlust akzeptieren vorschlagen — standardmäßig **mit Freigabe**. |
| **Klarna-Einspruch** | Text-Einspruch in Pre-Arbitration einreichen. |
Schließe die Integration oben ab.
In [KI-Agenten](https://armin.cx/app/_/ai/agents-v2) den Agenten öffnen und die passenden Klarna-Aktionen aktivieren. Wähle, welche verbundenen Klarna-Konten der Agent nutzen darf.
**Klarna-Claim akzeptieren** auf **Immer Freigabe erforderlich** lassen. Teilrückerstattungen bei **Evidence einreichen** pausieren ebenfalls vor der Ausführung.
Der Agent soll vor jedem Write **Klarna-Streitfall abrufen**, Tracking aus Shopify oder Fulfillment-Integration nutzen und **Antwort senden** für Kunden-Updates — nicht Klarna-Streitfall-Nachrichten.
Du kannst Agenten auch starten, wenn ein neuer oder aktualisierter Streitfall indexiert wird. Nutze den Trigger **Dispute indexed** und filtere nach Provider **Klarna** und Status wie **Needs your response**.
## Best practices
* Reagiere vor dem **Antwort-fällig**-Datum im Detail-Sheet.
* Halte die Kontakt-E-Mail mit der Klarna-Rechnungs-E-Mail synchron.
* Sammle PDF-Nachweise (Rechnung, Zustellnachweis, Retourenrichtlinie), bevor du **Evidence einreichen** nutzt.
* Verwende klare Anzeigenamen bei mehreren Klarna-Konten.
* Verlange bei finanziellen Aktionen eine menschliche Freigabe am KI-Agenten.
## Fehlerbehebung
| Symptom | Was prüfen |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Klarna fehlt unter Integrationen | Klarna ist für deinen Workspace evtl. noch nicht freigeschaltet. Schreib an [Support](mailto:support@chatarmin.com). |
| Bereich **Streitfälle** ist leer | Klarna verbunden? Kontakt hat E-Mail? Streitfall für diese E-Mail vorhanden? Nach neuem Connect kann der erste Sync einige Stunden dauern. |
| Streitfall in Klarna, aber nicht in cx | Käufer-E-Mail evtl. noch nicht angereichert. Shopify verbinden oder Rechnungs-E-Mail am Kontakt angleichen. Nächsten Sync abwarten. |
| Streitfälle aktualisieren sich nicht in Echtzeit | Prüfen, ob Klarna Webhook-Zugang für dein Merchant-Konto freigeschaltet hat. Ohne Webhooks laufen Syncs weiter im Hintergrund, Updates können aber langsamer sein. |
| **Webhook-Setup erforderlich** erscheint | Dein Konto hat evtl. noch keinen Klarna-Webhook-API-Zugang. Klarna um Freischaltung bitten und erneut verbinden. Manuelle Webhook-Felder gibt es nur, wenn die automatische Registrierung nicht verfügbar ist. |
| Evidence-Upload schlägt fehl | Nur PDF, unter 7 MB, alle Pflichtfelder ausfüllen. |
| **Verbindung testen** schlägt fehl | API-Zugangsdaten im [Klarna Merchant Portal](https://portal.klarna.com) prüfen und Disputes-API-Zugang bestätigen. |