This page explains how to add Klarna to your existing Android Components integration.
This page is for v5.0.0, released in October 2023. If you are using an earlier version, use the guide for earlier versions instead.
Requirements
Select the server-side flow that your integration uses:
API reference
Klarna Configuration
Test and go live
Before accepting live payments, test your integration using the test environment and sample data provided by Klarna.
You can then check the status of Klarna test payments in your Customer Area > Payments > Payment list.
Before you go live
Make sure that:
- You have added Klarna in your live Customer Area.
- You have considered Klarna's legal and privacy information.
- You follow the Klarna guidelines on how to present Klarna in your checkout.
- The invoice lines and VAT are shown correctly on Klarna's pages.
- If a shopper gets rejected by Klarna, you offer them another payment method.
- You pass the shopper's name and address in your payment request. This is optional, but providing these parameters improves the shopper experience and increases conversion rates.
Testing in live environment
When testing Klarna payments in the live environment, make sure that you:
- Provide real shopper data. For example, your real name, personal email, personal mobile, and home and billing address. Do not provide a company address as billing address.
- Choose an item with a reasonable amount that meets Klarna's minimum requirements. For example, for Pay over time, Klarna requires a minimum amount of GBP 1. Klarna can reject a request if the product is too expensive and they do not have enough transaction history for the shopper.
- Do not do multiple tests in a short period from the same device or IP address. Otherwise, velocity rule checks are triggered, which will lead to the transaction being rejected.
If the conditions above are not met, you can receive a resultCode of Refused. The shopper sees a page with an "Option Not Available" message instead of the Klarna Payments widget. Note that these checks are bypassed in test and are only applied in the live environment.
See Klarna raw acquirer responses for the most common responses for successful, refused, failed, or cancelled transactions.