Payment-method icon

Klarna Redirect Component

Add Klarna to an existing Components integration.

If you are using Android Components v5.0.0 or later:

This payment method requires no additional configuration.

Follow the Components integration guide and use the following module and Component names:

If you have an existing Android Components integration, you can use our Redirect Component to redirect the shopper to Klarna to complete the payment. When making a Klarna payment, you need to:

  1. Include Klarna in the list of available payment methods.
  2. Collect shopper details, and specify these in your payment request. Klarna uses this information for risk checks.
  3. Provide information about the purchased items by specifying lineItems in your payment request.
  4. Handle the redirect.
  5. Capture the payment after the goods have been sent. This triggers the payment instructions to be sent to the shopper.

Requirements

Requirement Description
Integration type Make sure that you have built an Advanced flow Android Components integration.
Setup steps Before you begin, add Klarna in your Customer Area.

Show Klarna in your payment form

When making a Klarna payment, collect the following shopper details:

Shopper detail Description Required
Shopper name The shopper's full name and gender, if specified.
Shopper email The shopper's email address. This is where Klarna will send the invoice.
The billing address The postal address to be included on the invoice.

For improved conversion rates, we strongly recommend that you collect the shopper name and the billing address.

If you are using the /paymentMethods to show available payment methods to the shopper, specify in your /paymentMethods request one of the following combinations of countryCode and amount.currency, depending on which Klarna payment method you want to accept:

Country/region countryCode amount.currency Pay now Pay later Pay over time
Australia AU AUD -x- -x- -white_check_mark-
Austria AT EUR -white_check_mark- -white_check_mark- -white_check_mark-
Belgium BE EUR -white_check_mark- -white_check_mark- -x-
Canada CA CAD -x- -x- -white_check_mark-
Czech Republic CZ CZK -x- -x- -white_check_mark-
Denmark DK DKK -x- -white_check_mark- -x-
Finland FI EUR -x- -white_check_mark- -white_check_mark-
France FR EUR -x- -x- -white_check_mark-
Germany DE EUR -white_check_mark- -white_check_mark- -white_check_mark-
Greece GR EUR -x- -x- -white_check_mark-
Ireland IE EUR -x- -x- -white_check_mark-
Italy IT EUR -x- -x- -white_check_mark-
Norway NO NOK -x- -white_check_mark- -white_check_mark-
Poland PL PLN -x- -white_check_mark- -x-
Portugal PT EUR -x- -x- -white_check_mark-
Romania RO RON -x- -x- -white_check_mark-
Spain ES EUR -x- -x- -white_check_mark-
Sweden SE SEK -white_check_mark- -white_check_mark- -white_check_mark-
Switzerland CH CHF -white_check_mark-
See note 3
-white_check_mark-
See note 3
-x-
The Netherlands NL EUR -white_check_mark- -white_check_mark- -white_check_mark-
United Kingdom GB GBP -x- -white_check_mark- -white_check_mark-
United States US USD -x- -x- -white_check_mark-

3If you want to offer Klarna in Switzerland, contact our Support Team.

The /paymentMethods response contains:

  • paymentMethod.type: klarna_paynow for Klarna Pay Now.
  • paymentMethod.type: klarna for Klarna buy now pay later.
  • paymentMethod.type: klarna_account for Klarna Pay Over Time.

We provide logos for Klarna which you can use on your payment form. For more information, refer to Downloading logos.

Make a payment

Klarna requires shopper details such as name and address to approve a payment. To improve shopper experience and conversion rates, provide these details in the payment request and make sure that the parameters in the request match.

Send the shopper name and billing address in the request.
We recommend that you send the shopper name and billing address to improve the shopper experience. If not provided in the request, Klarna will ask the shopper to provide these parameters in the checkout page.

Make sure that the country, the currency, and the shopper locale in the request are compatible.

  • Klarna will only approve the payment if the country it is made from matches the currency and the country specified in the billing address.
  • The Klarna checkout page can only be rendered in another language if the specified locale matches the country and currency used in the request. By default, the checkout page is rendered is English (en-US).

The following table shows the possible combinations that you can send in a payment request:

Country countryCode
billingAddress.country
amount.currency shopperLocale
default
shopperLocale
alternative
Australia AU AUD en_US en_GB
Austria AT EUR en_US de_AT
Belgium BE EUR en_US nl_BE, fr_BE
Canada CA CAD en_US fr_FR
Czechia CZ CZK en_US cs_CZ
Denmark DK DKK en_US da_DK
Finland FI EUR en_US fi_FI, sv_FI
France FR EUR en_US fr_FR, en_FR
Germany DE EUR en_US de_DE
Greece GR EUR en_US el_GR
Ireland IE EUR en_US en_GB
Italy IT EUR en_US it_IT
Norway NO NOK en_US nb_NO
Poland PL PLN en_US pl_PL
Portugal PT EUR en_US pt_PT
Romania RO RON en_US ro_RO
Spain ES EUR en_US es_ES
Sweden SE SEK en_US sv_SE
Switzerland CH CHF en_US de_CH, fr_CH, it_CH
The Netherlands NL EUR en_US nl_NL
United Kingdom GB GBP en_US en_GB
United States US USD en_US es_US

Make a payment request

  1. From your server, make a /payments request, specifying:

    • paymentMethod.type: The type of Klarna payment the shopper wants to use.  Possible values:
    • klarna_paynow for Klarna Pay Now.
    • klarna for Klarna buy now pay later.
    • klarna_account for Klarna Pay Over Time.
    Parameter name Required Description
    lineItems -white_check_mark- Price and product information about the purchased items.
    For Klarna to approve the payment, the total amount specified in lineItems must match the amount.value, and each line item must include a description.