openapi: 3.0.3
info:
  title: MEMEH API
  version: 1.0.0
  description: >
    Starter OpenAPI contract for the Mutual Enterprise Messaging and Exchange
    Hub. Replace example schemas with generated, approved production contracts
    before participant certification.
servers:
  - url: https://memeh.sps.bsl.datahub.gov.sl
    description: Production
  - url: https://sandbox.memeh.sps.bsl.datahub.gov.sl
    description: Sandbox
tags:
  - name: Access
    description: Partner onboarding and controlled access requests.
  - name: Payments
    description: Payment lifecycle simulation and production-path payment requests.
paths:
  /apply:
    get:
      tags:
        - Access
      summary: Render access request form
      responses:
        "200":
          description: Access request form rendered.
  /sandbox/payment:
    get:
      tags:
        - Payments
      summary: Render sandbox payment simulator
      security:
        - sessionAuth: []
      responses:
        "200":
          description: Sandbox simulator rendered for authorized users.
        "403":
          description: User is not authorized for sandbox access.
components:
  securitySchemes:
    sessionAuth:
      type: apiKey
      in: cookie
      name: memeh_session
