Integration checklist

Guidance on enabling Klarna using Cybersource and best practices for server-side Cybersource API integrations.

2 min read

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 Cybersource Payments API include orderInformation.lineItems[]. See documentation.

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

Include your customer-facing payment reference in clientReferenceInformation.code when calling the Cybersource Payments API.

Benefit: Keeps the reference consistent across customer communications, reconciliation, 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 Web SDK, 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

POST https://apitest.cybersource.com/pts/v2/payments

JSON

1 2 3 4 5 6 7 8 9 10

{
  "orderInformation": {
    "billTo": {
      "firstName": "Test",
      "lastName": "Person",
      "country": "US",
      "email": "customer+us@klarna.com",
      "phoneNumber": "+13106683312",
      "address1": "123 Main Street",
      "address2": "Apt 4B",

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

Jump to section...

Integration checklist