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

# Folha de Pagamento em Stablecoin e Fiat para Equipes Globais

> Pague funcionários CLT e prestadores em stablecoins ou fiat. Cubra modelos de folha de pagamento cripto-nativos e tradicionais em uma única integração.

Use o SpherePay para distribuir folha de pagamento em stablecoins ou converter pagamentos em stablecoin para fiat para funcionários e prestadores de serviços. Isso é comum para empresas com equipes distribuídas globalmente ou força de trabalho cripto-nativa.

## Dois modelos de folha de pagamento

| Modelo                               | Fluxo                                | Melhor para                                                         |
| ------------------------------------ | ------------------------------------ | ------------------------------------------------------------------- |
| **Folha de pagamento em stablecoin** | USD → USDC → carteira do funcionário | Funcionários cripto-nativos, prestadores de serviços internacionais |
| **Folha de pagamento em fiat**       | USDC → USD → banco do funcionário    | Funcionários tradicionais que preferem fiat                         |

## Recomendado — contas virtuais para folha de pagamento em stablecoin

A forma mais rápida de lançar uma integração de folha de pagamento em stablecoin é usar **[Onramper Accounts](/pt-BR/concepts/automation/onramper-accounts)** (contas bancárias virtuais) em vez de chamadas `POST /v2/transfer` por pagamento.

Cada funcionário recebe sua própria conta bancária virtual USD dedicada (número de conta + código de roteamento, ou dados SEPA para EUR). No dia do pagamento, você inicia um único ACH/wire da sua plataforma de folha de pagamento para a conta virtual de cada funcionário usando suas ferramentas existentes. O SpherePay converte automaticamente o depósito para USDC e entrega na carteira registrada do funcionário — sem chamada de API de transferência necessária.

**Por que este padrão é superior:**

* **Integração mais rápida.** Sem lógica de API por pagamento, tratamento de retry ou chaves de idempotência.
* **Reutiliza seu sistema de folha de pagamento.** Inicie o ACH do Gusto, Rippling ou seus rails existentes — a conta virtual "parece" uma conta bancária normal para o originador.
* **Auditável.** Cada pagamento é registrado como um depósito em uma conta dedicada, mapeada 1:1 para um funcionário.
* **Automático após a configuração.** O onboarding do funcionário + provisionamento do Onramper Account é o único trabalho de API. A folha de pagamento recorrente acontece via rails bancários.

Os padrões de API de transferência avulsa abaixo ainda são relevantes quando:

* Você está pagando prestadores de serviços de forma avulsa (sem recorrência)
* Você quer controle próprio (first-party) sobre qual carteira recebe cada pagamento
* Você está executando folha de pagamento em fiat (USDC → banco), onde Onramper Accounts não se aplicam — use [Offloader Wallets](/pt-BR/concepts/automation/offloader-wallets)

## Transações de terceiros

Desembolsos de folha de pagamento são **transações de terceiros** — você está movendo fundos em nome de outra parte (seus funcionários ou prestadores de serviços). Cada beneficiário deve ser um cliente SpherePay verificado com KYC/KYB completo antes de poder receber fundos.

<Warning>
  Todo beneficiário deve ser um cliente verificado no SpherePay com KYC ou KYB completo. Enviar folha de pagamento a um cliente não verificado falhará na camada de API.
</Warning>

## Requisitos de configuração

Antes de processar folha de pagamento:

1. **Verifique sua empresa** — Complete o [KYB](/pt-BR/concepts/onboarding/business-kyb).
2. **Verifique cada beneficiário** — Cada funcionário ou prestador de serviços precisa de [KYC](/pt-BR/concepts/onboarding/individual-kyc).
3. **Registre instrumentos de pagamento por beneficiário:**
   * [Carteiras](/pt-BR/concepts/transfers/wallets) para pagamentos em stablecoin
   * [Contas bancárias](/pt-BR/concepts/transfers/bank-accounts) para pagamentos em fiat

## Modelo 1 — Folha de pagamento em stablecoin

USD da sua conta bancária da empresa → USDC → carteira do funcionário.

```mermaid theme={"dark"}
flowchart LR
    CB["Company<br/>bank account"] -->|USD ACH / Wire| SP["SpherePay<br/>on-ramp"]
    SP -->|USDC| EW["Employee<br/>wallet"]
```

### Transferência por beneficiário

```bash theme={"dark"}
curl -X POST https://api.spherepay.co/v2/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5000.00",
    "customer": "customer_123",
    "source": {
      "type": "bank_account",
      "id": "bankAccount_company",
      "currency": "usd",
      "network": "ach"
    },
    "destination": {
      "type": "wallet",
      "id": "wallet_123",
      "currency": "usdc",
      "network": "sol"
    }
  }'
```

### Processamento em lote

Para múltiplos funcionários, distribua transferências em paralelo:

```javascript theme={"dark"}
const employees = [
  { customerId: "customer_employee_1", amount: "5000.00", walletId: "wallet_1" },
  { customerId: "customer_employee_2", amount: "4500.00", walletId: "wallet_2" },
  { customerId: "customer_employee_3", amount: "6000.00", walletId: "wallet_3" },
];

const transfers = await Promise.all(
  employees.map(emp =>
    createTransfer({
      amount: emp.amount,
      customer: emp.customerId,
      source: {
        type: "bank_account",
        id: COMPANY_BANK_ID,
        currency: "usd",
        network: "ach",
      },
      destination: {
        type: "wallet",
        id: emp.walletId,
        currency: "usdc",
        network: "sol",
      },
    })
  )
);
```

## Modelo 2 — Folha de pagamento em fiat (off-ramp)

USDC da sua carteira da empresa → USD → conta bancária do funcionário.

```mermaid theme={"dark"}
flowchart LR
    CW["Company<br/>wallet (USDC)"] -->|USDC| SP["SpherePay<br/>off-ramp"]
    SP -->|USD ACH / Wire| EB["Employee<br/>bank account"]
```

### Transferência por beneficiário

```bash theme={"dark"}
curl -X POST https://api.spherepay.co/v2/transfer \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "5000.00",
    "customer": "customer_123",
    "source": {
      "type": "wallet",
      "id": "wallet_company",
      "currency": "usdc",
      "network": "ethereum"
    },
    "destination": {
      "type": "bank_account",
      "id": "bankAccount_123",
      "currency": "usd",
      "network": "ach"
    }
  }'
```

## Folha de pagamento recorrente automatizada

Para folha de pagamento recorrente, use [Offloader Wallets](/pt-BR/concepts/automation/offloader-wallets) ou [Onramper Accounts](/pt-BR/concepts/automation/onramper-accounts) em vez de transferências avulsas:

1. Crie um Offloader Wallet ou Onramper Account para cada funcionário.
2. Envie stablecoins para o Offloader Wallet (ou fiat para o Onramper Account).
3. O SpherePay converte automaticamente para a moeda de destino e deposita no rail configurado — sem chamada de API por pagamento.

## Considerações de conformidade

* **KYC em cada beneficiário.** Todo destinatário deve ser um cliente verificado.
* **Colete informações fiscais.** Você é responsável pelo relatório fiscal (W-9, W-8BEN, etc.).
* **Documente transferências.** Mantenha registros de todos os desembolsos de folha de pagamento.

## Boas práticas

* **Faça lotes com cuidado.** Agrupe transferências para minimizar chamadas de API, mas observe os limites de taxa.
* **Trate falhas com elegância.** Construa lógica de retry para transferências com falha.
* **Use chaves de idempotência.** Evite pagamentos duplicados.
* **Comunique-se com os beneficiários.** Informe os funcionários sobre os tempos esperados de liquidação.

## Tempos de liquidação

| Tipo de pagamento | Método | Liquidação             |
| ----------------- | ------ | ---------------------- |
| USD → USDC        | ACH    | Mesmo/próximo dia útil |
| USD → USDC        | Wire   | Dentro de 30 minutos   |
| EUR → USDC        | SEPA   | Mesmo/próximo dia útil |
| USDC → USD        | ACH    | Mesmo/próximo dia útil |
| USDC → USD        | Wire   | Dentro de 30 minutos   |
| USDC → EUR        | SEPA   | Mesmo/próximo dia útil |

## Relacionados

<CardGroup cols={2}>
  <Card title="API de Transferências" icon="arrow-right-left" href="/pt-BR/concepts/transfers/overview">
    Crie transferências de on-ramp e off-ramp sob demanda com controle total sobre tempo e valor.
  </Card>

  <Card title="Offloader Wallets" icon="wallet" href="/pt-BR/concepts/automation/offloader-wallets">
    Transferências automáticas de stablecoin para fiat usando endereços de carteira dedicados.
  </Card>

  <Card title="Onramper Accounts" icon="landmark" href="/pt-BR/concepts/automation/onramper-accounts">
    Conversões automáticas de fiat para stablecoin usando contas bancárias virtuais.
  </Card>

  <Card title="KYC Individual" icon="user-check" href="/pt-BR/concepts/onboarding/individual-kyc">
    Onboarding de funcionários e prestadores de serviços.
  </Card>
</CardGroup>