Klarna Payments

Klarna Payments verbindet den Shop mit Klarna. Die Seite dokumentiert die Backend-Konfiguration, den Express-Checkout, die Checkout-Autorisierung, die manuelle Aktivierung reservierter Zahlungen und den Logviewer fuer Klarna-Protokolle.

Aufgabe der Zahlungsart

Die Zahlungsart erstellt im Checkout eine Klarna-Session, zeigt freigegebene Klarna-Zahlungsarten an und erzeugt beim Bestellabschluss eine Klarna-Bestellung. Je nach Konfiguration wird die Zahlung direkt aktiviert oder als Reservierung gespeichert.

• Session-Erstellung: Der Warenkorb wird als Klarna-Session mit Betrag, Waehrung, Land und Bestellpositionen angelegt.
• Autorisierung: Im Checkout liefert Klarna ein Autorisierungstoken. Ohne Token wird die Bestellung abgebrochen und der Warenkorb bleibt relevant.
• Bestellerzeugung: Beim Abschluss wird aus Token und Bestelldaten eine Klarna-Order erzeugt.
• Bestellstatus: Nach erfolgreicher Klarna-Order wird der konfigurierte Erfolgsstatus an der Shopbestellung gesetzt.
• Aktivierung: Bei direkter Aktivierung wird auto_capture an Klarna uebergeben. Ohne direkte Aktivierung bleibt die Zahlung reserviert und kann in der Bestellung manuell aktiviert werden.

Grundkonfiguration

Das Backendformular speichert die Zugangsdaten und das Verhalten nach erfolgreicher Klarna-Autorisierung.

• sandbox - Modus: Auswahl zwischen LIVE und SANDBOX. Der Modus bestimmt, ob der produktive oder der Test-Zugang verwendet wird.
• api_user - API-User: Benutzername fuer die Basic-Authentifizierung gegen Klarna.
• api_password - API-Passwort: Passwort fuer die Basic-Authentifizierung gegen Klarna.
• order_status_ok - Bestellstatus bei Erfolg: Status, der nach erfolgreicher Klarna-Bestellung an der Shopbestellung gesetzt wird. Die Auswahl kommt aus den Bestellstatus des Admin-Standardspracheintrags.
• activatedirect - Klarnarechnung sofort aktivieren: Steuert auto_capture. Bei ja wird die Zahlung sofort aktiviert. Bei nein bleibt eine Reservierung, die spaeter manuell aktiviert werden kann.

Express-Checkout

Klarna Express kann im Warenkorb angezeigt werden, wenn die Zahlungsart erlaubt ist, Betrag und Versandart passen und die Express-Konfiguration vollstaendig ist.

• expresscheckout - Klarna Express im Warenkorb anzeigen: Aktiviert oder deaktiviert den Express-Button im Warenkorb.
• express_client_id - Express Client-ID: Client Identifier fuer den Klarna-Button. Ohne Wert wird kein Express-Button ausgegeben.
• express_theme - Express Button-Theme: Erlaubte Werte sind default, light, dark und outlined. Unbekannte Werte fallen auf default zurueck.
• express_shape - Express Button-Form: Erlaubte Werte sind default, rect und pill. Unbekannte Werte fallen auf default zurueck.
• express_collect_shipping_address - Versandadresse von Klarna abfragen: Steuert, ob Klarna im Express-Flow eine Versandadresse erheben soll.

Bei erfolgreicher Express-Autorisierung speichert der Shop unter anderem Antwortdaten, Session-ID, Client-Token, Autorisierungstoken, die Auswahl klarna_express und optional die von Klarna gelieferte Versandadresse.

Checkout-Ablauf

Im normalen Klarna-Checkout werden die von Klarna gemeldeten Zahlungsarten als Split-Optionen angeboten. Die Auswahl wird in den Zahlungsdaten gespeichert und im zweiten Checkout-Schritt autorisiert.

1. Der Shop erstellt eine Session mit Warenkorbwert, Waehrung, Land und Merchant-Autorisierungsziel.
2. Klarna liefert Zahlungsart-Kategorien und einen Client-Token zurueck.
3. Die Kundenauswahl wird als selected_method gespeichert.
4. Im Checkout wird Klarna geladen und fuer die gewaehlte Zahlungsart autorisiert.
5. Das Autorisierungstoken wird als verstecktes Feld und in den Zahlungsdaten gespeichert.
6. Beim Abschluss wird mit dem Token eine Klarna-Order erstellt.
7. Nur bei akzeptiertem Fraud-Status wird die Bestellung finalisiert, der Erfolgsstatus gesetzt und der Warenkorb geleert.

Bestellaktionen im Backend

In der Bestellansicht zeigt Klarna gespeicherte Zahlungsdaten zur Bestellung an.

• Klarna-Bestell-Nummer: Wird aus den Zahlungsdaten gelesen und in der Bestellansicht angezeigt.
• Zahlung reserviert: Wenn captured den Wert 0 hat, erscheint eine Aktion zum manuellen Aktivieren.
• Rechnung manuell aktivieren: Ruft den Capture-Endpunkt mit der Klarna-Bestellnummer und dem Bruttobetrag der Bestellung auf.
• Zahlung aktiviert: Wenn captured gesetzt ist, wird der aktivierte Status angezeigt.
• Alte Aktionen: Reservierung aktivieren, Reservierung stornieren, Rechnung senden und Gutschrift sind als alte Verwaltungsfunktionen vorhanden, aber nicht die zentrale Klarna-Payments-Konfiguration.

Logs und technische Diagnose

Der Klarna-Logviewer nutzt den allgemeinen Daily-Logviewer mit dem Prefix klarna. Die Ansicht zeigt vorhandene Tagesdateien, laedt die gewaehlte Datei und maskiert sensible Inhalte.

• Logdatei: Auswahl vorhandener Klarna-Logdateien mit Dateigroesse.
• Abrufen: Laedt die ausgewaehlte Datei neu.
• Vorschau: Grosse Dateien werden auf die letzten rund 200 KB gekuerzt.
• Maskierung: Authorization, API-Keys, Tokens, Secrets, Passwoerter, Signaturen, Codes und Cookies werden ersetzt.
• API-Logs: Session-Erstellung, Order-Erstellung, Order-Abruf und Capture schreiben Request und Response mit HTTP-Informationen.
• Interne Ablauf-Logs: Express-Autorisierung, gespeicherte Express-Daten und fehlende Autorisierungstokens werden als Klarna-Eintraege protokolliert.

Pruefung bei Problemen

1. Modus, API-User und API-Passwort gegen den verwendeten Klarna-Zugang pruefen.
2. Bei fehlenden Zahlungsarten Betrag, Land, Waehrung, Versandart und Zahlungsart-Freigaben pruefen.
3. Bei Express-Problemen expresscheckout, express_client_id, Button-Theme, Button-Form und Versandadressabfrage pruefen.
4. Bei fehlgeschlagenem Abschluss im Log nach Session, Autorisierungstoken, Order-Erstellung und Fraud-Status suchen.
5. Bei reservierten Zahlungen in der Bestellung pruefen, ob activatedirect deaktiviert war und ob die manuelle Aktivierung benoetigt wird.
6. Bei Capture-Fehlern Klarna-Bestellnummer, Bruttobetrag und Logantwort zusammen auswerten.