NORCE CHECKOUT
/
PAYMENT ADAPTERS
/
Klarna Adapter
/
Schemas
/
Shipping

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
Languages
Servers
Test server

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

Schemas

Session

client_tokenstring

Client Token

payment_method_categoriesArray of objects(KlarnaPaymentsPaymentMethodCategory)

Available payment method categories

session_idstring

ID of the created session. Please use this ID to share with Klarna for identifying any issues during integration.

{
  "client_token": "string",
  "payment_method_categories": [
    { … }
  ],
  "session_id": "string"
}

Shipping

idstring

Unique identifier for the shipping.

Example: "s_pmHreuEBboeezpixrHMDPQlazU"
merchantstring

Merchant identifier.

Example: "norce"
channelstring

Channel identifier

Example: "1"
statestring

Current state of the shipping.

Enum"intent""removed""processing""failed""confirmed"
referencestring

External reference to shipping.

Example: "e8ed2091-c34c-4837-a3a8-bc827b0dc183"
tmsReferencestring

TMS Reference.

Example: "a935a628-f70c-47a4-a9f6-98c6d08c2ba3"
orderIdstring

ID of the order.

Example: "o_DhZSbDfVzNzuxOzHyCFskzGzaJ"
adapterIdstring

Adapter ID

Example: "ingrid-shipping-adapter"
namestring

Descriptive name of the shipping.

Example: "PostNord MyPack Home"
totalobjectrequired

Total price of the shipping.

total.​includingVatnumber(double)

Total price including vat in the checkout specified currency. Requires two decimal points or multiples of 0.01.

Example: 1234
total.​excludingVatnumber(double)

Total price excluding vat in the checkout specified currency. Requires two decimal points or multiples of 0.01.

Example: 987.2
vatRatenumber(double)required

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

Example: 0.25
deliveryDetailsobject

Delivery details.

addonsArray of objects(Addon)

Shipping addons.

attributesobject

Allows you to store any custom attributes for the shipping.

{
  "id": "s_pmHreuEBboeezpixrHMDPQlazU",
  "merchant": "norce",
  "channel": "1",
  "state": "intent",
  "reference": "e8ed2091-c34c-4837-a3a8-bc827b0dc183",
  "tmsReference": "a935a628-f70c-47a4-a9f6-98c6d08c2ba3",
  "orderId": "o_DhZSbDfVzNzuxOzHyCFskzGzaJ",
  "adapterId": "ingrid-shipping-adapter",
  "name": "PostNord MyPack Home",
  "total": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "vatRate": 0.25,
  "deliveryDetails": {
    "carrier": "string",
    "class": "string",
    "product": { … },
    "pickupLocation": { … }
  },
  "addons": [
    { … }
  ],
  "attributes": {
    "property1": null,
    "property2": null
  }
}

ShippingAttributes

weightinteger(int32)
dimensionsobject
tagsArray of strings
{
  "weight": 0,
  "dimensions": {
    "height": 0,
    "width": 0,
    "length": 0
  },
  "tags": [
    "string"
  ]
}

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