Integration checklist

Guidance on enabling Klarna using Solidgate APIs and the different integration path available- Hosted Payment Page or building a custom payment selector form with Klarna APIs.

Integration Checklist

To ensure a robust, seamless, and customer-friendly Klarna integration through Solidgate, it is essential to follow a set of best practices. This checklist will help you finalize your Klarna setup using Solidgate APIs and prepare for go-live with full functionality and compliance.

Set up branding in the Klarna Partner Portal

Upload your logo and brand name - ensure the assets meet Klarna’s format and resolution requirements.

Benefit: Klarna will reflect your brand across touchpoints with the consumer, improving recognition and trust.

Include `line_items` in the payload

Add all available order details to the line items in your API requests to Solidgate.

Benefit: Enables enhanced fraud detection, enriched post purchase experience with detailed receipts.

Ensure consistency across your systems and communications with customer by sharing your customer-facing order ID ( order.references.merchantReference ).

Benefit: The information is displayed across all touch points between the customer and Klarna, including Klarna app and emails. It is also a key data point to support your reconciliation process and dispute management.

Send Supplementary Purchase Data

This data is a serialized JSON object that follows Klarna’s Interoperability Data Schema, shared via structured objects in Solidgate's API.

Include it in relevant API calls to provide session and customer context.

Benefit: Enhances session continuity, allowing for greater personalization and improved conversion rates. Additionally, it will support processing for specific MCCs.

Forward the Klarna network session token

In an Advanced integration, you will receive a [klarna_network_session_token](https://docs.klarna.com) from Klarna when the customer interacts with services powered by WebSDK, such as Klarna On-site Messaging, Sign in with Klarna, or Express Checkout.

If klarna_network_session_token is available, include it in your API requests to Solidgate.

Benefit: Links customer context across touch points for a smoother experience.

Integration checklist