Display the QR code and monitor the distribution status

To share the QR code that the customer will scan in-store and to monitor the distribution status, you have to get the distribution result from Klarna. You can do so in one of two ways:

• Use polling
• Subscribe to a webhook notification

To get the distribution result from Klarna, send an empty request body to the result endpoint.
Link to result endpoint is included in distribution.result_url field in session initiation response.

Success response parameters

 {
       “status”: “FAILED” 
       “error”: {  // mandatory if status = FAILED
           “code” : “INTERNAL_ERROR” 
       }    
 }

The distribution statuses change when an action is performed either by you, the customer, or by the system.

Below is a list of all possible distribution statuses, along with actions you can take for each.

If you have provided a URL endpoint when initiating the payment session, you'll get the distribution status updates via a webhook notification instead of having to poll the server for status updates.

Securing the webhooks

The URL provided as the status_update parameter must use HTTPS, but to be able to authenticate that the notification comes from Klarna, we recommend you generate a one-time token that you'll only use for this specific In-store payment session.

    "distribution": {
        "method": "qr",
        "callback_urls": {
         "status_update": "https://example.com/statsCallbackEndpoint?klarnaId={klarna_session_id}&secretToken=7d1cbc3b-b30c-4be2-a8c4-dc76482d7bf6"
        }
   }
}

For extra security, when you get a webhook notification and the distribution status is COMPLETED, send a GET request to the distribution result endpoint. This lets you validate if the notification of the status update was sent by Klarna.

The webhook sends the distribution result payload for the following distribution status changes:

Once you share the QR code with the customer, they can pay. Once the payment is completed, a new order gets created in Klarna's systems.
A message is displayed to the customer informing them that the payment is done. The module page displays the payment status.

The new order is automatically placed and captured. You can retrieve the order identifier from the distribution result URL specified when creating the payment session.

If you've provided the distribution webhook URL as the callback_url parameter, you'll get the order identifier via a webhook notification.

  {
    "status": "COMPLETED" 
    "order_id": "588314f6-dd10-11ed-afa1-0242ac120002",
    "klarna_reference": "XDC23412"
  }