NORCE CHECKOUT

CORE

Order

HttpStatusCode

Norce Checkout - Order Management API (1.0)

Build 2026-10-07 13:08:32

The Order Management API is used to create and handle orders

Download OpenAPI description

order-v1.json

order-v1.yaml

Servers

Playground

https://{slug}.api-se.playground.norce.tech/checkout/order/

Stage

https://{slug}.api-se.stage.norce.tech/checkout/order/

Production

https://{slug}.api-se.norce.tech/checkout/order/

Schemas

Hook

idstringread-only

Unique ID for the callback.

Example: "oc_BaDIudFOjBEuFmLlmDExePUFTh"

adapterIdstring

Validation Adapter ID.

Example: "jetshop_adapter"

referencestring

Reference for the hook. Should be the same across orders. Used to track hooks in event logs.

descriptionstring

Description of the hook purpose.

scopestring

Valid json path inside the order. Does not support scope inside arrays.

targetstring

The path to the property in the order that the hooks might respond with patches to. Used to correctly determine the order to call each hook in.

invokestring

Url to invoke on hook trigger. Can include references to adapter configuration and order inside curly braces.

Example: "{config.adapter.publicUrl}/api/v1/orders/{order.id}/some-hook"

versionstring

The version of the order body you expect to receive in the hook.

Enum"v0""v1"

{
  "id": "oc_BaDIudFOjBEuFmLlmDExePUFTh",
  "adapterId": "jetshop_adapter",
  "reference": "string",
  "description": "string",
  "scope": "string",
  "target": "string",
  "invoke": "{config.adapter.publicUrl}/api/v1/orders/{order.id}/some-hook",
  "version": "v0"
}

HttpStatusCode

string(HttpStatusCode)

Enum"continue""switchingProtocols""processing""earlyHints""ok""created""accepted""nonAuthoritativeInformation""noContent""resetContent"

"continue"

Item

idstringread-only

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

Product type, physical is the default. Other options include Digital, GiftCard and Bundle.

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

itemsArray of objects(Item)

A List of items, useful for when this item is a bundle containing other items.

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

Logistics-related information for shipping and handling of the item.

upsellboolean

Indicates if item should be added after order has been accepted.

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": 2500,
    "height": 100,
    "width": 50,
    "length": 200,
    "tags": [ … ],
    "shippingDate": "2026-10-05T00:00:00Z",
    "shippingDates": { … },
    "delivery": { … }
  },
  "upsell": true,
  "attributes": {
    "property1": null,
    "property2": null
  }
}

Checkout

Operations

Checkout Payment

Operations

Checkout Shipping

Operations