Klarna · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Klarna HPP Captures Merchantcard API

3 actions 3 updates update extends openapi/klarna-merchantcard-api-openapi.yml

Derived by API Evangelist Built from the contracts Klarna publishes. Klarna did not publish this file.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-artifactsx-klarna-base-urlsx-error-envelopex-rate-limit-headersx-idle-timeout-secondsx-request-body-maxx-idempotency

Targets 1

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Klarna HPP Captures Merchantcard API
  version: 1.0.0
extends: openapi/klarna-merchantcard-api-openapi.yml
x-generated: '2026-08-27'
x-method: generated
x-source: Klarna published documentation (docs.klarna.com) + artifacts in this repo
x-note: 'Additive only. Records cross-cutting semantics Klarna documents in prose but does not express in the specification:
  idempotency header, error envelope shape, rate-limit headers, regional base URLs and the idle timeout. The original
  OpenAPI is never mutated.'
actions:
- target: $.info
  update:
    x-apievangelist-provider: klarna
    x-apievangelist-artifacts:
      authentication: authentication/klarna-authentication.yml
      conventions: conventions/klarna-conventions.yml
      errors: errors/klarna-problem-types.yml
      lifecycle: lifecycle/klarna-lifecycle.yml
      rate-limits: rate-limits/klarna-rate-limits.yml
      sandbox: sandbox/klarna-sandbox.yml
      data-model: data-model/klarna-data-model.yml
      conformance: conformance/klarna-conformance.yml
    x-klarna-base-urls:
      live:
        europe: https://api.klarna.com/
        north_america: https://api-na.klarna.com/
        oceania: https://api-oc.klarna.com/
      playground:
        europe: https://api.playground.klarna.com/
        north_america: https://api-na.playground.klarna.com/
        oceania: https://api-oc.playground.klarna.com/
- target: $.info
  update:
    x-error-envelope:
      format: custom-json
      fields:
      - correlation_id
      - error_code
      - error_messages
      rfc9457: false
    x-rate-limit-headers:
    - X-Ratelimit-Limit
    - X-Ratelimit-Remaining
    - X-Ratelimit-Reset
    x-idle-timeout-seconds: 59
    x-request-body-max: 1MB
- target: $.info
  update:
    x-idempotency:
      header: Klarna-Idempotency-Key
      methods:
      - POST
      - PATCH
      key_format: UUIDv5
      retention: 24 hours
      required_for:
      - createPromise
      - postcancelorder
      - settlePromise
      docs: https://docs.klarna.com/api-reference/direct-partner/integration-resilience/

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
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 overlay

curl "https://apis.io/api/v1/overlays/klarna-merchantcard-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.