Guidance on enabling Klarna using Worldline APIs and the different integration path available: Hosted Payment Page or building a custom payment selector form with Klarna APIs.
To ensure a robust, seamless, and customer-friendly Klarna integration through Worldline, it is essential to follow a set of best practices. This checklist will help you finalize your Klarna setup using Worldline APIs and prepare for go-live with full functionality and compliance.
Upload your logo and brand name - ensure the assets meet Klarna’s format and resolution requirements.
Add all available order details to the line items in your API requests to Worldline.
Ensure consistency across your systems and communications with customer by sharing your customer-facing order ID ( order.references.merchantReference
).
This data could be shared via redirectPaymentMethodSpecificInput.paymentProduct838SpecificInput.interoperabilityData
, which is a serialized JSON object that follows Klarna’s Interoperability Data Schema or via structured objects in Worldline's API.
Include in relevant API calls to provide session and customer context.
redirectPaymentMethodSpecificInput.paymentProduct838SpecificInput.interoperabilityData
will support processing for specific MCCs.In an Advanced integration, you will receive an interoperability_token
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 interoperability_token
is available, include it in your API requests to Worldline.