Simple check creation

Earnings, hours, and deductions collected within a non-Paychex system such as an external Point-of-Sales systems to be sent over to Paychex to perform Payroll services.  The Payroll API provides all the capabilities needed to integrate pay data with Paychex Flex.  It exposes resources for Pay Components, Pay Periods and Checks. You will be using these end points, in combination with foundational APIs to create your solution.  

This will allow solutions to send and work with unprocessed check information.  The most common unprocessed check use cases are adding hours worked and commission/bonus/tip amounts to checks in Flex payroll entry. While an API solution can be used to send payroll data, the client or Paychex service provider must still review and complete the submission of the payroll for processing.  If you are interested in the Payroll API, please contact your Paychex sales rep or service provider. 

Pay Periods 

The company pay period calendar enables syncing and ensuring wages are paid on the correct dates.  Pay periods are typically used for applying earnings and deductions that a worker accumulated within the pay period range that can be added into one or more checks. The API supports the use of both unprocessed and processed pay periods. An unprocessed pay period allows for creating and retrieving unprocessed checks. A processed pay period allows only for the retrieval of checks. 

Note: The API will not allow the use of a pay period which is currently processing.  Use of the pay period will be allowed once the processing has completed.  

Pay Components 

Companies can define the pay components that are applicable to their business and are used in constructing a worker's check. The pay components are put into classifications and can have different effects on the outcome of the check. The company can set when these pay components are available by defining start and end dates, these dates come into play when creating a check in conjunction with the pay periods date range. When dealing with unprocessed check an earning needs to exists if a deduction is placed on the check.  


The API will allow you to work with earnings on unprocessed checks. Using the other resources like workers, pay period, and pay components you can POST, GET, and DELETE for unprocessed checks. When creating checks, you can define for a worker their earnings and deductions using the pay components and combination of rate/amounts. When predefined configurations like reoccurring earnings and deductions are set on a worker these will automatically be applied to the check when it is created from the API. 


  • Use your system of choice for collection of earnings and deductions to populate pay entry 

  • Integration with payroll provides an efficient process to create employee checks in a timely fashion 

  • Removes data redundancy and duplication of effort to maintain employee records in multiple systems  

  • Uses company defined pay components for constructing workers’ checks as well as provides availability of pay components in conjunction with pay periods date range 

  • Optional data elements can be used for:

    • Line date can be used optionally for specifying a date that the earning was generated on 
    • Memo the so that they are used as informational
    • Using simple labor distribution if enabled on your company you can apply an Organization override for assigning a specific organization to an earning otherwise a default org is applied for the worker


Step 1


Map workers between Paychex

and the external system.

Step 2

External POS Systems

Earnings are collected

in external system.

Step 3


Admin processes payroll with the

earnings provided from POS system.


Relevant APIs used: