> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Applying the Toku Deduction in UKG Pro

> How Toku posts the stablecoin deduction to upcoming pay runs through UKG Pro's payroll integration services

Each pay period, Toku posts one dedicated deduction per participating employee to the upcoming pay run, through UKG Pro's Payroll Integration services. This is the only write Toku performs against your UKG Pro tenant.

## 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:

```bash theme={null}
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](/integrations/ukg/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 |

<Warning>
  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.
</Warning>

## Reconciliation

After the payroll is processed, Toku reads the finalized run via [`GET /payroll/v1/payroll-deductions-history`](https://developer.ukg.com/hcm/reference/payrolldeductionshistory_get), 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.

## Next

<CardGroup cols={2}>
  <Card title="Integration Overview" icon="map" href="/integrations/ukg">
    Back to the UKG integration overview
  </Card>

  <Card title="Employee Sync" icon="users" href="/integrations/ukg/employee-sync">
    How Toku reads your employee roster
  </Card>
</CardGroup>