Payroll Engine

What Payroll Engine is
Payroll Engine is an open-source framework for embedding payroll processing into larger software platforms. Its backend uses a REST API and configurable regulation layers to process time-stamped payroll data, including recurring and non-recurring payruns. It can produce payslip, legal-filing, and data-exchange reports. The framework is released under the MIT License, while country regulations are commercial.
The API supports tenant and employee management, payrun jobs, result queries, report output, and backend event webhooks. A browser-based application can manage tenants, employees, regulations, case data, payruns, reports, tasks, and developer logs. Developers can use a .NET Client SDK with typed REST clients, test runners, local script tools, and JSON schemas for regulation validation. A built-in test framework supports case validation, payrun assertions, and regression testing. The backend is designed for local or Docker Compose deployment, and requires a separately provided database. API key and OAuth authentication are supported but disabled by default; configurable audit trails are also disabled by default. The maker says the backend should not be used on the public Internet.
Who it suits
The maker identifies HR-tech and EOR platforms, payroll consultants and HR specialists, and DevOps or integration engineers as its main audiences. It suits teams embedding payroll processing in a larger platform.
What it does well
- REST API supports tenant and employee management.
- Handles recurring and non-recurring payruns.
- Includes testing tools for validation and regression testing.
- Offers a browser-based management application.
- Released under the MIT License.
What to know first
- Country regulations are commercial.
- A database must be provided separately.
- Authentication and audit trails are disabled by default.
- Maker says not to use the backend on the public Internet.
Limits
The framework is open source under the MIT License, but country regulations are commercial. The database must be provided separately; authentication and audit trails are disabled by default.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Open-source framework | MIT licensed framework · no per-employee fees or runtime licenses · country regulations are commercial | Free |
As payrollengine.org lists them, read 9 Oct 2026. The maker's own page has the final word.
Getting started
- Visit the Payroll Engine website.
- Choose a supported environment: Linux, macOS, Windows, web, API, or self-hosted.
- Provide a database separately.
- Run the backend locally or through Docker Compose.
- Configure authentication and audit trails as needed; both are disabled by default.
- Use the REST API, browser application, or .NET Client SDK.
Payroll Engine is a framework for teams embedding payroll processing in their own software. It suits HR-tech and EOR platforms, payroll specialists, and integration engineers; it is a poor fit for organizations seeking a ready-to-use payroll service.
Its API, regulation layers, and developer tools support custom payroll workflows, but teams must operate the backend, provide a database, and obtain country regulations commercially.
Overview
Released under the MIT License, Payroll Engine processes payroll data through a REST API with configurable regulation layers. It handles time-stamped data and recurring or one-off payruns, and can produce reports for payslips, legal filings, or data exchange. That makes it a flexible building block for a larger product, not a complete payroll offering that removes the need to assemble and operate a service around it.
The framework is open source, but country regulations are commercial. That distinction matters: the license does not mean the regulatory content needed for a deployment is free. The backend is designed to run locally or through Docker Compose, and the adopter must provide a database separately.
Key features
The REST API covers tenant and employee management, payrun jobs, result queries, report output, and backend event webhooks. This breadth gives integration engineers ways to connect payroll operations to their platform, while leaving the surrounding product experience and deployment to the adopting team.
Payroll data can be time-stamped, and the engine supports recurring and non-recurring payruns. Its reports serve payslips, legal filings, and data exchange, making it relevant to teams that need payroll outputs within an existing workflow rather than a standalone payroll portal.
A built-in test framework supports case validation, payrun assertions, and regression testing. For teams maintaining payroll rules over time, these tools provide a way to check changes and calculations; they do not replace the need for someone to configure and validate the rules.
The .NET Client SDK includes typed REST clients, test runners, local script development tools, and JSON schemas for regulation validation. A browser-based application can manage tenants, employees, regulations, case data, payruns, reports, tasks, and developer logs. These tools give technical and payroll specialists a substantial working surface, but the product remains oriented toward teams able to integrate and operate it.
Pricing
Payroll Engine is free and open source under the MIT License. There are no paid plans or published seat or usage quotas in the stated pricing model. The important cost caveat is that country regulations are commercial, so teams should account for those separately when assessing a production deployment.
Platforms
Payroll Engine supports API, Linux, macOS, self-hosted, web, and Windows. Its backend is intended to run locally or through Docker Compose, with a separately provided database. The maker says the backend is a service and should not be used on the public Internet; authentication is disabled by default. API key and OAuth authentication are supported, so teams need to address access controls before deploying it.
Audit trails can be configured by category, but are disabled by default. That means adopters responsible for compliance or operational review need to configure auditing rather than assume it is active out of the box.
Who it's for
Payroll Engine is aimed at HR-tech and EOR platforms, payroll consultants and HR specialists, and DevOps or integration engineers. It is most appropriate when a team wants to embed payroll processing and has the technical capacity to configure regulations, provide infrastructure, and manage security. Companies wanting a managed payroll service rather than a framework should look elsewhere.
Questions and feature requests go to GitHub Discussions, while bug reports go to GitHub Issues; the project asks users to allow a few business days for responses.
Pros and cons
- Pro: The MIT-licensed framework and broad REST API offer a flexible foundation for embedding payroll workflows in another platform.
- Pro: Case validation, payrun assertions, regression testing, and .NET development tools support teams maintaining custom payroll rules.
- Con: Country regulations are commercial, so the free framework alone does not cover the full cost of regulatory content.
- Con: The adopter must supply a database and operate the backend; authentication and audit trails are disabled by default, and the backend should not be exposed to the public Internet.
Alternatives
PHPPayroll is worth considering for teams that want a self-hosted, open-source payroll option with a free edition and free trial. Its Open-Source Edition is free, with no license fees or monthly charges and full source-code access.
BIPO HRMS Payroll is an alternative for organizations seeking a paid payroll product with Android, API, iOS, and web platforms; its maker offers a free demo. Ramco Enterprise Asset Management is another paid option, with pricing that varies by installation type and industry requirements.
Rippling may suit teams considering a paid platform whose products can be purchased separately, though its Core Rippling Platform is required and most products are billed per employee per month, with some carrying a monthly base. RUN Powered by ADP offers paid payroll plans including payroll processing, tax filing, direct deposit, employee access, and multi-jurisdiction payroll in Essential Payroll; Select is a payroll and HR suite.
iiPay Global Payroll Platform is a paid, fully managed end-to-end payroll option across 170+ countries. Neeyamo Payroll offers paid fully managed payroll with a helpdesk and reports and dashboards. Mercans G2N is another paid API and web option.
For a broader comparison, browse Global Payroll Software.
Verdict
Choose Payroll Engine if you are building payroll into a larger platform and can take responsibility for integration, infrastructure, regulation sourcing, and secure configuration. Its open framework and developer tooling are compelling for that job. Look elsewhere if you need a turnkey or managed payroll service, or if you cannot keep the backend off the public Internet and configure authentication and auditing yourself.
Verdict
Payroll Engine offers a configurable framework and developer tools for embedding payroll processing, but deployment and security settings need attention. Its maker explicitly says not to expose the backend to the public Internet.
Questions
Is Payroll Engine open source?
The framework is released under the MIT License. Country regulations are commercial.
What does it cost?
The framework is listed as free and open source. Country regulations are commercial.
What platforms does it support?
Listed platforms are API, Linux, macOS, self-hosted, web, and Windows.
What can the API do?
It supports tenant and employee management, payrun jobs, result queries, report output, and backend event webhooks.
Does it include authentication and audit trails?
The backend supports API key and OAuth authentication, but authentication is disabled by default. Audit trails can be configured by category and are also disabled by default.
Who is Payroll Engine for?
The maker identifies HR-tech and EOR platforms, payroll consultants and HR specialists, and DevOps or integration engineers as its main audiences.
Facts from Payroll Engine's own pages
- Commercial limits
- The framework is MIT licensed, while country regulations are commercial and offered through the companion payrollex.io marketplace. · payrollengine.org, 9 Oct 2026
- Commercial regulations
- The framework is open source, while country regulations are commercial. · payrollengine.org, 4 Oct 2026
- Compliance and audit
- Audit trails can be configured by category and are disabled by default. · payrollengine.org, 4 Oct 2026
- Deployment
- The maker distributes pre-built Docker images for the backend, web app, and Payroll Console, with the full stack started using Docker Compose. · payrollengine.org, 9 Oct 2026
- Developer tooling
- The Client SDK supports JSON and Excel payroll or regulation import/export, test runners, bulk operations, and CLI extensions. · payrollengine.org, 9 Oct 2026
- Developer tools
- The .NET Client SDK provides typed REST clients, test runners, local script development tools, and JSON schemas for regulation validation. · payrollengine.org, 4 Oct 2026
- Features
- The engine supports time-stamped payroll data, recurring and non-recurring payruns, and reports for payslips, legal filings, or data exchange. · payrollengine.org, 4 Oct 2026
- Forecasts
- Forecasts support isolated what-if scenarios that do not affect legally valid payruns. · payrollengine.org, 9 Oct 2026
- Founded
- 2018 · payrollengine.org, 19 Oct 2026
- Headquarters
- Switzerland (author's location; no company headquarters stated) · payrollengine.org, 19 Oct 2026
- Integration
- A REST API is the programmatic integration surface, and a .NET Client SDK supports automation workflows. · payrollengine.org, 9 Oct 2026
- Integrations
- The REST API supports tenant and employee management, payrun jobs, result queries, report output, and backend event webhooks. · payrollengine.org, 4 Oct 2026
- Intended users
- The maker identifies HR-tech and EOR platforms, payroll consultants and HR specialists, and DevOps or integration engineers as its main roles. · payrollengine.org, 9 Oct 2026
- License
- The framework is released under the MIT License. · payrollengine.org, 4 Oct 2026
- Payroll processing
- Its backend processes payroll data through a REST API using configurable regulation layers. · payrollengine.org, 4 Oct 2026
- Payroll workflow
- It captures wage-relevant case data, calculates employee wages in payruns, and generates reports such as payslips and legal filings. · payrollengine.org, 9 Oct 2026
- Product
- Payroll Engine is an open-source framework for embedding payroll processing into larger software platforms. · payrollengine.org, 9 Oct 2026
- Regulation layers
- Payroll rules are configurable, versioned layers that can be combined and shared across tenants. · payrollengine.org, 9 Oct 2026
- Security
- The maker warns that the backend should not be used on the public Internet and documents None, API key, and OAuth authentication modes. · payrollengine.org, 9 Oct 2026
- Security limit
- The maker says the backend is a service and should not be used on the public Internet. · payrollengine.org, 4 Oct 2026
- Support
- Questions and feature requests go to GitHub Discussions, bugs to GitHub Issues, and the maker asks users to allow a few business days for responses. · payrollengine.org, 9 Oct 2026
- Testing
- A built-in test framework supports case validation, payrun assertions, and regression testing. · payrollengine.org, 4 Oct 2026
- Testing and scripting
- The engine supports No-Code case actions, C# scripting, and automated tests for case data, payruns, and report results. · payrollengine.org, 9 Oct 2026
- Time-aware records
- Changes are stored as time-stamped case values with validity periods, enabling retrospective recalculation and audit history. · payrollengine.org, 9 Oct 2026
Where Payroll Engine stands on Freedom251
- Payroll APIs#1 of 32
- Global Payroll Software#2 of 29
