GuidesAPI ReferenceChangelogAPI PolicyAPI StatusGusto Security

Payroll Statuses

Status:UnprocessedSubmittedPendingPaid
DescriptionA payroll's default state when it is first created.Payroll has been submitted to Gusto for processing but bank debits have not been initiated yet.Payroll has been submitted to Gusto and company bank debits have been initiated.A payroll was submitted, processed, and employee direct deposit payments have been initiated (employees paid / payroll complete).
Business Logic"processed": false"processed": true

Current time is < 4:00pm PT on the payroll_deadline
"processed": true

Current time is >= 4:00pm on the payroll_deadline
"processed": true

Current time is >= check_date
TransitionsAn unprocessed payroll transitions to the next status - **submitted - when payroll is submitted.A submitted payroll transitions to pending at 4:00pm PT on the payroll_deadline.

When a submitted payroll is canceled, a payroll transitions back to "processed": false (unprocessed).
A pending payroll transitions to paid on the check_date.

If Gusto is unable to debit the company bank account (i.e lack of funds), the payroll will transition back to unprocessed.
This is the final state of a payroll and it does not transition to another status from here.
Can Update?
(includes skip)
YesNoNoNo
Can Cancel?NoYesNoNo
Additional Details_Bank debits will initiate a little after 4:00pm PT on the payroll_deadline.

If payroll is submitted after 4:00pm PT on the payroll_deadline, the payroll will be delayed by 1 business day and the payroll_deadline will update accordingly._
Direct deposits are typically paid early on the morning of the check_date but sometimes it takes a little longer for banks to update. Please up to 24 hrs for the deposits to be reflected on employee bank statements.