{
  "openapi": "3.1.0",
  "info": {
    "title": "GroundIT — interpay (KSA money movement & remittance corridor)",
    "version": "0.1.0",
    "license": {
      "name": "Proprietary — GroundIT/Sysmedac internal"
    },
    "description": "**Phase-2 · Proposed (open items) · SHAPED STUB — no sandbox/spec available yet (ADR 0013).** Fixes the boundary GroundIT's `pay`/`comply`/`fintech` modules invoke — KSA SAR payouts, WPS-via-Mudad, GOSI, SAMA reporting, and the KSA→India remittance corridor (ADR 0019) — never interpay directly. Every field below is **TODO** pending the partner contract; residency, message formats, FX model, and licence/AML/settlement ownership are open items (architecture-docs/09-external-services-register.md). See ../../09-surface-fintech-ports.md.\n"
  },
  "servers": [
    {
      "url": "https://partner.interpay.example/v1",
      "description": "PLACEHOLDER — no sandbox access yet (ADR 0013)."
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "wps",
      "description": "KSA SAR payout via WPS, submitted through Mudad (ADR 0013)."
    },
    {
      "name": "gosi",
      "description": "GOSI social-insurance contribution submission (ADR 0013)."
    },
    {
      "name": "sama",
      "description": "SAMA regulatory reporting (ADR 0013)."
    },
    {
      "name": "corridor",
      "description": "KSA→India remittance corridor over interpay's emerging India rail (ADR 0019)."
    }
  ],
  "paths": {
    "/interpay/wps-payouts": {
      "post": {
        "operationId": "fintech.interpay.wps_payout_submit",
        "summary": "TODO — submit a KSA payroll run's SAR payouts via WPS/Mudad",
        "description": "TODO. `pay.payroll_runs` invokes this, never Mudad directly (ADR 0013). SIF shape/batching/settlement-ack unspecified.",
        "tags": [
          "wps"
        ],
        "x-token": "fintech.interpay.wps_payout_submit",
        "x-realizes-features": [
          "FIN-F01"
        ],
        "x-screens": [],
        "x-touches-entities": [
          "pay.payroll_runs",
          "comply.statutory_filings"
        ],
        "x-idempotent": true,
        "x-market": "KSA",
        "x-sync-async": "async",
        "x-emits-event": "comply.wps_filing.submitted",
        "x-rls-scope": "tenant",
        "x-append-only": false,
        "x-entitlement": null,
        "x-provisional": null,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InterpayEnvelopeTodo"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "TODO — accepted for submission; ack shape unknown."
          },
          "401": {
            "description": "TODO — auth scheme unconfirmed."
          }
        }
      }
    },
    "/interpay/gosi-contributions": {
      "post": {
        "operationId": "fintech.interpay.gosi_contribution_submit",
        "summary": "TODO — submit GOSI contribution data for a KSA payroll run",
        "description": "TODO. `comply` invokes this (ADR 0013); message format pending sandbox.",
        "tags": [
          "gosi"
        ],
        "x-token": "fintech.interpay.gosi_contribution_submit",
        "x-realizes-features": [
          "FIN-F01"
        ],
        "x-screens": [],
        "x-touches-entities": [
          "comply.statutory_filings"
        ],
        "x-idempotent": true,
        "x-market": "KSA",
        "x-sync-async": "async",
        "x-emits-event": "comply.gosi_filing.submitted",
        "x-rls-scope": "tenant",
        "x-append-only": false,
        "x-entitlement": null,
        "x-provisional": null,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InterpayEnvelopeTodo"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "TODO"
          },
          "401": {
            "description": "TODO"
          }
        }
      }
    },
    "/interpay/sama-reports": {
      "post": {
        "operationId": "fintech.interpay.sama_report_submit",
        "summary": "TODO — submit a SAMA-mandated regulatory report",
        "description": "TODO. Cadence/evidence format open (ADR 0013); `comply` is the caller.",
        "tags": [
          "sama"
        ],
        "x-token": "fintech.interpay.sama_report_submit",
        "x-realizes-features": [
          "FIN-F01"
        ],
        "x-screens": [],
        "x-touches-entities": [
          "comply.statutory_filings"
        ],
        "x-idempotent": true,
        "x-market": "KSA",
        "x-sync-async": "async",
        "x-emits-event": "comply.sama_report.submitted",
        "x-rls-scope": "tenant",
        "x-append-only": false,
        "x-entitlement": null,
        "x-provisional": null,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InterpayEnvelopeTodo"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "TODO"
          },
          "401": {
            "description": "TODO"
          }
        }
      }
    },
    "/interpay/fx-quotes": {
      "post": {
        "operationId": "fintech.interpay.fx_quote_request",
        "summary": "TODO — request a short-lived SAR→INR FX rate token",
        "description": "TODO. Backs `fintech.fx_rates` (db 13 §3, ≈5-min TTL, single-use). FX sourcing/spread is open (ADR 0019).",
        "tags": [
          "corridor"
        ],
        "x-token": "fintech.interpay.fx_quote_request",
        "x-realizes-features": [
          "FIN-F03"
        ],
        "x-screens": [],
        "x-touches-entities": [
          "fintech.fx_rates"
        ],
        "x-idempotent": true,
        "x-market": "KSA",
        "x-sync-async": "sync",
        "x-emits-event": null,
        "x-rls-scope": "tenant",
        "x-append-only": false,
        "x-entitlement": null,
        "x-provisional": null,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InterpayEnvelopeTodo"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "TODO — rate token payload unconfirmed."
          },
          "401": {
            "description": "TODO"
          }
        }
      }
    },
    "/interpay/corridor-transfers": {
      "post": {
        "operationId": "fintech.interpay.corridor_transfer_submit",
        "summary": "TODO — execute a KSA→India remittance rail leg",
        "description": "TODO. Backs `fintech.corridor_transfers` (db 13 §3, ADR 0019); licence/AML/residency (PDPL↔DPDP) open.",
        "tags": [
          "corridor"
        ],
        "x-token": "fintech.interpay.corridor_transfer_submit",
        "x-realizes-features": [
          "FIN-F03"
        ],
        "x-screens": [],
        "x-touches-entities": [
          "fintech.corridor_transfers",
          "fintech.fx_rates"
        ],
        "x-idempotent": true,
        "x-market": "KSA",
        "x-sync-async": "async",
        "x-emits-event": "fintech.remittance.initiated",
        "x-rls-scope": "tenant",
        "x-append-only": false,
        "x-entitlement": null,
        "x-provisional": null,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InterpayEnvelopeTodo"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "TODO — settlement/UTR confirmation shape unknown."
          },
          "401": {
            "description": "TODO"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "InterpayEnvelopeTodo": {
        "type": "object",
        "description": "TODO placeholder envelope — real fields/auth/idempotency unspecified pending interpay's sandbox (ADR 0013). Do not implement against this shape.",
        "properties": {
          "legal_entity_ref": {
            "$ref": "#/components/schemas/BusinessNo"
          },
          "note": {
            "type": "string",
            "description": "Always \"TODO — interpay wire contract not yet available\"."
          }
        }
      },
      "BusinessNo": {
        "type": "string",
        "description": "Tenant-unique, prefixed human reference (`employee_no`, `requisition_no`, `offer_no`, `payslip_no`, `claim_no`, `ticket_no`, `asset_no`, `case_no`). Read-model field; never a path key.\n"
      }
    }
  }
}