Introduction

Comprehensive framework to build secure, compliant, and up-to-date integrations with Klarna Network, tailored for acquiring partner developers.

The Klarna Integration Guidelines for Acquiring Partners are a key resource designed to support Payment Service Providers to create seamless and secure integrations of Klarna Network to enable the distribution of Klarna services.

This documentation serves as a supplemental guide to the Klarna Network Rules, API specifications, and the relevant Klarna Network Distribution Agreement. By following the guidance outlined here, Acquiring Partners ensure the integrity and success of Klarna’s global payment ecosystem.

Klarna offers a global and interoperable platform designed to support partners management, transaction processing, post-purchase operations, and conversion rate optimization. Powered by the Web SDK and supported by extensive JavaScript SDK capabilities alongside Management and Partner Product APIs, this platform ensures seamless integration. As a Klarna partner, you are equipped to maximize the benefits of all available Klarna features.

As an Acquiring Partner, understanding our solution principles and committing to them is essential before proceeding with integration and offering Klarna product suite to your Partners. This foundational understanding ensures that you can provide a best-in-class experience to your Partners, streamlining the integration and the adoption of future enhancements. A more detailed exploration of the following principles and their influence on the Klarna Network requirements, recommendations, and integration path is available in the Klarna Network Rules.

The Klarna Integration Guidelines are structured to provide a comprehensive framework for deploying Klarna’s solutions in accordance with network requirements. Closely aligned with the Klarna Network Rules, these guidelines ensure that by following them, partners automatically meet all necessary technical and operational standards.

For Acquiring Partners unable to support the primary integration path, Klarna offers alternative integration flows, each with clearly defined criteria and prerequisites. These alternatives are not optional shortcuts; rather, all integration paths presented, including alternatives, must be implemented as described.

Recommendations in this document are to be treated as mandatory requirements.

This documentation is intended specifically for developers and product manager contributing at Acquiring Partners responsible for implementing, maintaining, or improving a Klarna Network integration. Whether setting up a new connection or optimizing an existing one, this guide provides essential instructions to achieve compliance and maximize integration performance.

Adhering to these guidelines helps preserve the trust, security, and operational efficiency of the Klarna Network. Every compliant integration strengthens the reliability of the system, benefiting all users of Klarna’s product suite.

The Klarna Integration Guidelines are periodically reviewed and updated to reflect changes in technology, policy, and operational practices. Information regarding the update process, version schedules, and communication of changes can be found in the Klarna Network Rules. Partners are encouraged to remain informed and implement changes promptly to maintain compliance.

All definitions stated in the Klarna Network Rules also apply to this document. However, for clarity and ease of reference, additional terms may be defined directly within the content. This approach eliminates the need for cross-referencing and enables quicker comprehension of technical concepts in context.

Each integration must meet the following principles:

  • Safe and Secure Shopping
  • Global Availability
  • Integration Simplicity
  • Product Suite Interoperability
  • High Performance
  • Payment Programs
Management APIGlobal management of merchant lifecycle with Klarna, optimizing performance and unlocking ubiquity:
Easy onboarding and end-to-end Partner Accounts management including:
  • Global support by design
  • Onboarding and offboarding
  • Pricing management and querying price plans anytime
  • Integrated, automated, transparent fraud management enabling the ability to operate in real time.
  • Immediate automatic notifications via webhooks.
  • Flexibility of settlements and reconciliation process.
Partner product APIEasy access and scalable distribution of the Klarna Product Suite through:
Single API suite to access all Klarna products and features, enabling:
  • Payment API (Authorization, Request, Transaction)
  • Notifications API (Webhooks and signing keys)
  • Messaging API (Descriptors and Dynamic placements)
  • Settlements API
  • Disputes API

Global harmonized endpoint
Authentication for all features