Integrating Klarna
Auth: API key · Partner program: not required · Setup time: about 15 minutes · Last verified: 2026-05-15
BNPL leader across EMEA + US — Pay Now, Pay in 30, Pay in 4, and Financing. Klarna routes API traffic to regional clusters (api.klarna.com, api-na.klarna.com, api-oc.klarna.com), each with its own playground host. Pick the region your Merchant Portal API keys belong to.
Auth model
Section titled “Auth model”
rawis opt-in. The upstream payload is withheld unless an operator enablesdata_store.raw_payload.paymentsin Admin → Settings → Data store. It is off by default because across the payments adapters it declares bank account numbers, IBANs and card numbers the canonical schema does not expose.
HTTP Basic, username + password from the Klarna Merchant Portal under Settings → API credentials. Submit via the Connect Link form along with the region.
Required adapter quirks
Section titled “Required adapter quirks”- Installments live outside the canonical schema. Klarna’s order carries the full instalment schedule + APR; the canonical
Charge.amountexposes the principal only. Consumers who need instalments must drop down toCharge.raw. - No bulk-list endpoint. Klarna doesn’t expose
GET /ordersover its merchant API. The adapter surfaces orders via webhooks plusgetChargebyorder_id. - Partial captures map to
Charge.status = 'partially_refunded'(the canonical schema lacks a dedicatedpartially_capturedstate).
Webhooks
Section titled “Webhooks”Configure under Push notification URLs on each merchant ID. HMAC-SHA-256 of the raw body keyed with the shared secret, hex-encoded in Klarna-Signature.
References
Section titled “References”- API reference: https://docs.klarna.com/api/
- Order Management: https://docs.klarna.com/api/ordermanagement/
- Klarna docs home: https://docs.klarna.com/
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.