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

# Nómina en Stablecoins y Fiat para Equipos Globales

> Paga a empleados W-2 y contratistas 1099 en stablecoins o fiat. Cubre modelos de nómina cripto-nativos y tradicionales con una única integración.

Usa SpherePay para desembolsar nóminas en stablecoins o convertir pagos de stablecoin a fiat para empleados y contratistas. Esto es común para empresas con equipos distribuidos globalmente o fuerzas laborales cripto-nativas.

## Dos modelos de nómina

| Modelo                   | Flujo                               | Mejor para                                             |
| ------------------------ | ----------------------------------- | ------------------------------------------------------ |
| **Nómina en stablecoin** | USD → USDC → billetera del empleado | Empleados cripto-nativos, contratistas internacionales |
| **Nómina en fiat**       | USDC → USD → banco del empleado     | Empleados tradicionales que prefieren fiat             |

## Recomendado — cuentas virtuales para nómina en stablecoin

La forma más rápida de implementar una integración de nómina en stablecoin es usar **[Onramper Accounts](/es/concepts/automation/onramper-accounts)** (cuentas bancarias virtuales) en lugar de llamadas `POST /v2/transfer` por cheque de pago.

Cada empleado obtiene su propia cuenta bancaria virtual USD dedicada (número de cuenta + número de enrutamiento, o detalles SEPA para EUR). En el día de pago inicias un único ACH/wire desde tu plataforma de nómina a la cuenta virtual de cada empleado usando tus herramientas de nómina existentes. SpherePay convierte automáticamente el depósito a USDC y lo entrega a la billetera registrada del empleado — no se requiere llamada a la API de transferencia.

**Por qué este patrón gana:**

* **Integración más rápida.** Sin lógica de API por pago, manejo de reintentos ni claves de idempotencia.
* **Reutiliza tu sistema de nómina.** Inicia el ACH desde Gusto, Rippling o tus rieles existentes — la cuenta virtual "parece" una cuenta bancaria normal para el originador.
* **Auditable.** Cada pago se registra como un depósito en una cuenta dedicada, mapeado 1:1 a un empleado.
* **Sin mantenimiento después de la configuración.** La incorporación del empleado + el aprovisionamiento del Onramper Account es el único trabajo de API. La nómina recurrente ocurre vía rieles bancarios.

Los patrones de API por transferencia a continuación siguen siendo relevantes cuando:

* Estás pagando contratistas de forma ad hoc (sin calendario recurrente)
* Quieres control de primera parte sobre qué billetera recibe cada pago
* Estás ejecutando nómina fiat (USDC → banco), donde los Onramper Accounts no aplican — usa [Offloader Wallets](/es/concepts/automation/offloader-wallets) en su lugar

## Transacciones de tercera parte

Los desembolsos de nómina son **transacciones de tercera parte** — estás moviendo fondos en nombre de otra parte (tus empleados o contratistas). Cada beneficiario debe ser un cliente verificado de SpherePay con KYC/KYB completado antes de poder recibir fondos.

<Warning>
  Cada beneficiario debe ser un cliente verificado en SpherePay con KYC o KYB completado. Enviar nómina a un cliente no verificado fallará en la capa de API.
</Warning>

## Requisitos de configuración

Antes de procesar la nómina:

1. **Verifica tu empresa** — Completa [KYB](/es/concepts/onboarding/business-kyb).
2. **Verifica a cada beneficiario** — Cada empleado o contratista necesita [KYC](/es/concepts/onboarding/individual-kyc).
3. **Registra instrumentos de pago por beneficiario:**
   * [Billeteras](/es/concepts/transfers/wallets) para pagos en stablecoin
   * [Cuentas bancarias](/es/concepts/transfers/bank-accounts) para pagos en fiat

## Modelo 1 — Nómina en stablecoin

USD desde tu cuenta bancaria empresarial → USDC → billetera del empleado.

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

### Transferencia por beneficiario

```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"
    }
  }'
```

### Procesamiento por lotes

Para múltiples empleados, distribuye las transferencias en 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 — Nómina fiat (off-ramp)

USDC desde tu billetera empresarial → USD → cuenta bancaria del empleado.

```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"]
```

### Transferencia por beneficiario

```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"
    }
  }'
```

## Nómina recurrente automatizada

Para nómina recurrente, usa [Offloader Wallets](/es/concepts/automation/offloader-wallets) u [Onramper Accounts](/es/concepts/automation/onramper-accounts) en lugar de transferencias únicas:

1. Crea un Offloader Wallet o Onramper Account para cada empleado.
2. Envía stablecoins a su Offloader Wallet (o fiat a su Onramper Account).
3. SpherePay convierte automáticamente a la divisa de destino y deposita en el riel configurado — no se requiere llamada a la API por pago.

## Consideraciones de cumplimiento

* **KYC a cada beneficiario.** Cada destinatario debe ser un cliente verificado.
* **Recopila información fiscal.** Eres responsable de la declaración de impuestos (W-9, W-8BEN, etc.).
* **Documenta las transferencias.** Mantén registros de todos los desembolsos de nómina.

## Mejores prácticas

* **Agrupa cuidadosamente.** Agrupa transferencias para minimizar las llamadas API pero vigila los límites de tasa.
* **Maneja los fallos con gracia.** Construye lógica de reintento para transferencias fallidas.
* **Usa claves de idempotencia.** Previene pagos duplicados.
* **Comunícate con los beneficiarios.** Informa a los empleados sobre los tiempos de liquidación esperados.

## Tiempos de liquidación

| Tipo de pago | Método | Liquidación             |
| ------------ | ------ | ----------------------- |
| USD → USDC   | ACH    | Mismo/próximo día hábil |
| USD → USDC   | Wire   | En 30 minutos           |
| EUR → USDC   | SEPA   | Mismo/próximo día hábil |
| USDC → USD   | ACH    | Mismo/próximo día hábil |
| USDC → USD   | Wire   | En 30 minutos           |
| USDC → EUR   | SEPA   | Mismo/próximo día hábil |

## Relacionado

<CardGroup cols={2}>
  <Card title="API de Transferencias" icon="arrow-right-left" href="/es/concepts/transfers/overview">
    Crea transferencias on-ramp y off-ramp bajo demanda con control total sobre el tiempo y el monto.
  </Card>

  <Card title="Offloader Wallets" icon="wallet" href="/es/concepts/automation/offloader-wallets">
    Transferencias automatizadas de stablecoin a fiat usando direcciones de billetera dedicadas.
  </Card>

  <Card title="Onramper Accounts" icon="landmark" href="/es/concepts/automation/onramper-accounts">
    Conversiones automatizadas de fiat a stablecoin usando cuentas bancarias virtuales.
  </Card>

  <Card title="KYC Individual" icon="user-check" href="/es/concepts/onboarding/individual-kyc">
    Incorporación de empleados y contratistas.
  </Card>
</CardGroup>