Klarna

Klarna was founded in 2005 in Stockholm, Sweden with the aim of making it easier for people to shop online. In the last 17 years, technology has evolved, excited and transformed the world around us, yet our mission remains as relevant as ever, to make paying as simple, safe and above all, smoooth as possible. Klarna is the leading global payments and shopping service, providing smarter and more flexible shopping and purchase experiences to 150 million active consumers across more than 450,000 merchants in 45 countries. Klarna offers direct payments, pay after delivery options and instalment plans in a smooth one-click purchase experience that lets consumers pay when and how they prefer to. When the company acquired SOFORT in 2014 the Klarna Group was formed. Klarna is backed by investors such as Sequoia Capital, Silver Lake, Bestseller Group, Dragoneer, Permira, Visa, Ant Group and Atomico.

Source: https://www.klarna.com/international/about-us/

Features

Integration type

Pop-in (redirection in overlay)

Tokenization

Yes

Payment Flow

1-step payment flow : Capture

2-step payment flow : Authorization + Capture

3-step payment flow : Pending Authorization + Authorization + Capture

Additional features

Information request and CIT

MIT

Server-to-server

How to test?

info

All tests behaviours are directly available within the payment page redirected to.

Data Mapping & Mandatory Fields

Below is the mapping between your Create Session request and the fields expected by this payment method.

Purse Session field	Mandatory
amount	No
order.redirection	Yes
order.reference	No
order.amount	Yes
order.tax_amount	No
order.currency_code	Yes
customer.type	No
customer.company_name	No
customer.gender_code	No
customer.birthdate	No
customer.billing_address.first_name	No
customer.billing_address.last_name	No
customer.billing_address.address_lines	No
customer.billing_address.city	No
customer.billing_address.postal_code	No
customer.billing_address.country_code	Yes
customer.billing_address.province_code	No
customer.billing_address.email	No
customer.billing_address.phone	No
customer.billing_address.mobile_phone	No
customer.billing_address.work_phone	No
shipments.shipping_address.first_name	No
shipments.shipping_address.last_name	No
shipments.shipping_address.address_lines	No
shipments.shipping_address.city	No
shipments.shipping_address.postal_code	No
shipments.shipping_address.country_code	No
shipments.shipping_address.province_code	No
shipments.shipping_address.email	No
shipments.shipping_address.phone	No
shipments.shipping_address.mobile_phone	No
shipments.shipping_address.work_phone	No
shipments.item_lines.name	Yes
shipments.item_lines.price	Yes
shipments.item_lines.quantity	Yes
shipments.item_lines.amount	Yes
shipments.item_lines.tax_lines.rate	No
shipments.item_lines.tax_lines.amount	No

Payment Labels

Label	Method	Payment type
klarna	installments	primary (payment by installments)

Actions

Action	Mandatory fields	Optional fields
INIT	-	-
APPLY	-	-

Status

PSP status	State	Code	Description
SUCCESS	SUCCESS	SUCCEEDED	Successful request
COMPLETED	SUCCESS	SUCCEEDED	Consumer has successfully gotten an Authorization from the Payment system on updated_at. The Authorization Token is contained in the authorization_token field in a Klarna Payments integration.
CREATE	SUCCESS	SUCCEEDED	Create request
BACK	WAITING	SUCCEEDED	Consumer has pressed the Back button on updated_at. Session is still open for them to retry.
IN_PROGRESS	WAITING	SUCCEEDED	Consumer has entered the Payment Page on update_at
WAITING	WAITING	SUCCEEDED	Session is created and consumer has not entered the Payment Page yet
BAD_REQUEST	ERROR	FAILED	Bad format: parameter
BAD_VALUE	ERROR	FAILED	Bad value: parameter
CANCEL_NOT_ALLOWED	ERROR	FAILED	Cancel not possible
CANCELLED	ERROR	FAILED	Consumer has cancelled the HPP Session on updated_at. This cancellation is definitive.
CAPTURE_NOT_ALLOWED	ERROR	FAILED	Capture not possible
DISABLED	ERROR	FAILED	Session was disabled by an API call, on the merchant’s initiative, on updated_at.
ERROR	ERROR	FAILED	Consumer has encountered an error while paying on updated_at. Session is still open for them to retry.
FAILED	ERROR	FAILED	Consumer has been declined for the Payment on updated_at. Session is still open for them to retry.
NO_SUCH_CAPTURE	ERROR	BAD_REQUEST	Capture cannot be found
NO_SUCH_ORDER	ERROR	BAD_REQUEST	Order cannot be found
NOT_ALLOWED	ERROR	FAILED	Unauthorized token
NOT_FOUND	ERROR	BAD_REQUEST	Invalid authorization token
REFUND_NOT_ALLOWED	ERROR	FAILED	Refund not possible
TOKEN_NOT_FOUND	ERROR	BAD_REQUEST	Customer token not found
UNPROCESSABLE_ENTITY	ERROR	FAILED	Unprocessable request
UNKNOWN_RESPONSE	ERROR	FAILED	Partner unknown