Skip to main content

Employer Dashboard

The employer application lives under /dashboard. It combines operational routes for payroll admins with a developer-facing API access section for machine clients.

Route map

RoutePurposePrimary data sources
/dashboardOverview page with treasury, team, yield, and payroll summary cardsSupabase, YieldRouter, payment_items, payroll_runs
/dashboard/teamTeam roster and CSV import entry pointemployees
/dashboard/team/addAdd-employee flowemployees, invite and KYC APIs
/dashboard/team/[id]Individual employee detailsemployees, compliance state
/dashboard/payrollPayroll history surfacepayroll_runs
/dashboard/payroll/newPayroll creation wizardemployees, payroll prep APIs
/dashboard/payroll/[runId]Single payroll run detailpayroll_runs, payment_items
/dashboard/treasuryTreasury balance, deposits, yield, and transaction historyPayrollTreasury, YieldRouter, payment_items
/dashboard/treasury/depositFunding instructions and deposit readinessemployers, Bridge virtual-account state, treasury hints
/dashboard/cardsEmployer-managed employee card programemployees, /api/employees/[id]/card
/dashboard/complianceKYC and TIP-403 review surfaceemployees, compliance_events, TIP-403
/dashboard/api-accessMPP pricing, receipts, sessions, and agent demompp_sessions, MPP routes
/dashboard/settingsOrganization profile and controlsemployers
/dashboard/settings/billingSubscription, payroll volume, and MPP spendemployers, payroll_runs, mpp_sessions
/dashboard/demoDemo agent experience/api/demo/run-agent SSE

Core employer workflows

Team onboarding

  1. Create an employer record through POST /api/employers.
  2. Add employees through POST /api/employees or POST /api/employers/[id]/team.
  3. Generate employee KYC links through POST /api/employees/[id]/kyc.
  4. Track employee onboarding, wallet creation, and KYC state from the team and compliance routes.

Payroll preparation

POST /api/employers/[id]/payroll is the pre-flight route. It does four jobs:
  1. Checks employer treasury balance in PayrollTreasury
  2. Runs TIP-403 authorization checks for every recipient wallet
  3. Builds 32-byte payroll memos
  4. Persists the draft run and payment items in Supabase
The route returns unsigned calldata so the frontend can hand execution to the user wallet. The machine-paid path is documented separately under MPP Endpoints.

Treasury

/dashboard/treasury reads live treasury and yield state, then combines it with transaction history. The page depends on:
  • GET /api/employers/[id]/treasury
  • GET /api/yield
  • transaction queries and realtime invalidation hooks

API access

The API access section is the operator console for machine clients. It surfaces:
  • MPP route pricing
  • Session history
  • Recent receipts
  • The live demo agent terminal

Additional dashboard behavior

  • Team management includes CSV import, filters, column visibility, and row actions for salary updates, manual review holds, and removal.
  • Team detail includes overview, payment history, and compliance tabs plus employer actions and card issuance when Bridge prerequisites are satisfied.
  • API Access includes one-time agent key generation, receipt history, session history, and the live demo terminal.