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:
- To import the module: instant
- To launch and show the Component: InstantPaymentComponent
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:
- Include Klarna in the list of available payment methods.
- Collect shopper details, and specify these in your payment request. Klarna uses this information for risk checks.
- Provide information about the purchased items by specifying
lineItems
in your payment request. - Handle the redirect.
- 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 | ![]() |
![]() |
![]() |
Austria | AT | EUR | ![]() |
![]() |
![]() |
Belgium | BE | EUR | ![]() |
![]() |
![]() |
Canada | CA | CAD | ![]() |
![]() |
![]() |
Czech Republic | CZ | CZK | ![]() |
![]() |
![]() |
Denmark | DK | DKK | ![]() |
![]() |
![]() |
Finland | FI | EUR | ![]() |
![]() |
![]() |
France | FR | EUR | ![]() |
![]() |
![]() |
Germany | DE | EUR | ![]() |
![]() |
![]() |
Greece | GR | EUR | ![]() |
![]() |
![]() |
Ireland | IE | EUR | ![]() |
![]() |
![]() |
Italy | IT | EUR | ![]() |
![]() |
![]() |
Norway | NO | NOK | ![]() |
![]() |
![]() |
Poland | PL | PLN | ![]() |
![]() |
![]() |
Portugal | PT | EUR | ![]() |
![]() |
![]() |
Romania | RO | RON | ![]() |
![]() |
![]() |
Spain | ES | EUR | ![]() |
![]() |
![]() |
Sweden | SE | SEK | ![]() |
![]() |
![]() |
Switzerland | CH | CHF | ![]() See note 3 |
![]() See note 3 |
![]() |
The Netherlands | NL | EUR | ![]() |
![]() |
![]() |
United Kingdom | GB | GBP | ![]() |
![]() |
![]() |
United States | US | USD | ![]() |
![]() |
![]() |
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
-
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 Price and product information about the purchased items.
For Klarna to approve the payment, the total amount specified inlineItems
must match theamount.value
, and each line item must include adescription
.