Pular para o conteúdo principal
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

ModeloFluxoMelhor para
Folha de pagamento em stablecoinUSD → USDC → carteira do funcionárioFuncionários cripto-nativos, prestadores de serviços internacionais
Folha de pagamento em fiatUSDC → USD → banco do funcionárioFuncioná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 (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

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

Requisitos de configuração

Antes de processar folha de pagamento:
  1. Verifique sua empresa — Complete o KYB.
  2. Verifique cada beneficiário — Cada funcionário ou prestador de serviços precisa de KYC.
  3. Registre instrumentos de pagamento por beneficiário:

Modelo 1 — Folha de pagamento em stablecoin

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

Transferência por beneficiário

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

Transferência por beneficiário

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 ou 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 pagamentoMétodoLiquidação
USD → USDCACHMesmo/próximo dia útil
USD → USDCWireDentro de 30 minutos
EUR → USDCSEPAMesmo/próximo dia útil
USDC → USDACHMesmo/próximo dia útil
USDC → USDWireDentro de 30 minutos
USDC → EURSEPAMesmo/próximo dia útil

Relacionados

API de Transferências

Crie transferências de on-ramp e off-ramp sob demanda com controle total sobre tempo e valor.

Offloader Wallets

Transferências automáticas de stablecoin para fiat usando endereços de carteira dedicados.

Onramper Accounts

Conversões automáticas de fiat para stablecoin usando contas bancárias virtuais.

KYC Individual

Onboarding de funcionários e prestadores de serviços.
Última modificação em 18 de junho de 2026