Klarna

Accept Klarna payments globally with pay now, pay later, and financing options through a single redirect-based Solidgate integration

Payment typeWallet

Payment flowRedirect

Checkout

Integration type	API v1
	Payment Form
	Payment Page
	Payment Link

Coverage

Countries	Global AT, AU, BE, CA, CH, CZ, DE, DK, ES, FI, FR, GB, GR, HU, IE, IT, MX, NL, NO, NZ, PL, PT, RO, SE, SK, US
Currencies	AUD, NZD, EUR, CZK, DKK, HUF, NOK, PLN, RON, SEK, CHF, GBP, MXN, CAD, USD *use the local currency for the selected purchase country.
Min amount	0.01 Applies per currency specifics.
Max amount	Depends on market and payment option

Capabilities

Recurring	Yes
Refund	Yes
Partial refunds	Yes
Multiple partial refunds	Yes
Chargeback	Yes

Klarna is a global technology company operating a unified payment network that lets consumers choose how they pay at checkout: Pay in Full, Pay in 30 Days, Pay in N (3 or 4), or Financing, based on eligibility. Through Solidgate's integration with Klarna, merchants can accept Klarna without a direct commercial relationship with Klarna.

Integrating Klarna through Solidgate drives higher conversion. Flexible payment options reduce cart abandonment and checkout friction, while expanded purchasing power helps customers manage cash flow and increase average order values. Klarna assesses each transaction using its own risk and eligibility models. Onboarding is simplified, with Solidgate managing the merchant onboarding process via Klarna.

Klarna is available through Solidgate's integration with Klarna. No direct commercial relationship with Klarna is required.

Contact Solidgate
Reach out to your Solidgate account manager or contact us to launch Klarna.
Complete onboarding
Solidgate collects the required business and compliance information. Klarna may request additional documentation for compliance screening.
Integrate
Implement Klarna using the API, Payment Form, Payment Page, or Payment Link.
Run end-to-end testing
Validate the full payment flow during testing before going live.
Go live
Solidgate enables the production environment once testing is verified.

Principle of operation

Implementations aligned with Klarna's technical standards typically deliver ~20% higher checkout conversion, ~40% larger AOV, and ~46% higher repeat purchase frequency.

One-time

Selection at checkout
Customer selects Klarna as the payment method at checkout.
Payment initiation
Merchant sends a payment request to Solidgate. Solidgate returns a redirect URL in pay_form.return_url . Use this parameter to inject it into the Klarna Web SDK, which initiates a Klarna Customer Journey.
Redirect to Klarna
Customer is redirected to Klarna's hosted payment page and selects a preferred payment option based on eligibility. Options may include Pay in Full, Pay in 30 Days, Pay in N (3 or 4), or Financing.
Authentication and authorization
Customer authenticates with Klarna. Klarna evaluates eligibility for the selected payment option and authorizes the payment.
Capture
Solidgate auto-captures the payment upon Klarna authorization. No separate capture request is required.
Merchant notification
Merchant receives a notification Webhook confirming the order status.

Recurring

Selection at checkout
Customer selects Klarna as the payment method and initiates mandate authorization.
Payment initiation
Merchant sends a payment request to Solidgate with future_usage.payment_type recurring , along with the applicable recurring parameters. Solidgate returns a redirect URL in pay_form.return_url . Use this parameter to inject it into the Klarna Web SDK, which initiates a Klarna Customer Journey.
Redirect to Klarna
Customer is redirected to Klarna's hosted payment page, where they authorize the initial payment and the recurring mandate terms.
Mandate authorization
Klarna evaluates the customer's eligibility and authorizes the mandate. A mandate token is issued for subsequent charges.
Capture
Solidgate auto-captures the initial payment upon authorization.
Merchant notification
Merchant receives a notification Webhook with the mandate token for subsequent recurring payments.

Subsequent recurring charges are merchant-initiated via the recurring API v1 endpoint and do not require customer interaction. Manage tokens and follow-up charges in Manage APMs.

Klarna payment method selection at checkout

Transaction lifecycle

Klarna is an asynchronous payment method. Webhook notifications are sent on each status transition. Use the order.status field in the webhook payload to track the current payment state. Use the webhook as the source of truth.

Order status	Description
processing	Payment initiated. Customer redirected to Klarna's hosted page. Awaiting customer authorization.
approved	Klarna authorized the payment. Solidgate auto-captured. Funds are being settled.
declined	Customer did not complete authorization, or Klarna declined the payment.
refunded	Full or partial refund processed.

Integration

Klarna can be integrated via the following approaches. Choose based on how much control you need over the checkout UI.

H2H (API)

Redirect logic Merchant-managed

Klarna display in checkout

Klarna Web SDK (in-page pop-up)

Payment Presentation API (full redirect to Klarna)

Setup effort

High

Medium

UI control

Full

Payment Form

Redirect logic Handled by Solidgate

Klarna display in checkout Handled by Solidgate

Setup effort Medium

UI control Standard

Payment Page / Link

Redirect logic Handled by Solidgate

Klarna display in checkout Handled by Solidgate

Setup effort Low

UI control Standard

H2H integration

In the H2H flow, your backend sends the init payment API v1 request to Solidgate and receives a Klarna redirect URL. All backend operations are performed by Solidgate. Your frontend is responsible for displaying Klarna as a payment option and initiating the redirect after receiving the response from Solidgate. Final payment status is delivered via webhooks.

Display Klarna in your checkout using the Klarna Web SDK Reference or Payment Presentation API Reference .
When the customer selects Klarna and proceeds, send the init payment request to Solidgate.
Include payment_type_data.klarna_network_session_token in the request, obtained from Klarna Web SDK. Optionally, pass payment_type_data.klarna_network_data to provide supplementary Klarna SDK session state when extended session continuity is required.
Solidgate returns pay_form.return_url (the Klarna redirect URL).
Inject pay_form.return_url into the Klarna Web SDK to initiate the Klarna authorisation flow. When using the Payment Presentation API, redirect the customer to pay_form.return_url instead.
Klarna handles the payment UI on its hosted page and redirects the customer back to your return_url on completion.

Correct Klarna Web SDK implementation is critical in H2H integrations. Solidgate does not control the Klarna Web SDK. The merchant is responsible for configuring how the customer returns from the Klarna Customer Journey to ensure correct payment finalisation by Solidgate before going live. We highly recommend implementing the final redirect to return_url for faster, reliable finalization.

Payment Form

Payment Form embeds Solidgate's checkout widget directly into your existing checkout page. Your page structure, branding, and surrounding UI remain fully under your control. The form occupies a defined area within your flow.

Klarna's redirect and UI are handled internally by Solidgate. No separate redirect logic is required on your side.

You own your page layout, the surrounding checkout experience, and when or how the form is initialised. Solidgate owns Klarna display, redirect to Klarna's hosted page, and payment state handling.

This path requires frontend integration work. You embed the widget, initialise it with a session token, and handle payment completion callbacks. It is suitable for merchants who want to keep customers within their own checkout environment without building a full H2H integration.

Optionally, if you use Klarna boost features (Express Checkout, Sign in with Klarna, On-Site Messaging), pass payment_type_data.klarna_network_data to provide supplementary Klarna SDK session state for extended session continuity.

Configure the Klarna button on Payment Form.

Payment Page / Payment Link

Payment Page and Payment Link are fully hosted by Solidgate. Your customer leaves your site and completes the payment on a Solidgate-hosted page. You have no control over the checkout UI.

Payment Page

Integrated via a redirect from your backend. Generate the payment session, receive a hosted page URL, and redirect the customer to it. Use Payment Page for hosted checkout configuration.

Payment Link

Requires no code integration. Generate a shareable URL via Hub or API and send it to the customer directly by email, messenger, or any other channel. No checkout page is needed on your side. Use Payment Link for shareable URL setup.

Both options require minimal development effort. They are best suited for merchants who prioritise speed of launch, operate without a dedicated checkout page, or need a no-code payment collection option.

Klarna Web SDK & Payment Presentation API

The Klarna Web SDK Reference is required for H2H integrations to render Klarna in the checkout. It is also recommended for Payment Form and Payment Page to enable session continuity and pre-filled customer details. It powers Klarna boost features such as Express Checkout, On-Site Messaging, and Sign in with Klarna.

For H2H integrations, you can also use the Payment Presentation API Reference instead of the Klarna Web SDK. It retrieves Klarna's dynamically generated checkout elements, including logo, header, messaging, and payment button. These adapt automatically to the customer's locale, transaction amount, and eligible payment options. This integration path requires Klarna API credentials that can be created and retrieved from Klarna Portal.

Do not hardcode Klarna logos, text, or messaging. All elements must be retrieved dynamically via the API.

Klarna presentation

Branding

Klarna has specific requirements for how it must be presented in your checkout. These apply only to H2H integration. Merchants using Payment Form, Payment Page, or Payment Link inherit a compliant UX out of the box.

Klarna branding follows the Present Klarna in the checkout Reference guidelines, including brand assets and design rules.

Payment method category

Group Klarna under Wallet or Mobile payment. Do not place it under “Installment payments” or “Buy now, pay later.” Klarna offers a full suite of payment solutions including pay now, pay later, and financing.

Logo

Always retrieve the Klarna logo dynamically. Do not use static copies. Three variants are available. Badge is recommended and is ideal for displaying the full Klarna logo when space allows. Square fits constrained layouts with a 1:1 aspect ratio. Rectangle fits layouts with a 2:3 aspect ratio.

Headers and messages

All headers, subheaders, and messages must be retrieved dynamically and adjust automatically to the customer's locale, transaction details, and available payment options. Messages surface pre-qualification status, deals, or 0% financing campaigns when applicable. Do not hardcode payment option names or promotional copy.

Payment button

Once Klarna is selected, the payment button updates to display “Continue with Klarna” with the Klarna badge. Dark and light themes are available to match your checkout background. Rounded and square button styles are supported. Minimum button height is 40px (48px recommended). Minimum width is 160px. Match the width of other payment buttons in stacked layouts.

Checkout layout

Two layout variants are supported depending on your checkout flow.

Selector with CTA

The customer selects Klarna via radio button and confirms with a dedicated button. The subheader is shown before selection. The message is revealed after.

Selector without CTA

Checkout navigates directly after payment selection. A short description is shown before selection. A dynamically generated subheader appears after.

Pre-selection

Klarna's pre-selection behaviour depends on the customer's prior interaction.

With no prior interaction, Klarna appears as a standard payment option and respects your payment method ordering. When the customer is pre-qualified via On-Site Messaging or Express Checkout, they have already shown clear intent to pay with Klarna. Show only Klarna and collapse all other payment options. When the customer is authenticated via Sign in with Klarna, Klarna recognises them. Pre-select Klarna and list it first to maximise conversion.

Boost features

Klarna offers conversion-optimising features available through the Solidgate integration. Full documentation and implementation guides are in the Perfect Customer Journey Reference guide.

Express checkout

Pre-fills shipping and billing details for returning Klarna customers, reducing checkout steps and accelerating purchase completion. Requires the Klarna Web SDK and a valid klarna_network_session_token passed in the payment request.

On-site messaging

Displays Klarna payment option messaging (for example, “Pay in 3 installments from €X/month”) on product and cart pages before the customer reaches checkout. Configured through the Klarna Web SDK independently of the payment request.

Allows returning Klarna customers to authenticate with their Klarna account at checkout, enabling personalized payment options and pre-filled details. Configured through the Klarna Web SDK.

Partner portal

You can also use Klarna Partner Portal for Klarna Disputes, including Klarna Disputes Handling. You can learn more about Klarna Dispute Management Reference .

Data specifications

One-time

Required fields

payment_method , order_id , order_description , currency , amount , customer_email , ip_address , billing_address.country , platform , item_category

Optional fields

billing_address.state , billing_address.city , billing_address.zip_code , payment_type_data.klarna_network_session_token , payment_type_data.klarna_network_data , payment_type_data.klarna_originators

Conditional fields

Request

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "payment_method": "klarna-network",
    "order_id": "order_kln_001",
    "order_description": "Order #kln_001",
    "currency": "EUR",
    "amount": 9900,
    "customer_email": "buyer@example.com",
    "customer_first_name": "Emma",
    "customer_last_name": "Johansson",
    "customer_phone": "+46701234567",
    "ip_address": "82.115.34.21",
    "billing_address":
    {
        "country": "SWE",
        "city": "Stockholm",
        "zip_code": "111 57"
    },
    "platform": "WEB",
    "item_category": "digital_goods",
    "future_usage":
    {
        "payment_type": "one-time"
    }
}

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

{
    "order":
    {
        "amount": 9900,
        "currency": "EUR",
        "order_id": "order_kln_001",
        "status": "processing",
        "method": "klarna-network",
        "customer_email": "buyer@example.com",
        "ip_address": "82.115.34.21",
        "order_description": "Order #kln_001",
        "created_at": "2026-05-19 10:31:44",
        "updated_at": "2026-05-19 10:31:44"
    },
    "pay_form":
    {
        "token": "pft1ymnx6gq32ej3dvr9p45w",
        "return_url": "https://pay.klarna.com/eu/payments/...",
        "script_url": ""
    },
    "transactions":
    []
}

Recurring

Required fields

payment_method , order_id , order_description , currency , amount , customer_email , ip_address , billing_address.country , platform , item_category

Optional fields

billing_address.state , billing_address.city , billing_address.zip_code , payment_type_data.klarna_network_session_token , payment_type_data.klarna_network_data , payment_type_data.klarna_originators

Conditional fields

Required when item_category is physical_goods : customer_first_name , customer_last_name , customer_phone , shipping_address .
Required when no product_id or product_price_id is provided: future_usage.payment_type recurring , future_usage.billing_amount , future_usage.billing_period.unit , future_usage.billing_period.value

Request

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

{
    "payment_method": "klarna-network",
    "order_id": "order_kln_rec_001",
    "order_description": "Monthly subscription",
    "currency": "EUR",
    "amount": 9900,
    "customer_email": "buyer@example.com",
    "customer_first_name": "Emma",
    "customer_last_name": "Johansson",
    "customer_phone": "+46701234567",
    "ip_address": "82.115.34.21",
    "billing_address":
    {
        "country": "SWE",
        "city": "Stockholm",
        "zip_code": "111 57"
    },
    "platform": "WEB",
    "item_category": "digital_goods",
    "future_usage":
    {
        "payment_type": "recurring",
        "billing_amount": 9900,
        "billing_period":
        {
            "unit": "month",
            "value": 1
        }
    }
}

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

{
    "order":
    {
        "amount": 9900,
        "currency": "EUR",
        "order_id": "order_kln_rec_001",
        "status": "processing",
        "method": "klarna-network",
        "customer_email": "buyer@example.com",
        "ip_address": "82.115.34.21",
        "order_description": "Monthly subscription",
        "created_at": "2026-05-19 10:31:44",
        "updated_at": "2026-05-19 10:31:44"
    },
    "pay_form":
    {
        "token": "pft2abc7xyz9mnop4qrs1tuv",
        "return_url": "https://pay.klarna.com/eu/payments/...",
        "script_url": ""
    },
    "transactions":
    []
}

Klarna payment options

Klarna dynamically presents payment options based on the customer's eligibility and the merchant's Klarna payment program configuration. Options may include Pay in Full, Pay in 30 Days, Pay in N (3 or 4), and Financing. The set of options shown to a given customer is determined by Klarna at the time of authorisation.

Merchants cannot pre-select or restrict specific Klarna payment options shown to customers via the Solidgate API . Klarna's eligibility engine controls which options are shown to each customer. Merchants can configure which payment options will be enabled for customers on their Klarna Account via Klarna partner portal.

Auto-capture

Solidgate automatically captures the payment upon Klarna authorisation. No separate capture request is required. The order moves to approved status once capture is confirmed.

Recurring

Billing amount

future_usage.billing_amount sets the amount in minor units to be charged in each subsequent recurring payment. It must match the billing plan the customer agrees to at mandate creation. It is separate from the initial charge amount and can differ.

Subscription terms

Display recurring mandate terms clearly at checkout before the customer is redirected to Klarna. Include the recurring charge amount and billing frequency. When initiating subsequent recurring payments, strictly follow the future_usage.billing_period agreed at mandate creation. The customer also reviews these terms on Klarna's hosted page, but surfacing them at checkout reduces friction and dispute rates. In case of a subscription payment, provide a clear and concise order_description that describes the product of the subscription. It is highly important and will affect the customer experience at the Klarna Customer Journey.

Trials

Klarna supports subscription initiation with a free or paid trial. You can use Solidgate products for these scenarios.

Recurring token usage

Klarna issues a recurring token strictly tied to the initial payment. Subsequent charges can be processed only via recurring_token . Recurring charges against a product are not supported.

Error codes

Specific errors may occur when a Klarna payment attempt fails.

Solidgate error	Description
Guide The general group of declines. The card-issuing bank did not complete the transaction successfully. 0.01 General decline	Klarna or the customer's bank declined the transaction. Causes can include insufficient funds, Klarna's risk assessment, or the bank blocking the charge.
Guide This error indicates an issue with the provided data format. 2.01 Invalid data	The decline may be related to an invalid or incorrectly formatted payer identification document. Retry the transaction and verify that the document number is correct and matches the required format.
Guide The payment was not completed within the allocated timeframe, leading to order expiration. 0.02 Order expired	The customer did not complete authorization within Klarna's session time limit.

Testing

Use Solidgate's test environment to validate the Klarna integration before going live. Test API keys are available in the Solidgate Hub under Settings → API keys.

One-time completed

Steps	Send init payment with future_usage.payment_type one-time . Redirect to pay_form.return_url . Complete authorization in Klarna's test environment.
Expected result	order.status processing on init payment response. pay_form.return_url present. After customer completes authorization: approved . Webhook received with status approved.

One-time abandoned

Steps	Send init payment. Redirect to pay_form.return_url . Navigate away without completing authorization.
Expected result	order.status declined . Webhook received with error.

Recurring mandate

Steps	Send init payment with future_usage.payment_type recurring and billing parameters. Complete mandate authorization.
Expected result	processing on init payment response. After authorization: approved . Webhook received with mandate token for subsequent charges.

Recurring charge

Steps	Submit charge using mandate token from the previous step via the recurring API v1 endpoint.
Expected result	order.status approved . Webhook received.

Full refund

Steps	Submit refund for full captured amount via Refund API v1 .
Expected result	Order status transitions to refunded . Webhook received.

Partial refund

Steps	Submit refund for partial amount via Refund API v1 .
Expected result	Refund transaction created. Additional partial refunds can be submitted up to the captured amount.

Looking for help? Contact us

Stay informed with Changelog