Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Klarna Merchantcard API

The Merchantcard API from Klarna — 6 operation(s) for merchantcard.

Klarna Merchantcard API is one of 21 APIs that Klarna publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Merchantcard. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 7 operations across 6 paths, and defines 11 schemas. It is described by OpenAPI 3.0.0, at version 1.1.

Requests are made against a single base URL, https://api.klarna.com.

7 operations 6 paths 11 schemas 4 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.1
Base URL
https://api.klarna.com
License
Klarna Bank AB
Resource Areas
1

Paths & Operations 7

Across 6 paths, the API surfaces 7 operations — 4 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Merchantcard 7
POST
/merchantcard/v3/promises
Klarna Create a card promise
createPromise body → 201400503
GET
/merchantcard/v3/promises/{promise_id}
Klarna Get details of a card promise
readPromise 1 param → 200403404
POST
/merchantcard/v3/settlements
Klarna Create a card settlement
settlePromise body → 201400403503
GET
/merchantcard/v3/settlements/{settlement_id}
Klarna Get details of card settlement
readSettlement 2 params → 200403404
GET
/merchantcard/v3/settlements/order/{order_id}
Klarna Get card settlement details for an order
readSettlementByOrderId 2 params → 200403404
POST
/merchantcard/v3/orders/{order_id}/cancel-request
Klarna Request order cancellation
postcancelorder 1 param → 200202400403404503
GET
/merchantcard/v3/orders/{order_id}/cancel-request
Klarna Get order cancellation status
getcancelorder 1 param → 200400403404503

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are card (9 properties), settlement_response (6 properties), promise_response (5 properties), cancel_order_request_status (4 properties). Each schema is shown below with its type and property counts.

card_specification
object
4 properties 3 required
cancel_order_request_status_no_request_found
object
3 properties 3 required
card
object
9 properties
promise_response
object
5 properties
settlement_request
object
3 properties 2 required
promise_created_response
object
2 properties
settlement_response
object
6 properties
promise_request
object
2 properties 2 required
cancel_order_request_status_pending
object
2 properties 2 required
cancel_order_request_status
object
4 properties 1 required
cancel_order_request_status_cancelled
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klarna-merchantcard-api-openapi.yml Raw ↑

Other APIs Klarna publishes across the network.

Klarna Payments API
Klarna Checkout API
Klarna Order Management API
Klarna Customer Token API
Klarna Settlements API
Klarna Push Notifications
Klarna Captures API
Klarna Checkout API
Klarna Customer Token API
Klarna Hpp API
Klarna Merchant Urls.address Update API
Klarna Merchant Urls.country Change API