NORCE CHECKOUT
/
PAYMENT ADAPTERS
/
Klarna Adapter
/
Order Management

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

Klarna Checkout Callbacks

Operations

Klarna Checkout 'Client-side events' Callbacks

Operations

Norce Callbacks (Klarna Checkout)

Operations

Order Management

Operations

Refresh the list of available PaymentActions for a Klarna Checkout Order Payment

Request

Refreshes the list of available payment actions on the Klarna Checkout payment to reflect the current payment state

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/order/v1/orders/{order_id}/payments/{payment_id}/refresh-kco' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce'

Responses

OK

Response
No content

Refresh the list of available PaymentActions for a Klarna Payment Order Payment

Request

Refreshes the list of available payment actions on the Klarna Payment payment to reflect the current payment state

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/order/v1/orders/{order_id}/payments/{payment_id}/refresh-kp' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'x-channel: 1' \
  -H 'x-merchant: norce'

Responses

OK

Response
No content

Cancel Klarna order

Request

Used to cancel a Klarna 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/order/v1/orders/{order_id}/payments/{payment_id}/cancel' \
  -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            "
}

Capture Klarna order

Request

Used to capture a Klarna 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/order/v1/orders/{order_id}/payments/{payment_id}/capture' \
  -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            "
}

Refund Klarna order

Request

Used to refund a Klarna 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/order/v1/orders/{order_id}/payments/{payment_id}/refund' \
  -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 Payments

Operations

Norce Callbacks (Klarna Payments)

Operations