Klarna

Klarna Payments API

The Payments API from Klarna — 5 operation(s) for payments.

GitHub OpenAPI
Business capability
Payment Initiation Management BC-1340.10

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /payments/v1/sessions Start a payment session · Create a session #
Ask an LLM
“How do I start a Klarna Payments session and get a client token for the browser?”
“Which payment method categories can I offer for a given cart and country?”
Tell an agent
Create a payment session for {order_amount} {purchase_currency} in {purchase_country}.
Start a payment session for cart {order_lines} with intent {intent}.
POST /payments/v1/sessions/{session_id} Update a payment session · Update a session #
Ask an LLM
“The shopper added an item to the cart, how do I update their payment session?”
“Can I change the customer details on a payment session after the checkout reloads?”
Tell an agent
Update payment session {session_id} to amount {order_amount}.
Replace the cart on payment session {session_id} with {order_lines}.
GET /payments/v1/sessions/{session_id} Get a payment session · Get details about a session #
Ask an LLM
“What data has been collected so far in a payment session?”
“Can I check a payment session's status after it's created?”
Tell an agent
Get payment session {session_id}.
Show everything collected in payment session {session_id}.
DELETE /payments/v1/authorizations/{authorizationToken} Release an unused payment authorization · Cancel an authorization #
Ask an LLM
“What do I do with an authorization token I'm not going to turn into an order?”
“Can I cancel an authorization before any order is placed?”
Tell an agent destructive · confirm first
Cancel authorization {authorizationToken}.
Release the unused payment authorization {authorizationToken}.
POST /payments/v1/authorizations/{authorizationToken}/order Place an order from an authorization · Create an order #
Ask an LLM
“After a successful authorization, how do I turn it into an order?”
“Can I auto-capture when placing an order from an authorization token?”
Tell an agent
Place an order with authorization {authorizationToken} for {order_amount} {purchase_currency}.
Create an order from authorization {authorizationToken} for cart {order_lines} shipped in {purchase_country}.
POST /payments/v1/authorizations/{authorizationToken}/customer-token Save a customer token from an authorization · Generate a customer token #
Ask an LLM
“How can I store a customer's payment method for future charges after they authorize?”
“Can I generate a reusable customer token instead of placing the order right away?”
Tell an agent
Generate a customer token from authorization {authorizationToken} for {intended_use} described as {description}.
Create a reusable token from authorization {authorizationToken} in {purchase_country} with {purchase_currency} and locale {locale}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/openapi/klarna-payments-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/json-schema/klarna-session-create-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/json-schema/klarna-session-read-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/json-schema/klarna-session-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/json-schema/klarna-create-order-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/json-schema/klarna-order-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/json-schema/klarna-customer-token-creation-response-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/overlays/klarna-payments-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/klarna:klarna-payments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

klarna-payments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Hosted Payment Page (HPP) API is a service that lets you integrate Klarna Payments without the need of hosting the web page that manages the client side of Klarna Payments.
  version: '1.1'
  title: Klarna HPP Captures Payments API
  license:
    name: Klarna Bank AB
servers:
- url: https://api.klarna.com
tags:


# --- truncated at 32 KB (54 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/klarna/refs/heads/main/openapi/klarna-payments-api-openapi.yml