| Table of Contents |
|---|
Ü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.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Partner-Name PageWithExcerpt Wording
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.
| Page properties | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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).
| Note | ||
|---|---|---|
| ||
Bitte beachten Sie, dass die Buchung (capture.aspx) manuell erfolgen muss, um die Zahlung durchzuführen und den Geldfluss zu initiieren. |
Diagramm zum Prozessablauf Direktanbindung
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Prozessablauf Klarna Payments Direktanbindung
Diagramm zum Prozessablauf HPP
| Multiexcerpt include | ||||||||
|---|---|---|---|---|---|---|---|---|
|
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.
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Definition PageWithExcerpt Definition DE
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, rufen verwenden Sie bitte folgende URL auf:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Anlegen einer Session mit Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
https://developers.klarna.com/documentation/klarna-payments/integration-guide/present-klarna-widget/ |
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für das Aufrufen der Klarna HPP
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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 auf:
|
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.
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter zum Anlegen einer Bestellung bei Klarna
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für eine wiederkehrende Bestellung (Abo) mit Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für eine Adressänderung bei Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Änderung der Referenznummer bei Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Änderung von Bestellbetrag und Artikelliste bei Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Buchungen bei Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für erneutes Versenden einer aktivierten Rechnung bei Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Gutschrift von Zahlungen mit Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Storno von Zahlungen mit Klarna Payments
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Rückgabe-Parameter für Storno von Zahlungen mit Klarna Payments
Batch-Nutzung der Schnittstelle
Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Intro PageWithExcerpt Reuse API
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:
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der möglichen Batch-Versionen
Der Aufbau für eine Zahlung mit Klarna Payments in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Beispiel für Master MID-Funktion:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der Felder im Datensatz von Batch-Dateien
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter, werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien