Klarna

At a glance

Availability: Experimental (how to enable).
Authentication: Basic auth.
Connection: HTTP Basic auth with KLARNA_API_USERNAME as the username and KLARNA_API_PASSWORD as the password.
Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

Variable	Required	Description
`KLARNA_API_USERNAME`	Yes	Klarna API username (the UID shown when creating credentials in the Merchant Portal), used as the HTTP Basic username Docs.
`KLARNA_API_PASSWORD`	Yes	Klarna API password/key associated with the username, used as the HTTP Basic password Docs.
`KLARNA_API_HOST`	No	Klarna API host without scheme: api.klarna.com (Europe), api-na.klarna.com (North America), or api-oc.klarna.com (Oceania); playground credentials use the api.playground.klarna.com variants.

Setup

Get a Klarna merchant account: Sign up as a Klarna merchant at https://www.klarna.com/business/ and log in to the Merchant Portal at https://portal.klarna.com/. For testing without a live contract, use the Playground environment (https://portal.playground.klarna.com/).
Create API credentials: In the Merchant Portal, go to Settings > API credentials and generate a new credential. You get a username (a UID linked to your merchant ID) and a password/API key. The password is shown only once, so store it immediately.
Set environment variables: Add KLARNA_API_USERNAME (the UID) and KLARNA_API_PASSWORD (the API key/password) to your .env. Requests authenticate with HTTP Basic auth using these two values.
Pick your regional host and verify: All tools use the KLARNA_API_HOST environment variable (default api.klarna.com for Europe). Set api-na.klarna.com for North America or api-oc.klarna.com for Oceania. Run Get Order with a known order ID to verify access.

Provider notes

Playground (test) credentials only work against the playground hosts (api.playground.klarna.com, api-na.playground.klarna.com, api-oc.playground.klarna.com) and production credentials only against production hosts, so set KLARNA_API_HOST accordingly.
All amounts are in minor units of the order currency (e.g. 1050 = 10.50 EUR).
Refunds require a prior capture; cancel only works on orders that have not been captured.

Provider API reference.

Tools

Tool	Access	Description
Get Order `klarna__get_order`	Read	Retrieve a Klarna order including status, amounts, order lines, captures, and refunds
Capture Order `klarna__capture_order`	Write	Capture a full or partial amount of an authorized order (activates the payment after fulfillment)
Refund Order `klarna__refund_order`	Write	Refund a full or partial captured amount back to the customer
Cancel Order `klarna__cancel_order`	Write	Cancel an authorized order that has not been captured, releasing the full authorization
Release Remaining Authorization `klarna__release_remaining_authorization`	Write	Release the remaining (uncaptured) authorized amount of an order after the final partial capture: the standard end-of-fulfillment step that frees the customer’s remaining authorization
Get Capture `klarna__get_capture`	Read	Get a single capture of an order with its status and amounts

Verify the connection

Call a read tool such as klarna__get_order with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.

Get started

APIs

REST API

GraphQL API

MCP API

At a glance

Credentials

Setup

Provider notes

Tools

Verify the connection

​At a glance

​Credentials

​Setup

​Provider notes

​Tools

​Verify the connection

At a glance

Credentials

Setup

Provider notes

Tools

Verify the connection