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

> Run compliant stablecoin payroll alongside Papaya Global with the Toku deduction

Toku integrates with **Papaya Global** through Papaya's APIs and Integration Center, exchanging payroll data securely across your payroll countries. Papaya remains your payroll system of record — Toku handles the digital-asset side.

## How It Works

<CardGroup cols={2}>
  <Card title="1. Connect" icon="plug">
    Link Papaya Global to Toku with secure, per-environment API credentials.
  </Card>

  <Card title="2. Sync" icon="rotate">
    Toku syncs your worker roster and payroll calendar from Papaya automatically.
  </Card>

  <Card title="3. Elect" icon="hand-pointer">
    Workers choose what portion of their pay they'd like to receive in stablecoins.
  </Card>

  <Card title="4. Deduct & Deliver" icon="money-bill-transfer">
    Each payroll cycle, a single Toku deduction is delivered as payroll input to Papaya and Toku delivers the corresponding stablecoin payment on-chain.
  </Card>
</CardGroup>

## The Toku Deduction

Stablecoin payments appear in Papaya as one dedicated deduction line item in the payroll cycle. Toku calculates the amount for each worker every cycle based on their election and delivers it as payroll input through Papaya's Integration Center — no manual data entry, and no changes to your gross pay, taxes, or existing pay items.

The deduction is configured once during implementation, per payroll country. Toku's team provides the exact Papaya configuration as part of onboarding.

## What You'll Need

* Admin access to your Papaya Global account
* Admin access to your Toku account
* A short implementation session with the Toku and Papaya teams

## Setup Overview

<Steps>
  <Step title="Provision API access">
    Papaya issues secure API credentials for the Toku connection. Toku's implementation team coordinates this with Papaya's integration support.
  </Step>

  <Step title="Confirm the Toku deduction">
    Toku works with your payroll team to add the dedicated deduction to the relevant payroll calendars.
  </Step>

  <Step title="Connect from Toku">
    In the Toku dashboard, go to **Settings → Payroll Integrations → Add New Integration → Papaya Global** and complete the connection.
  </Step>

  <Step title="Verify the sync">
    Toku validates the connection, previews your worker roster, and begins syncing payroll cycles.
  </Step>
</Steps>

<Note>
  Detailed configuration guides are provided to customers during implementation. [Contact the Toku team](https://www.toku.com/contact) to get started.
</Note>

## Each Payroll Cycle

Once connected, the integration runs on autopilot:

1. Toku syncs upcoming payroll cycles and worker changes from Papaya.
2. Toku calculates each worker's stablecoin amount and delivers the Toku deduction as payroll input.
3. You run payroll in Papaya exactly as you do today.
4. Toku delivers the stablecoin payments on-chain and provides full reporting and reconciliation.

## Data & Security

* **Worker and payroll data** syncs from Papaya to Toku on a read-only basis.
* **Deduction data** is the only information Toku sends back to Papaya.
* The connection uses token-based authentication over HTTPS with short-lived access tokens, and all credentials are encrypted at rest.

## API Reference

How the integration works at the API level, with calls you can validate against Papaya Global's own documentation:

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/integrations/papaya-global/authentication">
    How Toku authenticates with Papaya Global
  </Card>

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

  <Card title="Payroll Sync" icon="calendar" href="/integrations/papaya-global/payroll-sync">
    How Toku tracks pay periods and payroll status
  </Card>

  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/papaya-global/deduction">
    How the deduction is applied each pay period
  </Card>
</CardGroup>

## Related Integrations

<CardGroup cols={2}>
  <Card title="Deel" icon="building" href="/integrations/deel">
    Deel Global Payroll integration
  </Card>

  <Card title="Workday" icon="building" href="/integrations/workday">
    HCM and payroll integration
  </Card>
</CardGroup>
