{
  "generated_at": "2026-04-10T10:31:25.575Z",
  "system": {
    "id": "topolo-pay",
    "name": "Topolo Pay",
    "slug": "topolo-pay",
    "kind": "application",
    "summary": "Payment worker handling orders, webhooks, admin APIs, and static-asset-backed application behavior.",
    "aliases": [],
    "lifecycle": "active",
    "last_verified": "2026-04-07",
    "owners": [
      "commerce"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloPay"
    ],
    "service_ids": [
      "srv_DJInUxp0dLLi"
    ],
    "visibility": "public",
    "api_contract": {
      "type": "curated",
      "source": "PlatformApplications/TopoloDocs/src/content/public/applications/pay.mdx",
      "notes": "Canonical public and internal docs cover the payment worker, local webhook boundary, and Nexus-routed outbound payment operations."
    },
    "primary_hosts": [],
    "doc_paths": [
      "applications/pay",
      "internal/apps/pay"
    ],
    "dependencies": [
      "topolo-auth",
      "topolo-nexus"
    ],
    "public_hub_url": "/systems/topolo-pay",
    "internal_hub_url": null,
    "application_api_url": "/reference/apps/topolo-pay",
    "generated_openapi_url": null,
    "machine_urls": {
      "system": "/machine/systems/topolo-pay.json",
      "application": "/machine/applications/topolo-pay.json"
    }
  },
  "docs": {
    "public": [
      {
        "id": "applications/commerce.mdx",
        "title": "TopoloCommerce",
        "summary": "Public overview of the multi-vertical commerce platform for venue operations, guest runtimes, and staff execution.",
        "audience": "public",
        "tags": [
          "commerce",
          "venues",
          "kiosk"
        ],
        "url": "/applications/commerce.mdx",
        "last_verified": "2026-04-10"
      },
      {
        "id": "applications/pay.mdx",
        "title": "Topolo Pay",
        "summary": "Public overview of the payment worker that handles orders, refunds, and payment operations.",
        "audience": "public",
        "tags": [
          "payments",
          "orders",
          "worker"
        ],
        "url": "/applications/pay.mdx",
        "last_verified": "2026-04-07"
      }
    ],
    "internal": [],
    "runbooks": []
  },
  "authority": {
    "owners": [
      "commerce"
    ],
    "repo_paths": [
      "PlatformApplications/TopoloPay"
    ],
    "service_ids": [
      "srv_DJInUxp0dLLi"
    ],
    "dependencies": [
      "topolo-auth",
      "topolo-nexus"
    ],
    "aliases": []
  },
  "interfaces": {
    "contract_type": "curated",
    "contract_source": "PlatformApplications/TopoloDocs/src/content/public/applications/pay.mdx",
    "contract_source_exists": true,
    "openapi": null,
    "readme": {
      "path": "PlatformApplications/TopoloPay/README.md",
      "intro": [
        "Canonical documentation for Topolo Pay lives in `PlatformApplications/TopoloDocs`.",
        "Use this directory for implementation only. Payment boundaries, deployment guidance, auth, and external-service integration rules are canonical in the docs application and should not be duplicated here."
      ],
      "headings": [
        "Topolo Pay"
      ],
      "routeHighlights": [],
      "commandHighlights": []
    }
  },
  "auth": {
    "depends_on_topolo_auth": true,
    "api_key_scopes": [
      {
        "name": "transactions.read",
        "description": "View payment transactions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "transactions.write",
        "description": "Process payments and refunds",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "customers.read",
        "description": "View customer payment profiles",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "customers.write",
        "description": "Manage customer payment methods",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "invoices.read",
        "description": "View invoices and billing",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "invoices.write",
        "description": "Create and manage invoices",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "reports.read",
        "description": "View payment reports and analytics",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "payments.create",
        "description": "Create payment or checkout sessions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "payments.read",
        "description": "Read payment and charge state",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "transactions.refund",
        "description": "Refund transactions",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "venues.read",
        "description": "View venue configuration",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "venues.write",
        "description": "Manage venue configuration",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "analytics.read",
        "description": "View payment analytics",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "audit.read",
        "description": "View payment audit logs",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.read",
        "description": "View payment gateway settings",
        "resourcePattern": null,
        "kind": "api_key_scope"
      },
      {
        "name": "settings.write",
        "description": "Configure payment processing",
        "resourcePattern": null,
        "kind": "api_key_scope"
      }
    ],
    "service_permissions": [
      {
        "name": "transactions:read",
        "description": "View payment transactions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "transactions:write",
        "description": "Process payments and refunds",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "customers:read",
        "description": "View customer payment profiles",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "customers:write",
        "description": "Manage customer payment methods",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "invoices:read",
        "description": "View invoices and billing",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "invoices:write",
        "description": "Create and manage invoices",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "reports:read",
        "description": "View payment reports and analytics",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "payments:create",
        "description": "Create payment or checkout sessions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "payments:read",
        "description": "Read payment and charge state",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "transactions:refund",
        "description": "Refund transactions",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "venues:read",
        "description": "View venue configuration",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "venues:write",
        "description": "Manage venue configuration",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "analytics:read",
        "description": "View payment analytics",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "audit:read",
        "description": "View payment audit logs",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "settings:read",
        "description": "View payment gateway settings",
        "resourcePattern": null,
        "kind": "permission"
      },
      {
        "name": "settings:write",
        "description": "Configure payment processing",
        "resourcePattern": null,
        "kind": "permission"
      }
    ]
  },
  "runtime": {
    "primary_hosts": [],
    "repo_entries": [
      "PlatformApplications/TopoloPay/README.md",
      "PlatformApplications/TopoloPay/admin/",
      "PlatformApplications/TopoloPay/dist-admin/",
      "PlatformApplications/TopoloPay/package-lock.json",
      "PlatformApplications/TopoloPay/package.json",
      "PlatformApplications/TopoloPay/public/",
      "PlatformApplications/TopoloPay/schema.sql",
      "PlatformApplications/TopoloPay/src/",
      "PlatformApplications/TopoloPay/test/",
      "PlatformApplications/TopoloPay/topolo.cloudcontrol.json",
      "PlatformApplications/TopoloPay/tsconfig.json",
      "PlatformApplications/TopoloPay/vitest.config.mts",
      "PlatformApplications/TopoloPay/worker-configuration.d.ts",
      "PlatformApplications/TopoloPay/wrangler.jsonc"
    ],
    "wrangler_surfaces": [],
    "packages": [
      {
        "path": "PlatformApplications/TopoloPay/admin/package.json",
        "name": "@topolo/pay-admin",
        "scripts": [
          "dev",
          "build",
          "lint",
          "preview"
        ],
        "scriptCommands": [
          {
            "name": "dev",
            "command": "vite"
          },
          {
            "name": "build",
            "command": "tsc -b && vite build"
          },
          {
            "name": "lint",
            "command": "eslint src --ext .ts,.tsx"
          },
          {
            "name": "preview",
            "command": "vite preview"
          }
        ]
      },
      {
        "path": "PlatformApplications/TopoloPay/package.json",
        "name": "topolo-pay",
        "scripts": [
          "deploy",
          "build",
          "deploy:dry-run",
          "dev",
          "dev:admin",
          "build:admin",
          "start",
          "test",
          "cf-typegen"
        ],
        "scriptCommands": [
          {
            "name": "deploy",
            "command": "npm run build:admin && wrangler deploy"
          },
          {
            "name": "build",
            "command": "npm run build:admin"
          },
          {
            "name": "deploy:dry-run",
            "command": "npm run build:admin && wrangler deploy --dry-run --outdir .wrangler/build"
          },
          {
            "name": "dev",
            "command": "wrangler dev"
          },
          {
            "name": "dev:admin",
            "command": "cd admin && npm run dev"
          },
          {
            "name": "build:admin",
            "command": "cd admin && npm install && npm run build"
          },
          {
            "name": "start",
            "command": "wrangler dev"
          },
          {
            "name": "test",
            "command": "vitest"
          },
          {
            "name": "cf-typegen",
            "command": "wrangler types"
          }
        ]
      }
    ]
  },
  "data": {
    "env_vars": [],
    "bindings": [],
    "queue_bindings": [],
    "storage_kinds": [],
    "workflow_signals": []
  },
  "deployment": {
    "commands": [
      {
        "name": "build",
        "command": "PlatformApplications/TopoloPay/admin/package.json :: tsc -b && vite build"
      },
      {
        "name": "preview",
        "command": "PlatformApplications/TopoloPay/admin/package.json :: vite preview"
      },
      {
        "name": "deploy",
        "command": "PlatformApplications/TopoloPay/package.json :: npm run build:admin && wrangler deploy"
      },
      {
        "name": "build",
        "command": "PlatformApplications/TopoloPay/package.json :: npm run build:admin"
      },
      {
        "name": "deploy:dry-run",
        "command": "PlatformApplications/TopoloPay/package.json :: npm run build:admin && wrangler deploy --dry-run --outdir .wrangler/build"
      },
      {
        "name": "build:admin",
        "command": "PlatformApplications/TopoloPay/package.json :: cd admin && npm install && npm run build"
      }
    ],
    "routes": [],
    "environments": [],
    "assets_directories": [],
    "observability_enabled": false
  },
  "debugging": {
    "failure_modes": [
      "No primary host is registered in the system registry.",
      "No wrangler.toml surface was discovered under the registered repo paths."
    ],
    "entrypoints": [
      "PlatformApplications/TopoloDocs/src/content/public/applications/pay.mdx",
      "PlatformApplications/TopoloPay/README.md",
      "PlatformApplications/TopoloPay/admin/package.json",
      "PlatformApplications/TopoloPay/package.json"
    ]
  }
}