API and SDKs
Before you start with Hosted Payment Page

Integrate Klarna's Hosted Payment Page (HPP) with Klarna Payments and Order Management to deliver a seamless consumer payment experience and efficient order processing.

Technically, HPP is a companion service to Klarna Payments, which can be referred as a Payment Provider. You will have to integrate one of these APIs to create a Payment Session, and then use HPP to deliver the Payment experience to your consumers.

A complete payment session will involve three of Klarna services:

  1. Klarna Payments - Payment API to start a Payment session (KP Session).
  2. Hosted Payment Page - API to distribute the Payment session to your Consumer.
  3. Order Management - Order API to capture payment or refund the order that was created.

An integration guide is available for:

  • Read HPP with Klarna Payments integration guide

In this document, the term Payment Provider refers to Klarna Payments and Payment Session refers to the corresponding KP Session on Klarna Payments.

Link copied!

The overall integration sequences between the backend of the integrator, the Consumer and Klarna depends on the use case (ie eCommerce, In-store or Telesales) as all interactions depend on the distribution mechanism and how the status of the HPP Session is read.

This diagram shows the common step between these integrations.

sequenceDiagram autonumber participant A as Consumer Browser participant B as Merchant Backend participant C as HPP participant D as Payment Provider A -->> B: Intent of buying B ->> D: Create KP session D -->>B: KP session B ->>C: Create HPP session C -->>B: HPP session note over A, D: Distribution of the URL to the consumer is specific to the use case the integratior targets.<br/> It would be via redirection in an eCommerce flow, by email or SMS for Telesales and In-store, or by QR Code. A -> C: Requets the Payment Page via an URL C -->>A: Hosted Payment Page rendering KP session with Merchant's customization A ->>C: Presses pay button C -->>A: Display confirmation of payment or order confirmation note over A,D: Dependeding on the integration use case, the consumer may be redirected.<br/> Integrator will have to handle how to get the payment confirmation using the HPP API or the Payment Provider one.