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

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

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
  }
}

OrderConfirmation

redirectUrlstring
orderobject
{
  "redirectUrl": "string",
  "order": {
    "authorized_payment_method": { … },
    "fraud_status": "string",
    "order_id": "string",
    "redirect_url": "string"
  }
}

OrderLine

typestring
referencestring
namestring
quantityinteger(int32)
quantity_unitstring
unit_priceinteger(int32)
tax_rateinteger(int32)
total_amountinteger(int32)
total_discount_amountinteger(int32)
total_tax_amountinteger(int32)
merchant_datastring
product_urlstring(uri)
image_urlstring(uri)
product_identifiersobject
shipping_attributesobject
{
  "type": "string",
  "reference": "string",
  "name": "string",
  "quantity": 0,
  "quantity_unit": "string",
  "unit_price": 0,
  "tax_rate": 0,
  "total_amount": 0,
  "total_discount_amount": 0,
  "total_tax_amount": 0,
  "merchant_data": "string",
  "product_url": "http://example.com",
  "image_url": "http://example.com",
  "product_identifiers": {
    "category_path": "string",
    "global_trade_item_number": "string",
    "manufacturer_part_number": "string",
    "brand": "string"
  },
  "shipping_attributes": {
    "weight": 0,
    "dimensions": { … },
    "tags": [ … ]
  }
}

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