Notes to type of payment

API-Requests - special notes / deviations

Overview of deviations

Clearingtype / Clearingsubtype

Summary

Klarna Checkout is divided in 3 steps.

1. creating a new session via our server api
   1. optional: updating the session
2. token-handling via klarna checkout .js
3. finalizing the checkout ((pre-)authorization) via our server api

Creating a new session via our server api

In the first step you need to setup a new checkout session. You can do so by sending a genericpamynet-request to our server api as listed below.

Please make sure to send the customer data within this request as they're needed to initiate a new session.

→ Genericpayment start_session

Optional update session

If the customer leaves the checkout page and comes back later, you can update the created session and change for example the address data.

→ Genericpayment update_session

Token-handling via Klarna Widget

Part of the response is a client token. This token needs to be passed to the Klarna Widget. This Widget sends the client token together with the selected payment method (e.g. "Klarna Pay Later") to Klarna to get a authorization token.

→ Widget

Finalizing the checkout ((pre-)authorization) via our server api

In the last step, you need to send the authorization token received by Klarna widget as part of the (pre-)authorization request to our server api.

→ Preauthorization/Authorization

Anchor
start_session start_session

Genericpayment start_session

Anchor
update_session update_session

Genericpayment update_session

To update an order, you need to send a genericpayment-request with action=update. The call needs to provide the new list of items representing the complete shopping cart.

Anchor
widget widget

Klarna Widget

Widget Description here

Anchor
authorization authorization

Preauthorization/Authorization

Request "preauthorization / authorization"
API parameter	Required	Comments
firstname	+	Mandatory - and can not be substituted by usage of company
lastname	+	Mandatory - and can not be substituted by usage of company
street	+	Mandatory - full address is required and must match the shipping-address Wird das sonst irgendwo abgelehnt? Wer prüft das? Können wir da vielleicht eine Note in diesem Dokument draus machen und hier nur noch "mandatory" eintragen?
zip	+	Mandatory - full address is required and must match the shipping-address
city	+	Mandatory - full address is required and must match the shipping-address
country	+	Mandatory - full address is required and must match the shipping-address
addressaddition	+	Mandatory for NL
shipping-address	-	Shipping-address parameters should not be used at all. If shipping-address is used it must be the same as the invoice address !
gender	o	Mandatory for Germany, Netherlands and Austria
ip	+	Mandatory wozu brauchen wir die? In der checkout API von Klarna sehe ich die nicht https://developers.klarna.com/api/#payments-api-create-a-new-order
email	+	Mandatory wozu brauchen wir die? In der checkout API von Klarna sehe ich die nicht https://developers.klarna.com/api/#payments-api-create-a-new-order
telephonenumber	+	Mandatory wozu brauchen wir die? In der checkout API von Klarna sehe ich die nicht https://developers.klarna.com/api/#payments-api-create-a-new-order
birthday	o	Mandatory for Germany, Netherlands and Austria
personalid	o	Mandatory for Sweden, Finland, Denmark and Norway
it[n], id[n], pr[n], no[n], de[n], va[n]	+	The complete shopping cart must be specified.
add_paydata[klsid]	o	Mandatory for Klarna Installment (KLS): Campaign code

Capture

Request "capture"
API parameter	Required	Comments
capturemode	+	Parameter capturemode is mandatory to indicate whether this capture will be the last one. wenn ich das nicht mitgebe, bekomme ich keinen Fehler. Anscheinend wird also ein Wert als default genommen? Welcher?
settleaccount	+	Parameter settleaccount is mandatory to indicate whether a refund to the customer should be initiated. wenn ich das nicht mitgebe, bekomme ich keinen Fehler. Anscheinend wird also ein Wert als default genommen? Welcher?

Debit / Refund

Request "debit"
API parameter	Required	Comments
settleaccount	+	Parameter settleaccount is mandatory to indicate whether a refund to the customer should be initiated. wenn ich das nicht mitgebe, bekomme ich keinen Fehler. Anscheinend wird also ein Wert als default genommen? Welcher?