NORCE CHECKOUT

PAYMENT ADAPTERS

Hook

Norce Checkout - Klarna Checkout Adapter API (0.2.2)

Build 2026-01-12 09:48:20

The Klarna Checkout Adapter API is used to create and manage a Klarna Checkout Order.

Download OpenAPI description

klarna-adapter.json

klarna-adapter.yaml

Servers

Test server

https://checkout-klarna-adapter.test.norce.tech/

Schemas

Error

codestring

Error code

Enum"internal-server-error""unauthorized""configuration-error""configuration-not-found""order-not-found""order-error""order-bad-request""order-conflict""shipping-not-found""shipping-error"

Example: "cart-not-found"

messagestring

Detailed error information

Example: "Cart with id:{id} now found."

klarnaErrorobject

Error if originating from Klarna

{
  "code": "cart-not-found",
  "message": "Cart with id:{id} now found.",
  "klarnaError": {
    "errorCode": "string",
    "errorMessages": [ … ],
    "correlationId": "string"
  }
}

Hook

idstringread-only

Unique ID for the callback.

Example: "oc_BaDIudFOjBEuFmLlmDExePUFTh"

adapterIdstring

Callback Adapter ID.

Example: "jetshop_adapter"

subscribeTostring

Callback event.

targetstring

Callback event.

invokestring

Full valid url to be called by POST. If the url contains the substring '{order_id}' it will be replaced with the orders id before call is performed.

Example: "http://specific-feature-adapter.norce.io/api/v1/callbacks/orders/{order_id}/specific-callback"

{
  "id": "oc_BaDIudFOjBEuFmLlmDExePUFTh",
  "adapterId": "jetshop_adapter",
  "subscribeTo": "string",
  "target": "string",
  "invoke": "http://specific-feature-adapter.norce.io/api/v1/callbacks/orders/{order_id}/specific-callback"
}

Item

idstring

Unique identifier for the order

Example: "ci_FpEzyBvBBUyKxkeNriFUxZOCje"

referencestring

Optional. Platform cart item reference.

namestring

Descriptive name of the item.

Example: "T-Shirt XL"

skustring

SKU or article number.

Example: "A000123"

productTypestring

Type of product.

Enum"physical""digital""giftCard""bundle"

itemsArray of objects(Item)

Child Items of the item.

urlstring

URL to the product page.

Example: "https://example.com/products/A000123"

imageUrlstring

URL to an image showing the item.

Example: "https://example.com/products/A000123/images/1"

quantityinteger(int32)

Quantity of the item.

Example: 2

unitstring

Unit used to describe the quantity. Ex. st, kg

Example: "st"

priceobject

Unit price, excluding discount

totalobject

Total sum for all quantities including discount.

originalTotalobject

Total sum for all quantities excluding discount.

vatRatenumber(double)

Value-added tax. 25% would be input as 0.25.

Example: 0.25

discountsArray of objects(Discount)

Discounts applied to item.

logisticsobject

Item Logistics.

attributesobject

Allows you to store any custom attributes for the item.

{
  "id": "ci_FpEzyBvBBUyKxkeNriFUxZOCje",
  "reference": "string",
  "name": "T-Shirt XL",
  "sku": "A000123",
  "productType": "physical",
  "items": [
    {}
  ],
  "url": "https://example.com/products/A000123",
  "imageUrl": "https://example.com/products/A000123/images/1",
  "quantity": 2,
  "unit": "st",
  "price": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "total": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "originalTotal": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "vatRate": 0.25,
  "discounts": [
    { … }
  ],
  "logistics": {
    "weight": 0,
    "height": 0,
    "width": 0,
    "length": 0,
    "tags": [ … ]
  },
  "attributes": {
    "property1": null,
    "property2": null
  }
}

Klarna Checkout

Operations

Klarna Checkout Callbacks

Operations

Klarna Checkout 'Client-side events' Callbacks

Operations

Norce Callbacks (Klarna Checkout)

Operations

Order Management

Operations

Klarna Payments

Operations

Norce Callbacks (Klarna Payments)

Operations