Integration checklist

Guidance on enabling Klarna using Cybersource and the different integration path available: Server-side Cybersource APIs or Cybersource Unified Checkout.

Integration Checklist

To ensure a robust, seamless, and customer-friendly Klarna integration through Cybersource, it is essential to follow a set of best practices. This checklist will help you finalize your Klarna setup using Cybersource 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 Cybersource.

For Online Payments API include orderInformation.lineItems[]. See documentation.

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.

For Online Payments API include merchantOrderNumber. See documentation.

For Checkout API include purchaseOrderNumber. See documentation.

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.

Forward the Klarna network session token

In an advanced integration, you will receive a klarna_network_session_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 a klarna_network_session_token is available, include it in your authorization request to Cybersource as processorInformation.authApprovalToken when calling the Payments API.

Example request

JSON

1 2 3 4 5 6 7 8 9 10

{
  "uri": "https://apitest.cybersource.com/pts/v2/payments",
  "method": "POST",
  "payload": {
    "processorInformation": {
      "authApprovalToken": "<klarna_network_session_token>",
      "supplementaryTransactionData": "{\"line_items\":[{\"line_item_metadata\":{\"categories\":[\"default\"]}}],\"travel_reservations\":[{\"travel_type\":\"AIR\",\"ticket_class\":\"ECONOMY\"}],\"lodging_reservations\":[{\"host\":{\"host_type\":\"HOTEL\"}}]}"
    },
    "orderInformation": {
      "billTo": {

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

Integration checklist