openapi: 3.1.0
info:
  title: Relay Webhook Contracts
  version: 1.0.0
  description: Inbound payment callbacks currently implemented by Relay Core.
servers:
  - url: https://api.relay.techminemw.com/api/v1
paths:
  /payments/webhook:
    post:
      operationId: receiveTenantPaymentWebhook
      parameters:
        - in: header
          name: X-Siku-Signature
          required: true
          schema: {type: string}
      responses:
        '200': {description: Event accepted idempotently}
        '401': {description: Signature verification failed}
  /billing/webhook:
    post:
      operationId: receiveRelayBillingWebhook
      parameters:
        - in: header
          name: X-Paychangu-Signature
          required: true
          schema: {type: string}
      responses:
        '200': {description: Verified event settled idempotently}
        '400': {description: Invalid signature or payload}
