> ## 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 Papaya Global

> How Toku delivers the stablecoin deduction as payroll input through Papaya's Integration Center

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:

```json theme={null}
{
  "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](https://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 |

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

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

## Next

<CardGroup cols={2}>
  <Card title="Integration Overview" icon="map" href="/integrations/papaya-global">
    Back to the Papaya Global integration overview
  </Card>

  <Card title="Worker Sync" icon="users" href="/integrations/papaya-global/employee-sync">
    How Toku reads your worker roster
  </Card>
</CardGroup>
