Menu

Samenvatting van de Klarna API

De Klarna API's stellen je in staat om BNPL-betalingen, klantkrediet, recurring transacties en after-payments-processen volledig te automatiseren in je webshop, marktplaats of ERP. Hiermee bied je consumenten flexibele betaalmogelijkheden zonder dat je handmatige order- of refund-administratie hoeft te voeren.
  • Web- en mobile-checkout: Maak Payments-sessies, autoriseer transacties en lanceer hosted payment pages voor iDEAL, kaart-, factuur- en termijnbetalingen.
  • Recurring en customer tokens: Sla klanttokens veilig op voor abonnementen, on-demand-charges en one-click-checkout.
  • Order management: Capture, refund, cancel en pas autorisaties aan, voeg verzendinformatie toe en stuur klantcommunicatie aan vanuit je orderflow.
  • Merchant card service: Maak card-promises en settlements voor MCS-merchants en beheer order-cancellations.
  • Settlements: Haal payouts, transactiedetails en payout-summaries (CSV/PDF) op voor je financiële administratie.
  • Disputes: Onboard merchants, lijst geschillen, accepteer verlies, voer representments uit en upload bewijsstukken via de Disputes API v4.
API Quick Facts REST
  • Authenticatie Basic Auth
  • Methods POST (24)GET (23)DELETE (2)PATCH (5)
  • Rate limits Per merchant_id en per operation-categorie, gemeten in requests per seconde; bij overschrijding volgt HTTP 429 met X-Ratelimit-headers
  • Webhooks Beschikbaar
  • Sandbox Beschikbaar
  • Response format JSON
  • Versionering URL-based

Laatste ontwikkelingen bij de Klarna API

Klarna begon in 2005 als Zweedse factuurbetaler en bouwde rond 2014 zijn eerste publieke REST API's voor Payments en Checkout. Vanaf 2018 verschenen Hosted Payment Page, Customer Token voor recurring en de Order Management API v1 als gemeenschappelijke after-payments-laag. In 2021 lanceerde Klarna de Merchant Card Service voor card-on-file-flows, in 2023 volgde Disputes v4 als REST-vervanger van de oudere v1/v2/v3-API's, en in 2025 werd Klarna Checkout V3 in Europa uitgefaseerd ten gunste van Kustom Checkout en de Payments-flows. De server-side SDK's (PHP, Java, .NET, Python) zijn deprecated; integratie gaat nu direct via REST of de mobile SDK's.

API versies

Klarna Checkout V3 (EU) uitgefaseerd Major release
31 maart 2025

Klarna Checkout V3 is in Europa uitgefaseerd; nieuwe integraties gebruiken Klarna Payments, Hosted Payment Page of Kustom Checkout.

Disputes API v4 Major release

REST-opvolger van Disputes v1/v2/v3 met endpoints voor merchant-enrollment, dispute-listing, representment, appeal en attachment-uploads.

Merchant Card Service v3 Major release

API voor card-promises, settlements en order-cancellations voor MCS-merchants.

Order Management API v1 Major release

Gemeenschappelijke after-payments-laag voor view, update, capture, refund, cancel en authorization-management van Klarna-orders.

Customer Token API v1 Major release

Recurring-flow waarmee je tokens leest, orders aanmaakt op basis van een token en de token-status bijwerkt.

Hosted Payment Page API v1 Major release

API voor het aanmaken, ophalen, distribueren en uitschakelen van hosted payment page-sessies voor mobiele en redirect-flows.

Klarna Payments API v1 Major release

Hoofdintegratie voor Klarna BNPL-, factuur- en directe betaalmethoden met sessies, autorisaties, orders en customer tokens.