NORCE CHECKOUT
/
NORCE ADAPTER
/
Orders

Norce Checkout - Norce Adapter API (1.0.0)

Build 2026-01-12 15:09:14

The Norce Adapter API is used to create and manage an Order based on a Norce Checkout Basket.

Download OpenAPI description
norce-adapter.json
norce-adapter.yaml
Languages
Servers
Test server

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

Schemas

Orders

Operations

Create order from Norce Commerce checkout

Request

Fetches a Norce Commerce Checkout and maps it to a Norce Checkout Order. Note that cart references are unique and no more than one order can exist with provided cart reference.

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
Bodyapplication/json

Context about the order

cartReferenceinteger(int32)required

Storm Basket Id

Example: 56393
culturestringnon-empty^[A-Za-z]{2,3}(?:-[A-Za-z]{2,2})*$required

Language and region of the customer, RFC-1766

Example: "fr-FR"
currencystring^[A-Za-z]{3,3}$

Currency of the purchase, ISO 4217 alpha-3.

Example: "EUR"
countrystring^[A-Za-z]{2,2}$

Country, ISO 3166 alpha-2.

Example: "SE"
priceListSeedArray of integers(int32)

(Optional) A list of PriceList IDs to use.

Example: [16,21,332]
curl -i -X POST \
  https://checkout-norce-adapter.test.norce.tech/api/v1/orders \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce' \
  -d '{
    "cartReference": 56393,
    "culture": "fr-FR",
    "currency": "EUR",
    "country": "SE",
    "priceListSeed": [
      16,
      21,
      332
    ]
  }'

Responses

OK

Bodyapplication/json
idstring

Order identifier

Example: "o"
Response
application/json
{
  "id": "o"
}

Update Order from Norce Commerce Checkout

Request

In case updates are made in Norce Commerce this endpoint makes sure the latest checkout is mapped to the Norce Checkout order.

Path
orderIdstringrequired

Order id to update

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
Bodyapplication/json

Optional context

priceListSeedArray of integers(int32)

(Optional) A list of PriceList IDs to use.

Example: [16,21,332]
curl -i -X PUT \
  'https://checkout-norce-adapter.test.norce.tech/api/v1/orders/{orderId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce' \
  -d '{
    "priceListSeed": [
      16,
      21,
      332
    ]
  }'

Responses

OK

Response
No content

Add Cart Item

Request

Path
orderIdstringrequired

Order id to update

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
Bodyapplication/json

Cart item to add

partNostring
quantityinteger(int32)

Quantity of item. Must be greater or equal to 1.

Example: 2
curl -i -X POST \
  'https://checkout-norce-adapter.test.norce.tech/api/v1/orders/{orderId}/cart/items' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce' \
  -d '{
    "partNo": "string",
    "quantity": 2
  }'

Responses

OK

Response
No content

Update Cart Item

Request

Path
orderIdstringrequired

Order id to update

itemIdstringrequired

Cart item id to update

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
Bodyapplication/json

Cart item properties to update. Only quantity is valid for now.

quantityinteger(int32)

Quantity of item. Must be greater or equal to 1.

Example: 2
curl -i -X PATCH \
  'https://checkout-norce-adapter.test.norce.tech/api/v1/orders/{orderId}/cart/items/{itemId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce' \
  -d '{
    "quantity": 2
  }'

Responses

OK

Response
No content

Delete Cart Item

Request

Path
orderIdstringrequired

Order id

itemIdstringrequired

Cart item id to remove

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
curl -i -X DELETE \
  'https://checkout-norce-adapter.test.norce.tech/api/v1/orders/{orderId}/cart/items/{itemId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce'

Responses

OK

Response
No content

Add Discount by code

Request

Adds discount code on Norce Commerce basket and update Order with new cart

Path
orderIdstringrequired

Order id to update

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
Bodyapplication/json

Discount containing Code to be added.

codestring

Discount code.

curl -i -X POST \
  'https://checkout-norce-adapter.test.norce.tech/api/v1/orders/{orderId}/cart/discounts' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce' \
  -d '{
    "code": "string"
  }'

Responses

OK

Response
No content

Remove Discount by code

Request

Removes discount code on Norce Commerce basket and update Order with new cart

Path
orderIdstringrequired

Order id to update

Query
discountCodestring

Discount code to be removed.

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
curl -i -X DELETE \
  'https://checkout-norce-adapter.test.norce.tech/api/v1/orders/{orderId}/cart/discounts' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce'

Responses

OK

Response
No content

Validate Order

Request

Validates Order from cart in Norce commerce platform and make sure all products are buyable.

Path
orderIdstringrequired

Order id to validate

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
curl -i -X POST \
  'https://checkout-norce-adapter.test.norce.tech/api/v1/orders/{orderId}/validate' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce'

Responses

OK

Response
No content

Hooks

Operations

Notifications

Operations