Build the checkout form overview

There are several ways to add Klarna to a checkout you build on top of Worldpay. The right one for you depends on two things:

1. 1.
   The customer experience you want — an in-page Klarna pop-up, or a full-page redirect to Klarna's hosted page.
2. 2.
   Who runs the Klarna lifecycle server-side — you, or Worldpay.

Pick your combination below; each variant links to its dedicated end-to-end walkthrough.

• In-page pop-up — only available with the Klarna Web SDK. The Klarna Purchase Journey opens in an overlay inside your checkout.
• Full-page redirect to Klarna's hosted page — used with the Klarna Payment Presentation API (no SDK). When step-up is required, the customer is redirected to Klarna's hosted page to complete the Klarna Purchase Journey.

The Klarna Web SDK runs client-side in your checkout, renders Klarna in your payment selector, and opens the Klarna Purchase Journey as an in-page pop-up.

• Partner-orchestrated — you call Klarna's Payment Request API directly and subscribe to the completion webhook yourself. Most control, full Klarna feature surface.

  Walkthrough →

• Worldpay-orchestrated — you forward the klarna_network_session_token to Worldpay; Worldpay calls Klarna's Payment Request API on your behalf and returns a payment_request_id back to the SDK when step-up is required. No webhook subscription on your side.

  Walkthrough →

You call Klarna's Payment Presentation API server-side, render Klarna in your own payment selector, and the Klarna Purchase Journey ends in a full-page redirect to Klarna's hosted page. No SDK.

• Partner-orchestrated — you also call Klarna's Payment Request API directly and subscribe to the completion webhook yourself. Server-side equivalent of the Web SDK partner-orchestrated path.

  Walkthrough →

• Worldpay-orchestrated — you only call Klarna's Payment Presentation API; Worldpay handles authorization and returns a payment_request_url for the redirect. No webhook subscription on your side.

  Walkthrough →

Two further options on the Worldpay side, with no Klarna-specific work for you:

• Worldpay's hosted payment page — Klarna shows up by default once it's enabled with Worldpay.
• Worldpay's embedded payment form (when Worldpay offers one) — drop Worldpay's payment-form components into your own checkout and Klarna is rendered inside them.

For the configuration of either, follow Worldpay's product documentation.