Über Klarna Payments

Allgemeines zu Klarna Payments

Klarna bietet drei verschiedene Zahlungsarten in der neuen Klarna KP API über  an: Rechnungs- und Ratenkauf (Pay Later & Pay over time) sowie Sofort + abgesicherte Lastschrift (Pay Now). Dafür brauchen Sie während der Bestellung nur alle Rechnungsdaten an den Dienstleister zu übergeben. Dieser übernimmt dann den gesamten Aufwand der Rechnungsstellung und des nachgelagerten Debitorenmanagements. Als Händler bekommen Sie eine Zahlungsgarantie; egal welche Bezahlmöglichkeit ihr Kunde wählt. Dadurch erhalten Ihre Kunden mit Klarna finanzielle Flexibilität, denn sie können selbst flexibel zwischen Rechnungskauf oder Ratenkauf wählen. Beim Ratenkauf können Sie zudem die Höhe der Raten und Rückzahlungstermine selbst bestimmen. Die Rechnungslösung können sie auch für ihren B2B Handel einsetzen.

Der Ratenkauf im Online-Shop motiviert Ihre Kunden, hochwertige Warenkörbe zu bestellen. So erhöht sich auch Ihr Umsatz. Klarna gewährt im Bestellprozess sekundenschnell eine Online-Zusage für den Ratenkauf. Ein PostIdent-Verfahren ist nicht nötig. Klarna zahlt den Rechnungsbetrag kurzfristig an den Händler aus und trägt das Ausfallrisiko selbst. Als Händler profitieren Sie von schnell verfügbarer Liquidität.

Alle drei Zahlungsarten sind, mit Einschränkungen der abgesicherten Lastschrift, in den folgenden Ländern in der jeweiligen Landeswährung verfügbar: Deutschland, Österreich, Niederlande, Dänemark, Schweden, Norwegen, Finnland, Großbritannien, USA, Schweiz, Australien, Belgien, Spanien, Italien, Irland, Polen, Portugal, Frankreich und Kanada.

Weitere Informationen finden Sie auch auf der Webseite von Klarna (https://www.klarna.de).

Klarna Payments unterscheidet zwischen einer Direktanbindung und der Klarna Hosted Payment Page (HPP).

Diagramm zum Prozessablauf Direktanbindung

Prozessablauf Klarna Payments Direktanbindung

Diagramm zum Prozessablauf HPP

Prozessablauf Klarna Payments HPP

Mit der Direktanbindung wird für jede Zahlungsart ein separates Widget per JavaScript eingebunden. Bei der HPP wird eine komplette Checkout-Seite angezeigt, auf der alle oder nur einige ausgewählte Zahlungsarten angezeigt werden. Sowohl die Widgets, als auch die HPP werden von einem Klarna-Server geladen.

-Schnittstelle

Klarna Session für die Direktanbindung erzeugen

Bevor die Klarna Widgets geladen werden können, muss eine Klarna Session erzeugt werden, die einen AccessToken zurückgibt. Dieser AccessToken wiederum muß zum Laden der Widgets benutzt werden. Um eine Session mit Klarna über eine Server-zu-Server-Verbindung zu beginnen, verwenden Sie bitte folgende URL:

Parameter für Anlegen einer Session mit Klarna Payments

Rückgabe-Parameter für Anlagen einer Session mit Klarna Payments

Klarna Widgets anzeigen

Klarna verwendet Widgets, um dem Kunden die möglichen Zahlungsarten anzuzeigen. Die zur Auswahl stehenden Zahlungsarten ergeben sich aus der zuvor ausgewählten Kategorie (siehe Klarna Session erzeugen, PayType). Die Einbindung der Widgets erfolgt mithilfe des AccessToken (siehe Klarna Session erzeugen, AccessToken) und des Klarna JavaScript SDK. Wie das Klarna JavaScript SDK eingebunden und initialisiert wird und wie die Widgets geladen werden, wird auf der Klarna Webseite beschrieben:

Nach erfolgreicher Autorisierung erhalten Sie einen Autorisierungs-Token (TokenExt), der für die Auftragsanlage benutzt werden muß.

Klarna Session für die HPP erzeugen

Um eine Zahlung über die Klarna HPP abzuwickeln, verwenden Sie bitte folgende URL:

Parameter für das Aufrufen der Klarna HPP

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure

Bestellung bei Klarna anlegen

Um die Bestellung im Klarna-System über eine Server-zu-Server-Verbindung anzulegen, verwenden Sie bitte folgende URL:

Handelt es sich um die initiale Bestellung einer wiederkehrenden Bestellung (RTF=I), kann nur die Rechnungsadresse übergeben werden, keine Lieferadresse.

Weichen die Adressdaten von den Adressdaten ab, die bei der Autorisierung aus dem JavaScript-Widget übergeben wurden, wird die Bestellung abgelehnt.

Parameter zum Anlegen einer Bestellung bei Klarna

Rückgabe-Parameter beim Anlegen einer Bestellung bei Klarna

Wiederkehrende Bestellung (Abo) bei Klarna anlegen

Um eine wiederkehrende Bestellung (z.B. Abo) bei Klarna anzulegen, verwenden Sie bitte folgende URL:

Parameter für eine wiederkehrende Bestellung (Abo) mit Klarna Payments

Rückgabe-Parameter für eine wiederkehrende Bestellung (Abo) mit Klarna Payments

Rechnungs- und Lieferadresse ändern

Die Rechnungs- und Lieferdaten sind im Klarna-Widget übergeben worden. Solange noch keine Buchung erfolgt ist, können Rechnungs- und/oder Lieferadresse nachträglich angepasst werden. Hierzu verwenden Sie bitte folgende URL:

Parameter für eine Adressänderung bei Klarna Payments

Rückgabe-Parameter für eine Adressänderung bei Klarna Payments

Eindeutige Referenznummer ändern

Solange noch keine Buchung erfolgt ist, kann die eindeutige Referenznummer, die bereits beim Erzeugen der Klarna-Session im Parameter RefNr mitgeschickt wurde, nachträglich angepasst werden. Hierzu verwenden Sie bitte folgende URL:

Parameter für Änderung der Referenznummer bei Klarna Payments

Rückgabe-Parameter für Änderung der Referenznummer bei Klarna Payments

Bestellbetrag und Artikelliste ändern

Solange noch keine Buchung erfolgt ist, können der Bestellbetrag sowie die gesamte Artikelliste nachträglich angepasst werden. Hierzu verwenden Sie bitte folgende URL:

Parameter für Änderung von Bestellbetrag und Artikelliste bei Klarna Payments

Rückgabe-Parameter für Änderung von Bestellbetrag und Artikelliste bei Klarna Payments

Buchung

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Voll- oder Teilbuchung (Capture) für Klarna Payments über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

Parameter für Buchungen bei Klarna Payments

Rückgabe-Parameter für Buchungen bei Klarna Payments

Erneutes Versenden einer aktivierten Rechnung

Es kann vorkommen, dass ein Kunde die E-Mail mit den Zahlungs- und Bestellinformationen nicht erhalten hat. Dieser Request kann nur durchgeführt werden, wenn bereits eine Buchung durchgeführt wurde. Um das Versenden dieser E-Mail erneut anzustoßen, verwenden Sie bitte folgende URL:

Parameter für erneutes Versenden einer aktivierten Rechnung bei Klarna Payments

Rückgabe-Parameter für erneutes Versenden einer aktivierten Rechnung bei Klarna Payments

Gutschrift mit Referenz und Teilgutschrift

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Um eine Teil- oder Vollgutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:

Parameter für Gutschrift von Zahlungen mit Klarna Payments

Rückgabe-Parameter für Gutschrift von Zahlungen mit Klarna Payments

Storno

Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Mit diesem Aufruf können Sie den gesamten Autorisierungsbetrag, wenn noch keine Buchung erfolgt ist, stornieren oder den verbleibenden Autorisierungsbetrag stornieren, wenn bereits eine Teilbuchung erfolgt ist. Hierzu verwenden Sie bitte folgende URL:

Parameter für Storno von Zahlungen mit Klarna Payments

Rückgabe-Parameter für Storno von Zahlungen mit Klarna Payments

Batch-Nutzung der Schnittstelle

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Zahlung mit Klarna Payments übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Bei Buchung unterscheiden sich die Aufrufe zwischen Komplett- und Teil-Aktivierung. Bei einer Teilbuchung muss zusätzlich die Artikelliste bei <ArticleList> mit übergeben werden. Ebenso ist zusätzlich der Parameter <ArticleList> erforderlich, wenn eine Teil-Gutschrift auf eine Komplett-Aktivierung erfolgt. Bei einer Teil-Gutschrift auf eine Teil-Aktivierung hin sind die beiden Parameter <ArticleList> und <InvNo> zusätzlich erforderlich. Alle Zusatzparameter kommen ebenfalls in der Antwortdatei mit zurück.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine Zahlung mit Klarna Payments in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

Beispiel für Master MID-Funktion:

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien