T Topolo Docs

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:

Hosts:

https://pay.topolo.app https://pay.topolo.app https://pay.stg.topolo.us

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: no

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 resolves its environment-specific Auth service id from the Auth-owned service slug `topolo-pay` at runtime and exposes that identity through `GET /api/service-identity`; concrete production or staging `srv_*` ids are not app source constants. TopoloPay is also the only Stripe-mutating service for TopoloP2P settlement batches; P2P submits typed settlement requests to Pay and receives Pay status callbacks. Staging deploys build the admin bundle with `npm run build:admin:staging` and require explicit `AUTH_API_URL`, `NEXUS_GATEWAY_URL`, and `PAY_APP_URL` bindings so the staging worker fails closed instead of falling back to production hosts.

API key scopes in Auth catalog: 20

Auth Requirements

No global OpenAPI security scheme is declared.

  • analytics.read
  • audit.read
  • customers.read
  • customers.write
  • dashboard.read
  • invoices.read
  • invoices.write
  • merchants.read
  • merchants.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

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.
  • The registered contract source is missing: PlatformApplications/TopoloDocs/src/content/public/applications/pay.mdx
  • Neither OpenAPI nor README-derived interface detail was found.