Saltar al contenido principal
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

ModeloFlujoMejor para
Nómina en stablecoinUSD → USDC → billetera del empleadoEmpleados cripto-nativos, contratistas internacionales
Nómina en fiatUSDC → USD → banco del empleadoEmpleados 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 (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 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.
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.

Requisitos de configuración

Antes de procesar la nómina:
  1. Verifica tu empresa — Completa KYB.
  2. Verifica a cada beneficiario — Cada empleado o contratista necesita KYC.
  3. Registra instrumentos de pago por beneficiario:

Modelo 1 — Nómina en stablecoin

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

Transferencia por beneficiario

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

Transferencia por beneficiario

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 u 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 pagoMétodoLiquidación
USD → USDCACHMismo/próximo día hábil
USD → USDCWireEn 30 minutos
EUR → USDCSEPAMismo/próximo día hábil
USDC → USDACHMismo/próximo día hábil
USDC → USDWireEn 30 minutos
USDC → EURSEPAMismo/próximo día hábil

Relacionado

API de Transferencias

Crea transferencias on-ramp y off-ramp bajo demanda con control total sobre el tiempo y el monto.

Offloader Wallets

Transferencias automatizadas de stablecoin a fiat usando direcciones de billetera dedicadas.

Onramper Accounts

Conversiones automatizadas de fiat a stablecoin usando cuentas bancarias virtuales.

KYC Individual

Incorporación de empleados y contratistas.
Última modificación el 17 de junio de 2026