Skip to main content

Payroll Gateway Interaction

Summary​

The gateway controls whether Payroll compatibility traffic remains on the monolith or moves to Payroll Service, while a shadow/native surface supports verification.

Audience​

Backend and frontend developers, QA and DevOps engineers, support and security engineers, and solution architects.

Overview​

The gateway controls whether Payroll compatibility traffic remains on the monolith or moves to Payroll Service, while a shadow/native surface supports verification.

Technical Detail​

Routing ownership​

Payroll-compatible route families are classified by the gateway. A cutover setting selects monolith or Payroll Service ownership, and route-source evidence supports smoke verification. Shared route families receive finer-grained ownership. Exact route tables and toggle names are intentionally excluded.

Cutover and rollback​

Source-backed scripts verify off-path and on-path routing, compatibility behavior, parity, and rollback. The current switch is gateway-wide rather than tenant-staged. Write reconciliation during rollback is an explicit Transitional concern.

Authentication forwarding​

The gateway forwards request and correlation context. Payroll Service source does not establish a complete independent authorization policy pipeline, so downstream authentication and authorization enforcement Require confirmation before direct exposure.

Source References​

  • microservices/src/gateway-api/Program.cs
  • microservices/src/payroll-service/Api/PayrollCompatEndpoints.cs
  • microservices/scripts/smoke-payroll-cutover.ps1
  • microservices/scripts/compare-payroll-parity.ps1
  • microservices/scripts/payroll-cutover-go-no-go.ps1

See Also​

Keywords​

  • Payroll Service
  • Payroll Gateway Interaction
  • Technical architecture

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly