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

# Papaya Global Payroll Sync

> How Toku tracks payroll cycles and gross-to-net data in Papaya Global

Toku tracks your Papaya payroll calendar so the Toku deduction is always delivered to the right payroll cycle — and so on-chain delivery lines up with each country's pay date.

## Data Feed

Payroll calendar and cycle data is exchanged through Papaya's **Integration Center**, using the feed provisioned for the Toku connection. Papaya also sends webhook notifications for cycle events, so Toku learns immediately when a cycle is finalized instead of waiting for the next scheduled sync.

A trimmed example of the payroll cycle record in the Toku ↔ Papaya data contract:

```json theme={null}
{
  "cycle_id": "PT-Monthly-2026-07",
  "pay_period_start": "2026-07-01",
  "pay_period_end": "2026-07-31",
  "pay_date": "2026-07-28",
  "status": "open"
}
```

Once a cycle is finalized, Toku receives the corresponding **gross-to-net (G2N) report** data — including per-worker gross and net amounts — through the same feed. See [docs.papayaglobal.com](https://docs.papayaglobal.com) for Papaya's public developer documentation; your feed configuration is confirmed during implementation.

## What Toku Reads

| Field                                 | Purpose                                                    |
| ------------------------------------- | ---------------------------------------------------------- |
| `cycle_id`                            | Ties each Toku pay cycle to the exact Papaya payroll cycle |
| `pay_period_start` / `pay_period_end` | Determines which elections apply to the cycle              |
| `pay_date`                            | Schedules on-chain stablecoin delivery                     |
| `status`                              | Gates deduction delivery (open) and settlement (finalized) |
| Per-worker gross / net (G2N)          | Reconciles applied deductions before funds move            |

## Sync Behavior

* Upcoming payroll cycles appear in the Toku dashboard as soon as they exist on the Papaya payroll calendar.
* While a cycle is open, Toku delivers the Toku deduction as payroll input ahead of the cutoff.
* When a cycle is finalized, a webhook notification triggers reconciliation: Toku checks the G2N report against the applied deductions and releases the corresponding stablecoin payments.
* Off-cycle runs are detected and skipped by default (configurable during onboarding).

<Note>
  Payroll sync is read-only. Toku never opens, calculates, or approves payroll cycles in Papaya — your team and Papaya's in-country partners (ICPs) keep full control of running payroll.
</Note>

## Next

<CardGroup cols={2}>
  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/papaya-global/deduction">
    How the deduction is delivered as payroll input
  </Card>

  <Card title="Authentication" icon="lock" href="/integrations/papaya-global/authentication">
    Credentials, token exchange, and environments
  </Card>
</CardGroup>