Payroll Runs

Role: Company Admin
Portal: Actnation company portal
Prerequisites: The company uses Payroll Giving. Funded Payroll Giving can use a manual run when it has no active Zenegy connection; Payroll Giving only requires a connected Zenegy payroll system.

Purpose

The Payroll Runs page lets you manually process payroll and review previous runs for companies whose employees have made donations.

Run payroll

1. Go to Company → Payroll Runs.
2. Confirm that at least one company employee has made a donation.
3. Select Run Payroll and confirm the action.
4. Review the latest run status and payroll run history.

The Run Payroll button is disabled when no company employee has made a donation. It can also be disabled while another run is active or during the cooldown period after a completed run.

Payroll Giving only runs

Payroll Giving only is Zenegy-triggered only. The manual Run New / Re-run button is always hidden, including while a connection request is pending. You can still review payroll-run status and history. A completed Zenegy run processes employee-funded donation statuses, payroll invoices and payments, and recurring monthly donations. Company-funded leftover distribution, contribution-model switching, balance calculation, and budget adjustment do not apply.

Automatic subscription adjustments

Every funded Payroll Giving run — whether triggered here or synced automatically from Zenegy — also checks each employee's active subscriptions against their current monthly budget. If a budget reduction means an employee's subscriptions now add up to more than their new budget allows, each affected subscription is scaled down proportionally so the total fits. Affected employees are emailed their updated amounts. If your company has a contact email on file (Company → Settings → Company), your company also receives a summary email listing every employee whose subscriptions were adjusted. Payroll Giving only runs do not perform this budget-adjustment step. See Managing Your Donations for the employee-facing view.

Troubleshooting

Problem	What to do
Run Payroll is disabled because there are no donations	Wait until a company employee has made a donation.
Run Payroll is disabled after a completed run	Wait until the displayed cooldown period has ended.
Payroll run fails	A later valid Zenegy webhook reuses the company's failed Zenegy run and resumes it from the failed step. The new webhook is recorded as a rejected audit row that references the retried payroll-run ID. Review the latest status and contact support if the retry does not resolve the issue.
A Zenegy payroll run is rejected	Verify the Zenegy connection, giving mode, and whether another payroll run is active. If a webhook cannot create a new run after its company is identified, it is recorded as a rejected audit row. The rejection details retain the error message, Zenegy webhook identifiers, and any existing payroll-run ID involved. A webhook received while a run is pending or in progress is logged and enqueues the existing run again, allowing a pending run to recover if its original background job was not queued. Payroll-run locking prevents duplicate processing. Rejected audit rows are retained for administrators, but are not shown on this page, processed, or included when determining the latest run and cooldown period.
A Zenegy webhook references an unknown company	No payroll run or rejected audit row can be created without an internal company ID. Actnation sends the developer mailbox an alert containing the environment, Zenegy company UID, payroll-run UID, and lookup failure, then acknowledges the webhook to prevent repeated delivery attempts.