Klarna

Klarna

This guide explains how to process Klarna payments with our SDK.

Configuration

In order to use Klarna your should send the following additional parameters with checkout ID request:

Parameter NameDescriptionMandatory / Conditional Mandatory
customer.identificationDocId The number of the identification document.
Required for transactions in SE, FI, NO, DK.
Conditional Mandatory
customer.identificationDocType The type of the identification document.
Required for transactions in SE, FI, NO, DK.
Conditional Mandatory
customer.givenName The customer.* parameters are mandatory, since they allow Klarna to determine the credit scoring and the risk level of the Shopper. Mandatory
customer.surname The customer.* parameters are mandatory, since they allow Klarna to determine the credit scoring and the risk level of the Shopper. Mandatory
customer.sex The customer.* parameters are mandatory, since they allow Klarna to determine the credit scoring and the risk level of the Shopper. Mandatory
customer.birthDate The customer.* parameters are mandatory, since they allow Klarna to determine the credit scoring and the risk level of the Shopper.
Required for transactions in DE, AT, NL.
Conditional Mandatory
customer.phone
or
customer.mobile
The customer.* parameters are mandatory, since they allow Klarna to determine the credit scoring and the risk level of the Shopper. Mandatory

Only one - the phone or the mobile number - must be provided, not both.
customer.email The customer.* parameters are mandatory, since they allow Klarna to determine the credit scoring and the risk level of the Shopper. Mandatory
cart.items[x].merchantItemId Article number of one shopping cart item.
The item number of the first shopping cart item (article number, title, unit price, VAT, discount, flags and quantity) will be 1.
Then, the second shopping cart item will be 2. And so on.
Mandatory
cart.items[x].name Description of one shopping cart item. Mandatory
cart.items[x].price VAT-inclusive unit price of the shopping cart item. Mandatory
cart.items[x].tax VAT percentage applied to the shopping cart item. Mandatory
cart.items[x].discount Discount percentage applied to the shopping cart item. Mandatory
cart.items[0].quantity Quantity of the shopping cart item.

For Partial CP the number of items in the shopping cart must be higher than 1, otherwise the transaction will fail.
Mandatory
billing.street1 Billing / Shipping address street. Mandatory
billing.street2 Billing / Shipping address house number. Mandatory
billing.postcode Billing / Shipping address zip code. Mandatory
billing.city Billing / Shipping address city. Mandatory
billing.country Billing / Shipping address country. Mandatory


SDK & Your Own UI

If you are using our SDK & Your Own UI please see this guide.