API GuideDashboard
Home
Payments
Automation
Observability
Reconciliation
Payment Methods
Fraud Providers
SDK Reference
Changelog

On Web, iOS, Android and React Native we now support the following Klarna flows:

  1. 1
    Pay Now
  2. 2
    Pay Later: Pay in 30 days
  3. 3
    Pay over time: Pay in 3-4 instalments. First payment right away, then the rest in instalments (no interest)
  4. 4
    Fair financing: Instalment plans of 6, 12, 24, and 36 months with flexible payments (with interest)

Get started with Klarna

Before you begin

If this is your first payment method, complete the "Process Payments" guide to begin processing payments with Primer.

Connect Klarna to Primer

  1. 1

    Add Klarna payment method to your Dashboard

    Go to the Connections section of the Dashboard and look for Klarna.

    Follow the instructions to connect your Klarna processor account to your Primer Dashboard.

  2. 2

    Activate Klarna on the Checkout

    Go to the Checkout section of the Dashboard and activate the Klarna payment method.

    Then go to the settings view of Klarna, and make sure that Klarna is properly set up to use your Klarna processor account.

  3. 3

    Configure a Workflow to process payments made with Klarna

    Go to the Workflow make sure your Klarna processor is used to process payments made with Klarna.

Prepare the client session

Klarna leverages the following parameters to process a payment.

Pass them when creating the client session.

Parameter NameRequiredDescription
  1. currencyCode
3-letter currency code in ISO 4217 format, e.g. USD for US dollars
  1. order
  2. ↳
    lineItems
Details of the line items of the order
  1. order
  2. ↳
    countryCode

The country code of the user.

Learn more about the supported countries and currencies by visiting Klarna Documentation.

  1. customer
  2. ↳
    emailAddress

Customer's email address. Pass this value to pre-fill the Klarna payment form.

  1. customer
  2. ↳
    mobileNumber

Customer's mobile number (make sure it is the correct format for the country code). Pass this value to pre-fill the Klarna payment form.

  1. customer
  2. ↳
    shippingAddress

Customer's shipping address. Pass this value to pre-fill the Klarna payment form.

  1. customer
  2. ↳
    billingAddress

Customer's billing address. Pass this value to pre-fill the Klarna payment form.

When passing customer.billingAddress in the client session, ensure that Klarna has payment method categories configured for the given address.

If Klarna is not supported for the given billing address, no Klarna button will be rendered in the checkout.

  1. paymentMethod
  2. ↳ options
  3. ↳ KLARNA
  4. ↳
    extraMerchantData

Extra Merchant Data (EMD) package supported by Klarna can be passed via the client session. Any JSON object that will be accepted by Klarna can be sent. Available schemas are documented here

Add Klarna into your website or mobile app

Drop-in UI

Use our customizable drop-in UI to quickly add payment methods to your checkout.

Headless Checkout

Have the freedom to build your own UI using our headless checkout.