Klarna Checkout Adapter
Klarna is transitioning from Klarna Checkout (KCO) to Kustom Checkout. While this adapter currently supports Klarna Checkout, merchants should plan for migration to Kustom. See how to migrate to Kustom Checkout for configuration guidance.
Overview
The Klarna Checkout Adapter integrates Klarna Checkout with Norce Checkout, enabling merchants to offer Klarna's comprehensive payment solution within the Norce Commerce platform. Klarna Checkout provides an embedded checkout experience with multiple payment methods including Pay Later (invoice), Pay Now (direct bank transfer, card), and Slice It (financing/installments).
This adapter is part of Norce Checkout (NCO) and handles the complete payment flow from checkout initialization through order completion, including post-purchase operations like capture, cancel, and refund.
The adapter supports two integration modes:
- Klarna Checkout: Full checkout experience with embedded UI (HTML snippet)
- Klarna Payments: Session-based payment authorization for custom checkout flows
Capabilities and Supported Flows
Payment Operations
| Feature | Full | Partial | Notes |
|---|---|---|---|
| Capture | Yes | No | Full order capture only |
| Refund | Yes | No | Supported for fully captured orders only |
| Cancel / Void | Yes | — | Supported in reserved state |
Supported Payment Methods
| Method | Supported | Notes |
|---|---|---|
| One-time Payment | Yes | Standard checkout flow |
| Recurring Payment | Yes | Subscription/tokenized payments |
| Pay Later (Invoice) | Yes | B2C and B2B |
| Pay Now | Yes | Direct bank transfer, Card payments |
| Slice It | Yes | Financing/Installments |
| External Payment Methods | Yes | Configurable redirects to other providers |
Advanced Features
| Feature | Supported | Notes |
|---|---|---|
| B2B Support | Yes | Via allowedCustomerTypes configuration |
| Klarna-Provided Shipping | Yes | Shipping options displayed in iframe |
| Pending Payments | Yes | Handles fraud review states |
| Checkout UI Customization | Yes | Colors, borders, styling via configuration |
| Additional Merchant Terms | Yes | Custom checkboxes and consent collection |
| Merchant Reference Mapping | Yes | Configurable mapping to Klarna references |
| VAT Handling | Yes | Option to hide VAT in order summary |
Limitations:
- Partial capture is not supported
- Partial refund is not supported
- Refund is only available for fully captured orders without existing refunds
- Validation callback always requires success response (configured by adapter)
Configuration Overview
The Klarna Checkout Adapter is configured through Norce Checkout Admin. Key configuration areas include:
Required Settings:
- Klarna API credentials (username, password, API URL)
- Redirect URLs (terms, checkout, confirmation, validation error)
- Shipping countries (ISO alpha-2 codes)
Optional Features:
- Recurring payments for subscription services
- B2B support via
allowedCustomerTypes(person, organization, or both) - Klarna-provided shipping options within the checkout iframe
- External payment methods for additional payment providers
- UI customization (colors, border radius)
- Merchant reference mapping to control how order references appear in Klarna
For detailed configuration instructions and field descriptions, see the Klarna Checkout Adapter Developer Guide.
Links and References
Norce Checkout API References
Klarna Checkout Adapter API
Norce Checkout Overview
- Norce Checkout Introduction
- Working with Norce Checkout
- Payment Adapters Overview
- Klarna Checkout Adapter Developer Guide