On-site messaging API integration

• OSM is already activated for your e-store. How to activate OSM?. 
• OSM API access is enabled for your e-store. The API is not activated by default, you need to request access. Please reach out to your Klarna account manager. Otherwise the OSM API backend will return a 403 - Forbidden response.

To display OSM ads on your application follow these steps:

Get your client-id from the On-site messaging section in the Klarna Merchant Portal (if you don't have access to Merchant Portal please ask your account manager for it). This client-id is used by OSM to identify your e-store in multiple regions.

You will need to make https GET call to OSM API, how this is done depends on your programming language of choice.

https://api.playground.klarna.com/messaging/v3?client_id=<client_id>&placement_key=<placement_key>&locale=<locale>&purchase_amount=<purchase_amount

The endpoints different per environment, make sure you are calling the right endpoint:

Testing (playground)

• Europe: https://api.playground.klarna.com/messaging/v3
• North America: https://api-na.playground.klarna.com/messaging/v3
• Oceania: https://api-oc.playground.klarna.com/messaging/v3

Production

• Europe: https://api.klarna.com/messaging/v3
• North America: https://api-na.klarna.com/messaging/v3
• Oceania: https://api-oc.klarna.com/messaging/v3

The endpoint response will look like:

{
 "content": {
   "nodes": [
     {
       "type": "TEXT",
       "name": "TEXT_MAIN",
       "value": "Make 4 payments of $128.67. No fees."
     },
     {
       "type": "ACTION",

You can now use the content payload inside the response to render the ad using the language or framework of your choice. For examples on how placements might look, see below.

As per IAB definition: “An impression is a measurement of responses from an ad delivery system to an ad request from the user's browser, which is filtered from robotic activity and is recorded at a point as late as possible in the process of delivery of the creative material to the user's browser — therefore closest to actual opportunity to see by the user”.

There are multiple ways of making this call:

• On the web: Through a web beacon by creating an <img> tag and using the impression_url as the source of the image. This will generate a call to our servers and the impression will be recorded.
• If a web beacon can’t be created you can trigger a HTTP GET call from your application. This call can originate from the frontend or backend of your application.
  
  The impression event endpoint will return a 2XX response status code.

The endpoint will return a cache-control header that you should honor when possible. In the case of a web integration frontend-side, this header will be handled by the browser. On mobile or backend integrations that will depend on the characteristics of the platform.

When using credit-promotion placements on product pages, the case when the product/s purchase amount changes must be handled by the integrator. 

Whenever the purchase amount changes, a new request to the endpoint must be made to refresh the messaging according to the new purchase amount, the ad should be re-render and a new impression event registered.