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
3-letter currency code in ISO 4217 format, e.g. USD for US dollars
  1. order
Details of the line items of the order
  1. order

The country code of the user.

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

  1. customer

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

  1. customer

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

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

  1. customer

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

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