Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Klarna

Klarna Push Notifications

Outbound HTTP POST callbacks Klarna issues to merchant-hosted URLs for Payments authorization, HPP status updates, Checkout push, and pending-order risk decisions.

Documentation Provider Profile APIs.io AsyncAPI GitHub

This event API exposes 4 operations across 4 channels, and defines 8 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.0.

The API connects through a single server, {merchantBaseUrl} (https).

4 operations 4 channels 8 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0.0
Base URL
https://merchant.example.com
Contact
Klarna Merchant Support
License
Klarna Developer Terms
Resource Areas
1

Channels & Operations 4

Across 4 channels, the API surfaces 4 operations. Each is listed below with its action, channel, parameters, and response codes.

Channels 4
PUB
payments/authorization-callback
Receive a Klarna Payments authorization callback
receivePaymentsAuthorizationCallback body
PUB
payments/hpp-status-update
Receive an HPP session status update
receiveHppStatusUpdate body
PUB
checkout/push
Receive a Klarna Checkout completion push
receiveCheckoutPush body
PUB
payments/pending-order-notification
Receive a pending-order risk decision
receivePendingOrderNotification body

Messages & Schemas 8

The contract defines 8 schemas that model the data carried by its messages. The most detailed are HppStatusUpdatePayload (2 properties), PaymentsAuthorizationPayload (2 properties), PendingOrderNotificationPayload (2 properties). Each schema is shown below with its type and property counts.

PaymentsAuthorization
message
Delivered after Klarna Payments authorizes a session.
HppStatusUpdate
message
Delivered when a Hosted Payment Page session changes state.
CheckoutPush
message
Delivered when a Klarna Checkout order is completed.
PendingOrderNotification
message
Delivered when a PENDING order receives a final risk decision.
PaymentsAuthorizationPayload
object
JSON body POSTed to merchanturls.authorization for Klarna Payments.
2 properties 2 required
HppStatusUpdatePayload
object
JSON body POSTed to merchanturls.statusupdate for Hosted Payment Page sessions. The session object mirrors the read-session response.
2 properties 2 required
CheckoutPushPayload
object
Body posted to merchanturls.push for a completed Klarna Checkout order. Klarna's public documentation describes this surface as a notification-only POST; the K…
PendingOrderNotificationPayload
object
Body posted to merchanturls.notification once a PENDING order has been finally assessed. The exact field set is determined by Klarna at delivery time; the merc…
2 properties

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

klarna-push-notifications-asyncapi.yml Raw ↑
#Webhooks#Push Notifications#Callbacks#Events
← Back to K APIs
API Details
ID
klarna:klarna-push-notifications
Base URL
https://merchant.example.com
Docs
https://docs.klarna.com/
Provider
Klarna
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network