Klarna · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Klarna HPP Captures Payouts API

2 actions 2 updates update extends openapi/klarna-payouts-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Klarna's API. It is a proposal applied on top of the contract, not a document Klarna publishes.

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-max

Targets 1

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Klarna HPP Captures Payouts API
  version: 1.0.0
extends: openapi/klarna-payouts-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