Payroll Events Documentation
Summary
Payroll publishes four shared integration contracts and consumes 11 upstream projection events. No Payroll domain events are implemented, and end-to-end delivery remains Transitional.
Audience
Payroll and integration developers, QA and support engineers, solution and security architects, and implementation partners.
Overview
This section documents confirmed contracts, mappings, producers, consumers, transactional boundaries, idempotency, ordering, retry, versioning, and integration tests without exposing broker topology or sensitive payloads.
Confirmed inventory
- Domain events: zero; Not implemented.
- Outbound integration contracts: four, all schema version 1.
- Inbound Payroll projection subscriptions: 11.
- Confirmed downstream consumer services: Document, Notification, Platform.
- Outbox mapping: shared JSON serializer to Payroll outbox.
- Exactly-once delivery: not claimed.
Documentation map
- Payroll Event Overview
- Payroll Domain Events
- Payroll Integration Events
- Payroll Event Publishing Flow
- Payroll Outbox and Delivery
- Payroll Event Consumer Landscape
- Payroll Calculation Events
- Payroll Freeze Events
- Payroll Unfreeze Events
- Payroll Payslip Events
- Payroll Projection Events
- Payroll Notification Events
- Payroll Document Events
- Payroll Event Contract Versioning
- Payroll Event Idempotency and Ordering
- Payroll Event Retry and Failure Handling
- Payroll Event Catalog
- Payroll Event Integration Testing Guide
Status
The outbox store and processor foundation are present, but an active Payroll-hosted relay invocation, Payroll-specific dead-letter flow, formal partition ordering, and tenant-context propagation require confirmation.
Source References
microservices/src/contracts/Events/IntegrationEvent.csmicroservices/src/contracts/Events/PayrollCalculatedEvent.csmicroservices/src/contracts/Events/PayslipGeneratedEvent.csmicroservices/src/payroll-service/Application/PayrollCalculationService.csmicroservices/src/payroll-service/Application/PayrollOutputsService.csmicroservices/src/shared-kernel/Outbox/IntegrationEventJsonSerializer.csmicroservices/src/shared-kernel/Outbox/OutboxMessage.csmicroservices/src/shared-kernel/Messaging/OutboxProcessor.csmicroservices/src/payroll-service/Infrastructure/Persistence.csmicroservices/src/payroll-service/Program.csmicroservices/src/payroll-service/Messaging/PayrollReadModelConsumer.csmicroservices/src/payroll-service/Domain/PayrollEntities.csmicroservices/src/document-service/Messaging/DocumentReadModelConsumer.csmicroservices/src/notification-service/Application/EventNotificationResolver.csmicroservices/src/notification-service/Messaging/NotificationEventConsumer.csmicroservices/src/platform-service/Messaging/PlatformEventConsumer.csmicroservices/src/integration-service/Domain/IntegrationEntities.cs
Related Articles
See Also
Keywords
- Payroll events
- Integration contracts
- Transactional outbox
Revision Information
- Status: Draft
- Last reviewed: 2026-07-15
- Review cycle: Quarterly