Skip to calculation changelog
Transparent calculation maintenance

Payroll Calculation Changelog

See when PayStubCheck changes payroll calculation rules, source coverage, year-to-date handling, tolerances, statutory caps, or review methods used by the Pay Stub Calculation Checker.

Why publish a payroll calculation changelog?

Payroll rules change. Tax agencies revise withholding methods, annual wage bases and contribution ceilings move, provincial and state guidance is updated, and software defects can be corrected. A calculation result is more useful when a recipient can see not only the result, but also which ruleset and calculation approach produced it.

This page records material calculation changes that can affect PayStubCheck review results. It complements the Pay Stub Calculation Checker methodology and coverage matrix, where you can inspect current source provenance, confidence labels, evidence requirements, and jurisdiction coverage.

Release history

Material calculation changes

Entries are written for reviewers and recipients first, with technical identifiers available when they improve auditability.

30 AUG2026

Time-Card / Clock Rounding Calculator added

New browser-only timecard comparison surface for showing the arithmetic effect of nearest-5-minute, nearest-6-minute (one-tenth-hour), and nearest-15-minute rounding across multiple work intervals.

New payroll tool
Per-punch rounding exposed

Each clock-in and clock-out is rounded independently before the elapsed rounded interval is compared with exact elapsed time. The result table preserves exact punches, rounded punches and the difference for every entered interval.

Common federal intervals only

The public calculator supports nearest five minutes, one-tenth of an hour (six minutes), and one-quarter hour (15 minutes), matching the common intervals described in federal time-rounding guidance.

Cumulative sample effect

The tool totals upward and downward interval effects across the entered sample instead of treating one punch as dispositive. Output is descriptive: up, down or neutral for the sample, never compliant/noncompliant.

Overnight intervals supported

When clock-out is earlier than or equal to clock-in, the calculator treats the interval as ending the following day, with a 24-hour maximum interval guard.

Optional pay illustration

An optional hourly rate can translate the net time difference into a simple pay difference. It deliberately excludes overtime, differentials, minimum wage, state rules and other premium-pay calculations.

Browser-only time values

Clock punches, hourly rates and calculated differences remain in the browser. Analytics are limited to non-sensitive product-use categories such as rounding interval, interval count and sample direction.

Federal source and scope

The page cites the U.S. Department of Labor Hours Worked Advisor, Fact Sheet #53 and rounding guidance under 29 CFR 785.48(b). The calculator does not decide whether time is compensable or whether a rounding practice satisfies federal, state or local law.

30 AUG2026

Final Paycheck Calculator added

New U.S. arithmetic surface for totaling final-period wages and other final-pay components without silently deciding state payment deadlines, PTO entitlement, salary proration, overtime classification, or lawful deductions.

New payroll tool
Two wage-entry paths

Hourly users can enter straight-time hours and rate plus an overtime rate they have already determined. Salary and other scenarios can instead use a final-period wage amount already determined outside the calculator.

Optional final-pay components remain explicit

Unused leave payout, earned bonus or commission amounts, other included final-pay amounts, tax withholding and deductions are separate inputs rather than hidden assumptions.

No final-pay deadline engine

The calculator does not infer a payment due date. The public methodology points users to U.S. Department of Labor federal guidance and state labor offices because state final-pay timing can differ.

No PTO entitlement assumption

Federal law does not itself require vacation pay. PTO enters the arithmetic only when the user supplies both an applicable number of hours and payout rate already determined under the relevant rule or policy.

Browser-only wage values

Entered wages, hours, PTO, withholding, deductions and calculated final-pay amounts remain in the browser. Analytics are restricted to non-monetary product-use metadata.

Specialty calculations stay specialized

Weighted overtime, shift differentials, bonus true-ups and retroactive rate corrections remain in their dedicated tools rather than being reimplemented inside final-pay arithmetic.

Federal source and scope

The page cites the U.S. Department of Labor Last Paycheck guidance, the FLSA Handy Reference Guide and DOL state labor-office directory. It is an arithmetic estimator, not a state-law final-pay, entitlement, deduction, tax or penalty calculator.

30 AUG2026

Retro Pay & Rate Correction Calculator added

New U.S. payroll calculation surface for modeling a positive backdated hourly-rate correction, with workweek-specific federal overtime treatment rather than averaging hours across the retroactive period.

New payroll tool
Focused hourly-rate correction

The calculator compares the original hourly rate with a higher corrected hourly rate and applies the difference to the affected hours. It is intentionally limited to a simple single-rate correction rather than attempting to classify every form of back pay.

Workweeks remain separate

Users enter each affected workweek individually. Federal overtime hours are modeled as hours over 40 in each workweek; the tool does not average hours across multiple weeks in the retroactive period.

Overtime adjustment exposed

The result separates the straight-time rate difference from the additional half-time amount attributable to the rate increase on federal overtime hours. In the simple single-rate model, each overtime hour receives 1.5 times the hourly rate increase overall.

Complex compensation routed elsewhere

Multiple rates, shift differentials, deferred bonuses, commissions and other regular-rate compensation are outside this narrow model. The page links users to the Weighted Overtime, Shift Differential and Bonus Overtime True-Up tools instead.

Federal scope stated explicitly

The calculator does not determine FLSA coverage or exemption status and does not calculate state daily overtime, double time, wage-payment penalties, interest, damages, tax withholding or contract-specific rules.

Browser-only payroll values

Entered rates, workweek hours and calculated retro-pay amounts remain in the browser. Analytics are limited to non-payroll metadata such as workweek count and whether the scenario includes federal overtime hours.

Federal source basis

The public methodology cites 29 CFR § 778.303, the U.S. Department of Labor Field Operations Handbook Chapter 32, and DOL Fact Sheet #23. These sources describe retroactive pay increases, allocation to prior workweeks and the basic federal workweek overtime framework.

30 AUG2026

Shift Differential Pay Calculator added

New U.S. payroll calculation surface for converting flat-dollar or percentage shift premiums into differential pay, effective shift rates, and a focused federal weekly regular-rate overtime view.

New payroll tool
Two differential formats

Each shift can use a fixed dollar amount per hour or a percentage of the entered base hourly rate. The calculator converts both formats into a per-hour premium and total differential amount.

Shift-by-shift transparency

Up to five shift categories can be modeled in one workweek, including standard hours with a zero premium. Results expose base earnings, differential pay, effective shift rates and total straight-time compensation.

Shared overtime calculation

When the entered week exceeds 40 hours, the focused page reuses the existing Weighted Overtime regular-rate module rather than creating a separate overtime engine.

Browser-only payroll values

Base rates, shift-premium values, hours and calculated wage amounts remain in the browser. Analytics are limited to safe product-use categories such as row count, differential type and whether overtime is present.

Calculation source and scope

The public methodology cites U.S. Department of Labor Fact Sheet #54 for shift-differential overtime examples, Fact Sheet #56A for the federal regular-rate framework, and 29 CFR Part 778. The tool does not classify employees or apply state daily-overtime and special-industry rules.

30 AUG2026

Bonus Overtime True-Up Calculator added

New U.S. payroll calculation surface for modeling additional federal overtime attributable to an includable deferred bonus after the bonus is allocated back across the workweeks in which it was earned.

New payroll tool
Workweek-by-workweek true-up

The calculator isolates the additional overtime attributable to the bonus rather than recomputing or presenting all overtime compensation for the covered period.

Three allocation models

Users can model exact weekly bonus amounts, equal amounts per covered workweek, or an equal amount per hour worked. The page explains that the facts determine which allocation is appropriate.

Federal hours-over-40 baseline

Overtime hours are modeled as hours above 40 in each workweek. The calculator does not classify employees, determine whether the bonus is includable, or apply state daily-overtime and special-industry rules.

Browser-only payroll values

Bonus amounts and workweek hours remain in the browser. Analytics are restricted to non-payroll product-use fields such as allocation method, workweek count and whether overtime is present.

Calculation source and scope

The public methodology cites U.S. Department of Labor Fact Sheet #56C, Wage and Hour Division Field Operations Handbook Chapter 32, and 29 CFR Part 778, including the deferred-bonus allocation framework in 29 CFR 778.209.

30 AUG2026

Weighted Overtime & Regular Rate Calculator added

New U.S. payroll calculation surface for modeling the basic federal regular-rate and weekly overtime calculation when a workweek includes multiple hourly rates or additional includable compensation.

New payroll tool
Multiple-rate workweeks

The calculator combines straight-time wages from up to five hourly rates and divides total includable workweek compensation by total hours worked to determine a weighted regular rate.

Includable compensation

Workweek shift differentials, allocated nondiscretionary bonuses, commissions and other includable pay can be added to the regular-rate numerator. The tool does not independently classify a payment as legally includable or excludable.

Federal weekly overtime model

For hourly scenarios where straight-time compensation already covers every hour worked, the calculator adds one-half of the regular rate for each hour over 40. It does not model state daily overtime, special-industry formulas or exemption status.

Browser-only payroll values

Hourly rates, workweek hours, bonuses, differentials and other entered payroll amounts remain in the browser. Analytics are limited to non-payroll product-use categories.

Calculation source and rounding

The public methodology cites U.S. Department of Labor Fact Sheets #56A and #56C and 29 CFR Part 778. Displayed regular-rate and half-time steps use cent rounding consistent with the Department of Labor's published bonus example.

30 AUG2026

YTD & Payroll Cap Checker added

New recipient-facing entry point for inspecting 2026 annual payroll ceilings and selected year-to-date relationships using generated data from the existing payroll engines.

New recipient tool
U.S. YTD cap review

The focused workflow exposes the 2026 Social Security wage base and employee maximum, base Medicare's uncapped treatment, and the employer Additional Medicare withholding threshold. Where the required wage fields are supplied, supported YTD rate relationships are reconciled with a conservative accumulated-rounding tolerance.

Canadian annual ceilings

The workflow checks CPP/CPP2 or QPP/QPP2 employee maximums, EI premium maximums, and Québec QPIP limits. Québec continues to use its distinct QPP, QPP2, reduced-rate EI and QPIP parameter path.

Proration evidence preserved

CPP/QPP maximums can be lower when contribution months are prorated. When full-year contribution status is not known, an amount below the full-year ceiling is not labeled definitively consistent; the checker returns Unable to determine rather than assuming 12 contribution months.

No second rules engine

The browser dataset is generated from FICA_2026 and the Canadian parameter registry used by the existing authoritative engines. A generation test checks that published cap data continues to match those source-of-truth parameters.

2026 date boundary retained

Pay dates outside 2026 are marked Not evaluated. The tool does not silently reuse 2026 wage bases, contribution ceilings, rates or thresholds for another payroll year.

Browser-only payroll values

Entered YTD wages, taxes and contributions remain in the browser. Analytics are limited to non-payroll metadata such as country, jurisdiction, supported-ruleset state and result counts.

Generated cap-data identifier

The current public cap dataset is identified as psc-payroll-ytd-cap-data-v1 and is generated from the 2026 U.S. FICA configuration plus the Canadian parameter registry and source registries.

30 AUG2026

2026 calculation-review ruleset documented

Initial public calculation record for the Pay Stub Calculation Checker and its U.S./Canada statutory review boundary.

Current ruleset
2026 statutory date boundary

U.S. and Canadian statutory recalculation is limited to pay dates from January 1 through December 31, 2026. Outside that window, arithmetic and continuity checks can still run, but statutory items are marked Not evaluated rather than applying the wrong year's rules.

U.S. coverage recorded

Coverage metadata currently includes all 50 states plus the District of Columbia, together with federal withholding, Social Security and Medicare source provenance where the supplied evidence is sufficient.

Canada coverage recorded

Coverage metadata currently includes all 13 provinces and territories. Québec contribution paths remain distinct: QPP/QPP2, reduced-rate EI and QPIP are evaluated separately from CPP/CPP2 paths.

Printed YTD direction standardized

When a calculation engine requires year-to-date amounts before the current pay period, the review adapter derives prior YTD as printed YTD minus the current-period amount. Invalid negative derived values are not forced into a statutory calculation.

Evidence-sufficiency policy enforced

Missing payroll facts are not invented simply to produce an answer. Where W-4, TD1, age/election, taxable-wage or other required facts are unavailable, the applicable item can return Unable to determine.

Per-check tolerance and provenance

Detailed results can expose the allowed variance, rule effective period, calculation method, confidence level, engine version and official-source links rather than relying on a single universal rounding tolerance.

Technical engine identifiers

Current review adapters may report psc-fica-v2, psc-federal-withholding-v2, psc-state-module-v2, and Canadian engine psc-canada-complete-pay-statement-0.17.1. These identifiers help distinguish implementation versions; source effective dates remain the controlling context for statutory review.

What gets logged here

Not every website change belongs in a calculation changelog. We reserve this record for changes that can alter, expand, constrain, or explain a payroll calculation result.

Rules & thresholds

Tax withholding methods, Social Security wage bases, CPP/QPP or EI/QPIP ceilings, statutory rates, annual limits, and effective-date changes.

Calculation behavior

YTD direction, rounding or variance logic, evidence requirements, pay-frequency treatment, continuity rules, and material calculation bug fixes.

Coverage & sources

Jurisdictions added or removed, source replacements, confidence changes, source-review dates, or changes to what the checker can independently determine.

How to interpret future entries

Each material entry should make it possible to understand what changed and whether an older calculation result might have been affected.

A calculation entry should identify

  • the publication or implementation date;
  • the affected country, jurisdiction, tax or contribution;
  • the effective payroll period when different from the publication date;
  • whether the change modifies a rate, cap, formula, evidence requirement, tolerance, or coverage state;
  • the authoritative source or source family when applicable.

Changes normally excluded

  • visual styling and general copy edits;
  • navigation changes that do not alter calculations;
  • checkout, Stripe, pricing, order or delivery changes;
  • marketing campaigns or unrelated SEO pages;
  • document-template changes that do not alter calculation results.

Official-source and review philosophy

PayStubCheck's calculation review is designed around authoritative payroll sources and explicit evidence requirements. U.S. federal review can rely on IRS and Social Security Administration material, while state calculations use jurisdiction-specific source registries. Canadian review uses CRA, Revenu Québec and applicable provincial or territorial source material represented in the calculation engine's source registry.

The current U.S. coverage matrix and Canadian coverage matrix are generated from active calculation-source metadata. The matrix is the better place to inspect present coverage; this changelog is the historical record of material changes to that coverage or behavior.

Review a pay stub with the current ruleset

Use Quick Check for arithmetic reconciliation, Detailed Review for supported statutory calculations, or Compare Pay Stubs for multi-statement continuity.

Open Pay Stub Checker →