NORCE CHECKOUT
/
PAYMENT ADAPTERS
/
Klarna Adapter
/
Klarna Checkout

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

Klarna Checkout

Operations

Create a new Klarna Checkout Order

Request

Requires an existing Norce order.

Path
order_idstringrequired

Order identifier

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

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

Responses

OK

Bodyapplication/json
idstring

Norce Payment Id

statusstring

Klarna checkout order status.

Example: "CHECKOUT_INCOMPLETE"
htmlSnippetstring

Klarna checkout order html snippet.

Example: "\n <div id='klarna-checkout-container'><script>alert('Initializing Klarna Checkout');</script>\n </div>\n "
Response
application/json
{
  "id": "string",
  "status": "CHECKOUT_INCOMPLETE",
  "htmlSnippet": "\n                <div id='klarna-checkout-container'><script>alert('Initializing Klarna Checkout');</script>\n                </div>\n            "
}

Create a new Klarna Checkout order using a recurring token from a previous Klarna Checkout purchase.

Request

Requires an existing Norce order and Klarna Checkout recurring token

Path
order_idstringrequired

Order identifier

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
Bodyapplication/json

Recurring token that should be used for completing the order

tokenstring
autoCaptureboolean
curl -i -X POST \
  'https://checkout-klarna-adapter.test.norce.tech/api/checkout/v1/orders/{order_id}/payments/recurring' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce' \
  -d '{
    "token": "string",
    "autoCapture": true
  }'

Responses

OK

Bodyapplication/json
idstring

Norce Payment Id

Response
application/json
{
  "id": "string"
}

Remove a Klarna Checkout Order

Request

Requires an existing Norce order. Will do soft delete on any payments or shippings by setting state to removed. Will delete any hooks added when creating a klarna checkout order.

Path
order_idstringrequired

Order identifier

payment_idstringrequired

Payment identifier

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

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

Responses

OK

Response
No content

Get Klarna Checkout Order

Request

Used to get the html snippet, for example after the Klarna Checkout Order has been confirmed.

Path
order_idstringrequired

Order identifier

payment_idstringrequired

Payment identifier

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
curl -i -X GET \
  'https://checkout-klarna-adapter.test.norce.tech/api/checkout/v1/orders/{order_id}/payments/{payment_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce'

Responses

OK

Bodyapplication/json
idstring

Norce Payment Id

statusstring

Klarna checkout order status.

Example: "CHECKOUT_INCOMPLETE"
htmlSnippetstring

Klarna checkout order html snippet.

Example: "\n <div id='klarna-checkout-container'><script>alert('Initializing Klarna Checkout');</script>\n </div>\n "
Response
application/json
{
  "id": "string",
  "status": "CHECKOUT_INCOMPLETE",
  "htmlSnippet": "\n                <div id='klarna-checkout-container'><script>alert('Initializing Klarna Checkout');</script>\n                </div>\n            "
}

Update Klarna Checkout Order

Request

Used to remap and update the Klarna Checkout Order from the Norce order, requires existing payment with Klarna Checkout Order.

Path
order_idstringrequired

Order identifier

payment_idstringrequired

Payment identifier

Headers
x-merchantstringrequired

Merchant identifier.

Example: norce
x-channelstringrequired

Channel identifier

Example: 1
curl -i -X PUT \
  'https://checkout-klarna-adapter.test.norce.tech/api/checkout/v1/orders/{order_id}/payments/{payment_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce'

Responses

OK

Bodyapplication/json
idstring

Norce Payment Id

statusstring

Klarna checkout order status.

Example: "CHECKOUT_INCOMPLETE"
htmlSnippetstring

Klarna checkout order html snippet.

Example: "\n <div id='klarna-checkout-container'><script>alert('Initializing Klarna Checkout');</script>\n </div>\n "
Response
application/json
{
  "id": "string",
  "status": "CHECKOUT_INCOMPLETE",
  "htmlSnippet": "\n                <div id='klarna-checkout-container'><script>alert('Initializing Klarna Checkout');</script>\n                </div>\n            "
}

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