Applying the Toku Deduction in UKG Pro

How It’s Delivered

The deduction uses the customer-configured Deduction/Benefit Plan created during onboarding, applied as a flat amount at the employee level. UKG Pro exposes a pay-item import surface for delivering pay data into open runs — for example:

POST https://<hostname>.ultipro.com/services/payroll/v1/import-pay-items/... \
  -H "x-correlation-id: <request_id>" \
  -H "us-client-id: <primary_company_code>" \
  -H "US-CUSTOMER-API-KEY: <customer_api_key>"

The exact deduction delivery path — API pay-item import versus UKG’s Pay Data Import — is configured with UKG during implementation, since it depends on your tenant’s payroll setup. Toku’s implementation team handles this configuration with you; either way, the result is the same single Toku line item on the pay run.

The Deduction Record

For each participating employee, the posted record carries:

Field	Detail
Employee ID	The UKG Pro `employeeId` matched during employee sync
Deduction/Benefit Plan code	The dedicated Toku plan configured during onboarding
Amount	Flat amount — the employee’s election determines the amount for each pay period
Pay period	The upcoming pay run for the employee’s pay group

The line item appears on the employee’s pay statement under the Toku plan code, so payslips stay self-explanatory.

Guarantees

Behavior	Detail
One line item	Exactly one Toku deduction per participating employee per run
No gross changes	Gross pay, taxes, and every other pay item are untouched
Bounded amount	The deduction is validated against net pay before it is posted
Reversible	Removing an employee’s election stops the deduction from the next run

Toku never modifies compensation, tax withholding, benefits, or existing deduction codes in UKG Pro — write access is limited to the Toku Deduction/Benefit Plan itself.

Reconciliation

After the payroll is processed, Toku reads the finalized run via GET /payroll/v1/payroll-deductions-history, confirms each applied deduction against the employee’s election, and releases the matching on-chain stablecoin payments. Any mismatch blocks settlement and is surfaced in the Toku dashboard before funds move.

Applying the Toku Deduction in UKG Pro

How It’s Delivered

The Deduction Record

Guarantees

Reconciliation

Next

Integration Overview

Employee Sync

​How It’s Delivered

​The Deduction Record

​Guarantees

​Reconciliation

​Next

Integration Overview

Employee Sync

How It’s Delivered

The Deduction Record

Guarantees

Reconciliation

Next