FREEDOM251

Freedom251 › Payroll APIs

Payroll Engine

Free plan APILinuxMacSelf-hostedWebWindows

Visit Payroll Engine Alternatives Pricing

Payroll Engine's own site

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

PlanBilled and limitsPrice
Open-source frameworkMIT licensed framework · no per-employee fees or runtime licenses · country regulations are commercialFree

As payrollengine.org lists them, read 9 Oct 2026. The maker's own page has the final word.

Getting started

  1. Visit the Payroll Engine website.
  2. Choose a supported environment: Linux, macOS, Windows, web, API, or self-hosted.
  3. Provide a database separately.
  4. Run the backend locally or through Docker Compose.
  5. Configure authentication and audit trails as needed; both are disabled by default.
  6. 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

Look at these too