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

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

KlarnaValidationErrorResponse

error_typestring
error_textstring
{
  "error_type": "string",
  "error_text": "string"
}

Logistics

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

Order

idstring

Unique identifier for the order

Example: "o_yClTSySjyAuuBjmiBlHCjuEcTf"
merchantstring

Merchant identifier

channelstring

Merchant channel

referencestring

External order reference

createdstring(date-time)

Order creation date time

lastModifiedstring(date-time)

Order last modified date time

stateobject

Order state

culturestring

Order Culture

currencystring

Order Currency

countrystring

Order Country

cartobject

Order cart

shippingsArray of objects(Shipping)

Shippings related to the order

paymentsArray of objects(Payment)

Payments related to the order

customerobject

Customer information

consentsArray of objects(Consent)

Order consents

actionsArray of objects(Callback)

Order actions are called in order to complete an action, such as 'Validate'. If provided the action is not completed if the response is not successful (eg. http status code 400), note however that in case of a time constraint the action might be completed without a successful response.

hooksArray of objects(Hook)

Hooks, added by a separate endpoint.

validationsArray of objects(Validation)

Validations, added by a separate endpoint.

totalobject

Order total including shipping fees

attributesobject

Allows you to store any custom attributes for the order.

{
  "id": "o_yClTSySjyAuuBjmiBlHCjuEcTf",
  "merchant": "string",
  "channel": "string",
  "reference": "string",
  "created": "2019-08-24T14:15:22Z",
  "lastModified": "2019-08-24T14:15:22Z",
  "state": {
    "currentStatus": "checkout",
    "transitions": [ … ]
  },
  "culture": "string",
  "currency": "string",
  "country": "string",
  "cart": {
    "reference": "string",
    "items": [ … ],
    "discounts": [ … ],
    "total": { … }
  },
  "shippings": [
    { … }
  ],
  "payments": [
    { … }
  ],
  "customer": {
    "billing": { … },
    "shipping": { … },
    "type": "Person",
    "attributes": { … }
  },
  "consents": [
    { … }
  ],
  "actions": [
    { … }
  ],
  "hooks": [
    { … }
  ],
  "validations": [
    { … }
  ],
  "total": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "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