Satispay · OpenAPI Overlay 1.0.0

Satispay sandbox — API Evangelist enhancements

4 actions 4 updates update extends satispay-sandbox.json

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-sourcex-apievangelist-harvestedcontacttermsOfServicex-authentication-modelx-authentication-docsx-idempotencyx-error-catalog

Targets 3

$.info

$.paths.*.post

OpenAPI Overlay

# OpenAPI Overlay 1.0.0 — API Evangelist enhancements for Satispay
# generated: '2026-08-26'
# method: generated
# source: openapi/satispay-sandbox.json
# This overlay is NOT applied to the original spec; it records the enhancements this
# profile derives so the harvested definition stays verbatim.
overlay: 1.0.0
info:
  title: Satispay sandbox — API Evangelist enhancements
  version: 1.0.0
extends: satispay-sandbox.json
actions:
- target: $.info
  description: Record provenance and the contact surface Satispay publishes in its docs.
  update:
    x-apievangelist-source: https://developers.satispay.com/
    x-apievangelist-harvested: '2026-08-26'
    contact:
      name: Satispay Tech
      email: tech@satispay.com
      url: https://developers.satispay.com/
    termsOfService: https://www.satispay.com/it-it/legal-hub/
- target: $.info
  description: >-
    Name the authentication model explicitly. The spec declares only a generic
    apiKey-in-header scheme, which understates that the Authorization value is a computed
    RSA signature over the request.
  update:
    x-authentication-model: cavage-http-signatures-draft-10
    x-authentication-docs: https://developers.satispay.com/reference/introduction
- target: $.paths.*.post
  description: Declare the Idempotency-Key header Satispay documents but does not put in the spec.
  update:
    x-idempotency:
      header: Idempotency-Key
      docs: https://developers.satispay.com/reference/idempotency
- target: $
  description: >-
    Record the error catalog and rate-limit signal derived from this spec's 4xx responses.
  update:
    x-error-catalog: errors/satispay-problem-types.yml
    x-rate-limit-signal:
      status: 403
      code: '70'
      message: Anti-hammering violation
# Gaps this overlay records but deliberately does not patch (the original spec is left verbatim):
#   operations: 1
#   components.schemas declared: 0
#   operations carrying tags: 0