Application API

Topolo Pay

Clear API and contract surface for Topolo Pay, grouped under the application instead of split across generic reference sections.

curated srv_DJInUxp0dLLi

Documentation Map

Authority

Service IDs:

srv_DJInUxp0dLLi

Repos: PlatformApplications/TopoloPay

Hosts:

https://pay.topolo.app https://topolo-pay.topolo.workers.dev https://topolo-pay-staging.topolo-staging.workers.dev

Dependencies: topolo-auth, topolo-nexus, topolo-p2p, applications-packages

Depends on Topolo Auth: yes

Contract Source

Type: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/pay.mdx

Source exists: yes

Canonical public and internal docs cover the payment worker, local webhook boundary, Nexus-routed outbound payment operations, the authenticated `GET /api/widget` live-workspace endpoint for TopoloOne, code-exchange-only admin SSO with in-memory access-token handling, and the worker-owned `/login` redirect that must run before the SPA fallback. TopoloPay is also the only Stripe-mutating service for TopoloP2P settlement batches; P2P submits typed settlement requests to Pay and receives Pay status callbacks.

API key scopes in Auth catalog: 18

Auth Requirements

No global OpenAPI security scheme is declared.

  • analytics.read
  • audit.read
  • customers.read
  • customers.write
  • dashboard.read
  • invoices.read
  • invoices.write
  • payments.create
  • payments.read
  • reports.read
  • settings.read
  • settings.write
  • settlements.write
  • transactions.read
  • transactions.refund
  • transactions.write
  • venues.read
  • venues.write

Runtime and Deployment

Wrangler surfaces: none detected

Environment variables: none derived

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit signal found

README-Derived Interface Surface

Source: PlatformApplications/TopoloPay/README.md

No route-level highlights were extracted from the current README.

Package Surfaces

@topolo/pay-admin

No package description recorded.

Source: PlatformApplications/TopoloPay/admin/package.json

Scripts: dev, build, lint, typecheck, preview

topolo-pay

No package description recorded.

Source: PlatformApplications/TopoloPay/package.json

Scripts: deploy, deploy:staging, build, deploy:dry-run, deploy:dry-run:staging, dev, dev:admin, build:admin, build:admin:staging, start, test, cf-typegen

Runtime Surface

Wrangler surfaces: No wrangler file detected in scanned surface

This application does not yet have a source-controlled OpenAPI spec in the docs platform. The current API page is derived from the registered contract source and repository surface.

Failure modes

  • No wrangler.toml surface was discovered under the registered repo paths.