Guidance on enabling Klarna using Paytrail 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 Paytrail, it is essential to follow a set of best practices. This checklist will help you finalize your Klarna setup using Paytrail APIs and prepare for go-live with full functionality and compliance.
Set up branding in the Klarna Partner Portal
Upload your logo - ensure the assets meet Klarna’s format and resolution requirements.
Also, keep the Marketing Name under your Paytrail merchant account up to date in the Paytrail Merchant Panel. Your customers will see this Marketing Name in Klarna's purchase journey.
- Benefit: Klarna will reflect your brand across touchpoints with the consumer, improving recognition and trust.
Include line_items in the payload
Ensure to include items in your Paytrail /payments call.
- Benefit: Enables enhanced fraud detection, enriched post purchase experience with detailed receipts.
Share the customer facing reference
Ensure consistency across your systems and communications with customers by sharing your customer-facing order ID. To achieve this, utilize Paytrail's reference field when making the Paytrail /payments call.
- 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
Share the Supplementary Purchase Data via providerDetails.klarna.networkData in Paytrail's /payments call, which is a serialized JSON object that follows Klarna’s Interoperability Data Schema.
Also provide customer details such as email, firstName, lastName, phone, deliveryAddress and invoicingAddress.
- Benefit: Enhances session continuity, allowing for greater personalization and improved conversion rates by helping Klarna authenticate the customer faster.
Forward the Klarna Network Session Token
You will receive a klarna_network_session_token from Klarna when the customer interacts with services powered by Klarna Web SDK, such as Klarna On-site Messaging, Sign in with Klarna, or Express Checkout.
If klarna_network_session_token is available, include it under providerDetails.klarna.networkSessionToken in Paytrail's /payments call
- Benefit: Links customer context across touch points for a smoother experience.