Notes to type of payment

API-Requests - special notes / deviations

Overview of deviations

Clearingtype / Clearingsubtype

Summary

Klarna Checkout is divided in 3 steps.

add_paydata[action]=start_session
aid=111111
amount=2222
api_version=1.00
birthday=1958101
city=Neuss
clearingtype=fnc
country=DE
currency=EUR
de[1]=for
ocean use only
email=klarna@approved.de
encoding=UTF-8
financingtype=KLS
firstname=Testperson-de
gender=m
id[1]=boat66
it[1]=goods
key=e10adc3949ba59abbe56e057f20f883e
language=de
lastname=Approved
mid=11111
mode=test
no[1]=1
portalid=2011111
pr[1]=8540
request=genericpayment
salutation=Herr
street=Hellersbergstraße 14
telephonenumber=01522113356
va[1]=1900
zip=41460

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

the follwing integration steps are taken from Klarna documentation ( https://developers.klarna.com/documentation/klarna-payments/integration-guide/present-klarna-widget )

After creating a new session, you want to present the klarna widget to your customer. This widget allows you to present all 3 payment methods offered by Klarna to the customer or define what payment method should be presented to the customer. This is 

<script>
  window.klarnaAsyncCallback = function () {

    // This is where you start calling Klarna's JS SDK functions
    // 
    // Klarna.Payments.init({....})

  };
</script>
<script src="https://x.klarnacdn.net/kp/lib/v1/api.js" async></script>

Klarna.Payments.init({
  client_token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmb28iOiJiYXIifQ.dtxWM6MIcgoeMgH87tGvsNDY6cH'
})

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?