Skip to main content

Payroll Notification Integration

Summary

Payroll emits freeze and payslip events; Notification Service owns recipient resolution, templates, channels, and delivery.

Audience

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

Overview

Payroll emits freeze and payslip events; Notification Service owns recipient resolution, templates, channels, and delivery.

Technical Detail

Supported coverage

Confirmed notification-oriented coverage includes a tenant-wide Payroll-frozen intent and an employee-targeted payslip-generated intent. Payroll-calculated and Payroll-unfrozen notification delivery are not confirmed.

Ownership

Payroll owns business event creation and outbox persistence. Notification Service resolves supported events into notification intents and owns templates and delivery channels. Payroll does not call a notification endpoint synchronously.

Consistency and retry

The boundary is eventually consistent and depends on outbound publication and Notification processing. Payroll-side automatic outbox relay requires confirmation; delivery retry and dead-letter behavior belong to Notification/messaging documentation.

Source References

  • microservices/src/contracts/Events/PayrollCalculatedEvent.cs
  • microservices/src/contracts/Events/PayslipGeneratedEvent.cs
  • microservices/src/notification-service/Application/EventNotificationResolver.cs
  • microservices/src/payroll-service/Application/PayrollCalculationService.cs
  • microservices/src/payroll-service/Application/PayrollOutputsService.cs

See Also

Keywords

  • Payroll Service
  • Payroll Notification Integration
  • Technical architecture

Revision Information

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