Klarna Docs - Tracking session status

Tracking session status

Each HPP Session is following a state machine to map the Consumer’s action to a certain state, which allows any integrator to act depending on the current state. Integrators have two ways to get the current state, either by reading the HPP Session using an API endpoint or by using the callback mechanism.

Both systems can be used at the same time and it is advised to have a batch running in case there was a loss in communication between systems while the callbacks were sent. As described in the callbacks reference, the callback mechanism will try to reach the integrator system with a retry mechanism, but will stop doing so if your system is not answering after a few times.

All tracking mechanisms can be used in the same way with Klarna Payments and Klarna Checkout.

When integrating with Klarna Payments, as soon as the Consumer gets an authorization, you will be able to extract the Authorization Token of the KP Session from the server response, which will let you place the order. This field is not present in a KCO integration. Please see KP integration guide.

HPP Session Lifecycle

HPP Session lifecycle

Status nameFinalStatus description
WAITINGNoSession is created and Consumer has not entered the Payment Page yet.
IN_PROGRESSNoConsumer has entered the Payment Page on updated_at.
COMPLETEDYesConsumer has successfully gotten an Authorization from the Payment system onupdated_at. TheAuthorization Tokenis contained in theauthorization_tokenfield in a Klarna Payments integration.
FAILEDNoConsumer has been declined for the Payment onupdated_at. Session is still open for them to retry.
CANCELLEDYesConsumer has cancelled the HPP Session onupdated_at. This cancellation is definitive.
BACKNoConsumer has pressed the Back button onupdated_at. Session is still open for them to retry.
ERRORNoConsumer has encountered an error while paying onupdated_at. Session is still open for them to retry.
DISABLEDYesSession was disabled by an API call, on the merchant’s initiative, onupdated_at.

Reading the HPP Session updates by polling an endpoint

The HPP Session can be read by the integrator using a specific endpoint of the API. You will get the URL of the read session endpoint back from the create session call, it is the session_url parameter.

You can for example use a polling mechanism to check the status of the session and update your data depending on the payload. Although we suggest that you use the callbacks mechanism.

See our reference of the Read Session endpoint.

Getting the HPP Session updates by using the callback mechanism

When creating the HPP Session an integrator can pass an URL that will be called by our systems whenever the status of the session is updated. This is really handy to create interaction whenever something happens and avoid to have a costly polling mechanism.

See our reference of the callbacks mechanism.