Partner Integrations

Klarna Integration Made Easy

Before you start

Which Klarna product is the right one for me?

Klarna offers two products for offering payments for a merchant.

One is called Klarna Payments that allows you to add Payment Methods from Klarna into your existing checkout.

The second one is called Klarna Checkout which replaces the checkout entirely and allows you to handle address collection, shipping selection as well as payment selection inside the iframe that Klarna provides.

Examples of the two are shown in the mockup images displayed below.

With Klarna Checkout you will get an optimized checkout for higher conversations, where with Klarna Payments you will select payment modules separately and keep full control over the checkout. You as our partner may offer both products to your merchants - the merchant can only show one product to its customers - either Klarna Payments Methods or Klarna Checkout.

smoooth handbooksmoooth handbook Mockup of Klarna Payment inlined in a merchant checkout page

smoooth handbooksmoooth handbook Mockup of a merchant using Klarna Checkout

Note: If you are only looking into adding Order Management functionality you do not have to decide, nor focus on the create order step under Step 2. Integrating Klarna.

Step 1: Getting Started - Credentials

Before you can start, you will need to create your own set of credentials . Those credentials will give you access to Klarna Playground environment (APIs + Merchant portal) - where you can use the same functionality as a merchant (e.g. generate API credentials, trigger API calls, see orders and logs etc).

Step 2: Integrating Klarna

Klarna offers multiple products and functionalities. A full overview of all Klarna products can be found under the business section of Klarna.com . Please make sure you pick the Klarna solution that suits your merchant base best. Compare the integration guide or SDK for Klarna Checkout, and the integration guide or SDK for Klarna Payments before moving on.

All Klarna orders must be created from the store. Merchants may use all order management functionality directly from the webshop admin or from the Klarna Merchant Portal . It is recommended that order management will be handled by redirecting merchants to Klarna merchant portal, where they can manage orders directly towards Klarna (handbook for Merchant Portal). A separate integration of order management functionality is not required.

The following functionalities are most commonly used by our merchants and partners:

ActionSystemStep-by-step DescriptionAPI Endpoints + Reference
Action
Create an order
System
Webshop
Step-by-step Description
Creating an order using Klarna Payment (Slice it, Pay Now, Pay Later)  

Creating an order using Klarna Checkout
API Endpoints + Reference
Payments API
Checkout API
Action
Shipping an order
System
Webshop Admin or Klarna Merchant Portal
Step-by-step Description
Reporting a shipment (Capture)
API Endpoints + Reference
Order Management API
Action
Refunding an order
System
Webshop Admin or Klarna Merchant Portal
Step-by-step Description
Refunding an order (Refund)
API Endpoints + Reference
Order Management API

All additional functionality, as well as full API specification, can be found on developers.klarna.com .

Get better support

Klarna recommends to send in system/platform platform name and version as well as module/ integration name and version in the user agent in each server side call as part of the request header:

Example: {SDK Version if applicable}/{shop name and version}/{module name and version}”

In the case of issues, all Klarna teams can support you better, by identifying all affected orders.

Step 3: Merchant Admin - Payment method configuration

The following options should be made available to merchants in the payment method configuration

  • Option to switch between Playground and Live Environment
  • Klarna Credentials (Username, Password)

Please note that merchants selling to the US and Europe will have 2 sets of Klarna credentials - this needs to be supported by your system.

Additional Requirements

Some countries require additional legal information on your website. Legal requirements for Klarna Payment Methods and for Klarna Checkout .

Visual Guidelines

Using Klarna’s logotype generates trust and increases your conversion. Klarna Logos and Branding elements can be found here .

Step 4: Testing & Go Live

Ensuring that your Klarna integration works smooothly is key - we have created a checklist for you to help you validate the most important elements in your Klarna integration. Klarna may reach out to you for additional acceptance tests if necessary.

You are required to complete the checklist in Appendix 1, before going live with a Klarna Service. Once you have finished, you are required to complete the form below before any of your clients can go live with a Klarna Service.

Required information

to be listed on the website in order for a store to be taken live by Klarna

Company information listed somewhere on the website

  • Corporate address (physical address)
  • Organization number
  • Reg. company name
  • Contact details (Email and phone number)

Terms & conditions available

  • Shipping information (how delivery is made)
  • Estimated shipping time (e.g. “delivery will be made within 3 days”
  • Return- and claim information including info about the withdrawal right of (at least) 14 days
  • Refund information including info of when and how the refund is made (Klarna handles the refund)
  • States information about their Customer Service and clearly presents instructions on how to reach them by email and/or phone

If after reading through this document and reviewing the developers.klarna.com you still have questions, please contact partner.tech@klarna.com .

Appendix 1 - Test cases for Partner Integration

Test CaseExpected Outcome
1
Test Case
General
Expected Outcome
 
1.1
Test Case
Log in to shop system admin system using test merchant credentials.
Expected Outcome
Credentials valid. User able to log in.
1.2
Test Case
Activate a Klarna Service in the admin system.
Expected Outcome
Klarna activated and reflected in shop frontend
1.3
Test Case
Switch between playground and live
Expected Outcome
Merchant able to switch between Klarna test environment (playground) and live environment
1.4
Test Case
Klarna logo displayed on shop admin system + test merchant.
Expected Outcome
Klarna logos to be displayed
1.5
Test Case
Klarna T&Cs
Expected Outcome
Klarna T&Cs can be added to merchant Terms in regions where applicable
1.6
Test Case
US + Europe support only: Two region setup supported
Expected Outcome
Merchants can set a separate MID and API key for the US region and the European region.
2
Test Case
Klarna Checkout
Expected Outcome
 
2.1
Test Case
Load Klarna checkout
Expected Outcome
Klarna Checkout renders in checkout.
2.2
Test Case
Correct purchase country + currency + locale sent to klarna
Expected Outcome
Locale to match local Klarna offerings.
2.3
Test Case
Klarna payment methods rendered
Expected Outcome
Pay later / Slice it / Pay Now rendered
2.4
Test Case
Klarna confirmation URL shown with correct order details
Expected Outcome
Klarna confirmation URL shown with correct order details
2.5
Test Case
Merchant terms and conditions displayed accordingly
Expected Outcome
Merchant T&Cs to be displayed.
2.6
Test Case
Order placed on shop admin system
Expected Outcome
Order placed successfully with order number.
3
Test Case
Klarna Payments
Expected Outcome
 
3.1
Test Case
Klarna Payments payment option shown in the checkout page.
Expected Outcome
Pay later / Slice it / Pay Now rendered with correct end points.
3.2
Test Case
Klarna payment method widget loaded
Expected Outcome
Widget loaded as expected.
3.3
Test Case
Session created and order lines send in upon user entering checkout page.
Expected Outcome
Create session call to be sent to Klarna with no customer details.
3.4
Test Case
Correct purchase country + purchase currency + locale sent to klarna.
Expected Outcome
Locale to match Klarna offerings.
3.5
Test Case
Order placed on shop admin system
Expected Outcome
Order placed successfully with order number.
4
Test Case
Order Management
Expected Outcome
 
4.1
Test Case
Order created in shop admin system with merchant system order number.
Expected Outcome
Order visible on shop system backend with correct order amount.
4.2
Test Case
Order details sent to Klarna match shop admin system order details.
Expected Outcome
Order details to match on klarna merchant portal.
4.3
Test Case
Order Management done via Klarna merchant portal OR capture and refund are successfully triggered from shop admin
Expected Outcome
Order Management functionality (capture / refund / cancellation) links to Klarna Merchant portal with clear instructions  for the merchant OR is successfully triggered from shop admin