Paychex Payroll Sync

Toku tracks your Paychex payroll calendar so the Toku deduction is always applied to the right pay period — and so on-chain delivery lines up with your check date.

Pay Periods

Toku reads pay periods through Paychex’s company-scoped pay periods resource, filterable by date range and status:

curl "https://api.paychex.com/companies/<company_id>/payperiods" \
  -H "Authorization: Bearer <access_token>"

A trimmed, representative example response:

{
  "content": [
    {
      "payPeriodId": "00Z5V9E2NKXFP83U1WY6",
      "frequency": "SEMI_MONTHLY",
      "status": "ENTRY",
      "startDate": "2026-07-01",
      "endDate": "2026-07-15",
      "submitByDate": "2026-07-17",
      "checkDate": "2026-07-20"
    }
  ]
}

Individual periods are available at /payperiods/{payperiodId}. See the Paychex API Developer Center for the full schema.

Checks

Within each pay period, Toku reads the company’s checks to confirm the Toku deduction landed on the right ones:

curl "https://api.paychex.com/companies/<company_id>/checks" \
  -H "Authorization: Bearer <access_token>"

Checks are either unprocessed (pay components can still be added, updated, or removed) or processed (finalized). Toku only ever writes to unprocessed checks, and uses processed checks for reconciliation.

What Toku Reads

Field	Purpose
`payPeriodId`	Ties each Toku pay cycle to the exact Paychex pay period
`startDate` / `endDate`	Determines which elections apply to the period
`checkDate`	Schedules on-chain stablecoin delivery
`submitByDate`	Ensures the deduction is applied before payroll submission
`status`	Confirms the period is finalized before Toku settles

Sync Behavior

Upcoming pay periods appear in the Toku dashboard as soon as they exist in Paychex.
When a period’s checks are processed, Toku reconciles the applied deductions against them and releases the corresponding stablecoin payments.

Payroll sync is read-only. Toku never creates, calculates, or submits payroll in Paychex — your team keeps full control of running payroll.

The Toku Deduction

How the deduction is applied via pay components

Authentication

OAuth 2.0 client credentials and token handling

​Pay Periods

​Checks

​What Toku Reads

​Sync Behavior

​Next

The Toku Deduction

Authentication

Pay Periods

Checks

What Toku Reads

Sync Behavior

Next