Klarna
| Feature | Description |
|---|---|
| Payment Logo | |
| Integration Methods |
|
| Recommended Regions | ViewAustria, Belgium, Czech Republic, Denmark, Finland, Ireland Poland, Romania, Spain, Sweden, United Kingdom, France, Germany , Greece, Italy, Netherlands, Norway, Portugal, Switzerland, United States, Hungary |
| Virtual Industry Support | ✅ |
| Subscription Support | ✅ |
| Supported SaaS |
|
| Supported Open-Source Platforms |
|
Payment Method Display Name
Klarna requires all merchants to display official Klarna-approved payment method names on the checkout page.
If your website allows customization of payment method names, ensure that the checkout page displays the appropriate Klarna payment descriptor according to the customer's billing country:
| Market | Billing Country(billing_country) | Language | Payment Descriptor |
|---|---|---|---|
| Austria | AT |
|
|
| Belgium | BE |
|
|
| Czech Republic | CZ |
|
|
| Denmark | DK |
|
|
| Finland | FI |
|
|
| France | FR |
|
|
| Germany | DE |
|
|
| Greece | GR |
|
|
| Hungary | HU |
|
|
| lreland | IE |
|
|
| Italy | IT |
|
|
| Netherlands | NL |
|
|
| Norway | NO |
|
|
| Poland | PL |
|
|
| Portugal | PT |
|
|
| Romania | RO |
|
|
| Slovakia | SK |
|
|
| Spain | ES |
|
|
| Sweden | SE |
|
|
| Switzerland | CH |
|
|
| United Kingdom | GB |
|
|
| United States | US |
|
|
Product Information
When using Klarna payments, merchants are required to submit detailed product information of the order to Klarna via the itemList field. This field is used by Klarna for risk assessment, installment calculation, billing display, and compliance validation. Therefore, the itemList parameter must be provided strictly in accordance with Klarna’s field requirements.
Subscription Feature
The Klarna subscription feature allows merchants to automatically charge subsequent payments based on a predefined billing cycle after the customer completes the initial authorization. This feature is suitable for recurring billing scenarios such as membership services, SaaS products, and content subscriptions.
Authorization and Capture Rules
- Klarna payments are placed in an authorized but not captured status once pre-authorization is completed.
- Merchants must complete the capture within 28 days of the authorization. If the payment is not captured within 28 days, the authorization will automatically expire.
Automatic Capture of Klarna Payments (Auto Capture)
Automatic Capture (Auto Capture) refers to the process in which Oceanpayment automatically initiates the capture after a Klarna payment has been successfully authorized. This feature is not enabled by default. Please contact Oceanpayment support to request activation.
Manual Capture of Klarna Payments (Manual Capture)
Manual Capture (Manual Capture) refers to the process in which the merchant manually initiates the capture after a Klarna payment has been successfully authorized, rather than capturing the payment automatically upon authorization.
Status Description
After a Klarna payment enters the authorization stage:
- The payment status will be marked as Pending:
payment_status = -1
- The payment authorization type will be identified as Authorization:
payment_authType = 1
Initiate Capture / Void
For Klarna orders that have entered the authorization stage, you may manually initiate Capture or Void through the Oceanpayment Authorization feature. Once the authorization or cancellation is completed, the result will trigger the asynchronous notification again.
On-site Messaging
Klarna On-site Messaging is a solution that enables merchants to display tailored Klarna payment messaging on their website or mobile app before the customer reaches checkout. It helps inform shoppers about Klarna’s flexible payment options early in the purchase journey, which can boost conversion and engagement.
What it Does
- Displays messages about Klarna payment options (e.g., pay later, installment plans) on product pages, cart pages, or sitewide.
- Offers dynamic content based on purchase amount, available payment methods and locale.
- Helps customers understand what Klarna is and how it works before checkout.
Integration Method
- Integrate directly into the website frontend using APIs. Merchants are required to obtain the
data-client-idfrom Oceanpayment, which is used to initialize and load the corresponding payment or messaging components on the frontend.
<script
async
data-environment="production"
src="https://js.klarna.com/web-sdk/v1/klarna.js"
data-client-id="{{ your data-client-id }}"
></script>
<klarna-placement
data-key="credit-promotion-badge"
data-locale="en-US"
data-purchase-amount="{{ product.price }}"
></klarna-placement>
- Platform Plugins: Quick integration is supported via platform plugins for major e-commerce platforms such as Shopify, Shoplazza, and Shopline. For more details, please refer to the supported platforms.
Sample Test Data
Select a country to view the sample data you can use to test Klarna.