Integration checklist
Guidance on enabling Klarna using Worldpay APIs and the different integration path available- Hosted Payment Page or building a custom payment selector form with Klarna APIs.
Integration checklist
You've built and tested your Klarna integration through Worldpay — Klarna shows in your checkout and test payments succeed. Before you go live, run through the items below so Klarna performs at full conversion.
Set up branding in the Klarna Partner Portal
Upload your logo and brand name in the Klarna Partner Portal — the only place to configure your Klarna branding. Ensure the assets meet Klarna's format and resolution requirements.
- Benefit: Klarna reflects your brand across touchpoints with the consumer (Klarna app, emails, and the purchase journey), improving recognition and trust.
Include line items in the payload
Add all available order details at line-item level in your requests to Worldpay. See the Worldpay field reference for the exact field per API.
- Benefit: Enables enhanced fraud detection and an enriched post-purchase experience with detailed receipts in the Klarna app.
Share the customer-facing reference
Share your customer-facing order ID — the Klarna
purchase_reference — so it stays consistent across your systems and your communications with the customer. See the Worldpay field reference for the exact field per API.- Benefit: The reference is displayed across all touchpoints between the customer and Klarna, including the Klarna app and emails. It is also a key data point to support your reconciliation process and dispute management.
Send Supplementary Purchase Data
Share the Klarna Network Data as a serialized JSON object that follows Klarna's Network Data schema. For the full data structure, see How to share Klarna Network data; for the field to send it in, see the Worldpay field reference.
- Benefit: Enhances session continuity, allowing for greater personalization and improved approval rates. It also supports processing for specific MCCs.
Forward the klarna_network_session_token
When the customer interacts with a Klarna service powered by the Web SDK — such as On-site messaging, Sign in with Klarna, or Express Checkout — Klarna issues a
klarna_network_session_token. When it's available, forward it to Worldpay. See the Worldpay field reference for the exact field per API.- Benefit: Links customer context across touchpoints for a smoother experience.
Worldpay field reference
The field you use depends on which Worldpay API you integrate:
| Data point | Klarna field | Worldpay Gateway (WPG) | Worldpay Access |
|---|---|---|---|
| Line items | line_items | order/orderLines | order.items |
| Customer-facing reference | purchase_reference | orderCode | transactionReference |
| Klarna Network Data (SPD) | klarna_network_data | passthroughData | passthroughData |
| Klarna session token | klarna_network_session_token | providerToken | providerToken |