Applying the Toku Deduction in Papaya Global

Each payroll cycle, Toku delivers one dedicated deduction per participating worker as payroll input to the cycle, through the Integration Center feed provisioned for the Toku connection. This is the only data Toku sends back to Papaya.

Payroll Input Record

Each deduction is one line in the payroll input for the cycle. The record below is the Toku ↔ Papaya data contract — not a public REST endpoint:

{
  "cycle_id": "PT-Monthly-2026-07",
  "worker_id": "PPY-104233",
  "deduction_code": "TOKU_STABLECOIN",
  "amount": "250.00",
  "currency": "EUR",
  "pay_period_start": "2026-07-01",
  "pay_period_end": "2026-07-31"
}

The deduction code is configured once per payroll country during onboarding, so the line item appears consistently on payslips across every country you run with Papaya. See docs.papayaglobal.com for Papaya’s public developer documentation.

How the Amount Is Set

The worker’s stablecoin election in Toku determines the amount for each pay period.
Toku refreshes the payroll input before each cycle’s cutoff, so changes (updated elections, prorated periods, paused elections) are handled automatically.
The line item appears on the worker’s payslip under the configured Toku deduction code, so pay statements stay self-explanatory.

Guarantees

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

Toku never modifies compensation, tax withholding, benefits, or existing deductions in Papaya — the Toku deduction line is the only payroll input Toku delivers.

Reconciliation

After the cycle is finalized, Toku receives the gross-to-net (G2N) report data, confirms each applied deduction against it, and releases the matching on-chain stablecoin payments. Any mismatch blocks settlement and is surfaced in the Toku dashboard before funds move.

Integration Overview

Back to the Papaya Global integration overview

Worker Sync

How Toku reads your worker roster

⌘I

​Payroll Input Record

​How the Amount Is Set

​Guarantees

​Reconciliation

​Next

Integration Overview

Worker Sync

Payroll Input Record

How the Amount Is Set

Guarantees

Reconciliation

Next