Klarna Checkout konfigurieren
Achtung:
Der Klarna Checkout erfordert der die Pro-Version der Shop-Erweiterung!
stateDiagram-v2
%% Frontend
[*] --> prepared : Kunde stellt den Warenkorb zusammen\nund startet den Checkout
prepared --> ordered : Checkout abgeschlossen\nBestätigungsmail versendet\nRechnungsnummer vergeben
%% Klarna Zahlungsablauf
ordered --> paid : Zahlung autorisiert/bestätigt\nKlarnaCheckoutService->finishOrder()\nAbfrage bei Klarna, ob Zahlung verifiziert ist
%% Versand & Abschluss
paid --> shipped : Ware manuell versendet
paid --> processed : Abschluss ohne Versand\n(z. B. digitale Produkte)
shipped --> processed : Bestellung nach Versand abgeschlossen
%% Ausnahmefall
ordered --> canceled_unpaid : Zahlung fehlgeschlagen\noder abgelaufen
canceled_unpaid --> processed : Stornierung abgeschlossen
%% Bedingungen
note right of processed
Bedingungen:
- paid_date MUSS gesetzt sein
- shipped_date MUSS gesetzt sein,
falls ein Versand erfolgt ist
end noteVorbereitungen
Um den Klarna Checkout nutzen zu können, müssen folgende Voraussetzungen erfüllt sein:
- Im Checkout muss das Country/Land-Feld verwendet werden.
Klarna API-Zugangsdaten
- Wechsel im Klarna-Login in den Bereich Einstellungen -> Klarna Zugangsdaten
- Erstelle hier neue API-Zugangsdaten
- Hier bekommst Du nun einen Benutzernamen (UID) und ein Passwort angezeigt
- Speicher sich diese Zugangsdaten und hake dann die Checkbox an, um das Modal zu schließen.
Eine Test-Umgebung (Sandbox/Playground) findest Du hier: https://auth.playground.eu.portal.klarna.com/auth/realms/merchants/protocol/openid-connect/auth?client_id=merchant-portal
Shop-Informationen bei Klarna konfigurieren
Unter Einstellungen -> Shop-Informationen: https://playground.eu.portal.klarna.com/settings/store
Aktionen nach erfolgreicher Bezahlung
Wenn Du nach der erfolgreichen Bezahlung weitere Aktionen durchführen möchtest, kannst Du dazu den KlarnaPaid Event Listener nutzen.
- Dazu muss ein Event Listener erstellt werden:
<?php namespace YourVendor\YourExtension\EventListener; use CodingMs\ShopPro\Event\BasketOrder\KlarnaPaidEvent; class DoSomeThingEventListener { public function __invoke(KlarnaPaidEvent $event): void { /* Do something */ } } - Dieser Event Listener muss anschließend in der
Configuration/Services.yamlregistriert werden:services: YourVendor\YourExtension\EventListener\DoSomeThingEventListener: tags: - name: event.listener identifier: 'myListener' event: CodingMs\ShopPro\Event\BasketOrder\KlarnaPaidEvent
Testing
Zuerst braucht man einen Test-Account, den man hier erstellen kann: https://playground.eu.portal.klarna.com/developer-sign-up?
Siehe: https://developers.klarna.com/documentation/testing-environment/
Achtung:
Wenn Du mit Deinem Test-Account nicht die Zahlarten, die Du gerne einsetzen bzw. testen möchtest, freigeschaltet habst, kannst Du diese via Mail bei shop@klarna.de anfragen.
Test Credit Card
Um den Kartenzahlungsfluss aus der Sicht des Endbenutzers zu simulieren/testen, verwendest Du die folgenden Kartendetails im geladenen Klarna-Widget:
Credit card number: 4111 1111 1111 1111 CVV: 123 Exp: 12/25 (Oder ein anderes gültiges Datum in der Zukunft)
Test bank account
Um mit einer Bank-Verbindung zu testen muss nur irgendein Text eingegeben werden, anschließend wird einem die Demo Bank vorgeschlagen. Diese muss ausgewählt werden und irgendeine mindestens 8 Ziffern lange Kontonummer + Pin eingegeben werden. Abschließend wählst Du ein Konto aus und gibst 12345 als TAN ein.
Überprüfe Deine Details/Telefonnummer
Zum Testen kann die Telefonnummer +491755555555 eingegeben werden. Anschließend wird man nach einem 6 stelligen Code gefragt. Wenn Du hier 999999 eingibst, kannst Du einen Fehlversuch simulieren. Wenn Du irgendeinen anderen 6 stelligen Code eingibst, wird die Nummer bestätigt.
Support bei Klarna
Wenn Du Unterstützung mit Deinem Händler-Account benötigst, kannst Du entweder telefonisch (0221 669 50130) oder via Mail shop@klarna.de Kontakt aufnehmen.