Saltar al contenido principal
Los Offloader Wallets automatizan la conversión de stablecoin a fiat sin requerir una llamada API por transferencia. Creas una dirección de billetera on-chain para cada cliente, y cualquier stablecoin enviada a esa dirección se convierte automáticamente a la divisa fiat vinculada y se deposita en la cuenta bancaria registrada del cliente.
Los Offloader Wallets son un producto adicional. Usan diferentes endpoints que la API de Transferencias y no soportan webhooks.

​
Cómo funciona

Cuando creas un Offloader Wallet, SpherePay provisiona una dirección de billetera on-chain dedicada vinculada a una cuenta bancaria específica. El flujo completo es:
  1. Registras una cuenta bancaria para el cliente.
  2. Creas un Offloader Wallet vinculando la dirección on-chain del cliente a su cuenta bancaria.
  3. Compartes la dirección de billetera con tu cliente.
  4. El cliente envía stablecoins a la dirección offloader.
  5. SpherePay convierte automáticamente las stablecoins a fiat e inicia un pago a la cuenta bancaria vinculada — no se requieren llamadas API adicionales.

​
Cuándo usar Offloader Wallets vs. la API de Transferencias

Usa Offloader Wallets cuando quieras una conversión completamente automatizada, activada por depósitos, sin llamada API por transferencia y sin dependencia de webhooks. Usa la API de Transferencias cuando necesites control explícito por transferencia o notificaciones webhook impulsadas por eventos.

​
Una billetera por cliente

Un Offloader Wallet no tiene atribución por transferencia y no soporta webhooks. Si múltiples clientes comparten una sola dirección offloader, identificar quién envió un depósito requiere hacer coincidir manualmente por monto, tiempo o billetera de origen — lo que es propenso a errores. Siempre crea un Offloader Wallet por cliente.

​
Stablecoins y redes soportadas

StablecoinRedes Soportadas
USDCArbitrum, Avalanche, Base, Ethereum, Polygon, Solana
USDTEthereum, Tron
EURCBase, Ethereum, Solana

​
Destinos fiat soportados

DivisaRieles
USDACH, Wire
EURSEPA

​
Pasos de integración

Antes de comenzar, confirma que los Offloader Wallets están habilitados para tu aplicación de SpherePay. Contacta a tu representante de ventas si necesitas acceso.
1

Incorporar al cliente

Cada cliente debe estar registrado vía la API de Crear Cliente, haber aceptado los Términos de Servicio, completado KYC (para individuos) o KYB (para empresas), y tener un estado de cliente approved.
2

Registrar una cuenta bancaria para el cliente

Crea un registro de cuenta bancaria para el cliente usando la API de cuentas bancarias. Esta es la cuenta de destino fiat donde se pagarán los fondos convertidos.
3

Crear un Offloader Wallet

Llama a POST /v2/offloader-wallet con el ID de cliente, la divisa y red de stablecoin a aceptar, y un objeto de destino apuntando a la cuenta bancaria del cliente.
{
  "customerId": "customer_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "currency": "usdc",
  "network": "ethereum",
  "destination": {
    "bankAccountId": "bankAccount_6221e8d4299f4a889bd882255e92f581",
    "currency": "usd",
    "network": "ach",
    "achReference": "REF123"
  }
}
La respuesta incluye la address on-chain a la que tu cliente enviará stablecoins.
{
  "id": "wallet_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "customerId": "customer_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "address": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97",
  "currency": "usdc",
  "network": "ethereum",
  "destination": {
    "bankAccountId": "bankAccount_6221e8d4299f4a889bd882255e92f581",
    "currency": "usd",
    "network": "ach",
    "achReference": "REF123"
  },
  "fees": {
    "integratorFee": {
      "bpsRate": "100",
      "currency": "usdc"
    },
    "platformFee": {
      "bpsRate": "30",
      "currency": "usdc"
    }
  },
  "returnAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97",
  "created": "2024-06-15T10:30:00.000Z",
  "updated": "2024-06-15T12:00:00.000Z"
}
4

Recuperar la dirección de billetera

El campo address en la respuesta es la dirección de billetera on-chain. También puedes recuperarla en cualquier momento con GET /v2/offloader-wallet/{offloader_wallet_id}.
5

Compartir la dirección de billetera con tu cliente

Proporciona al cliente la address de la respuesta. Instrúyelos a enviar solo la stablecoin y red configuradas a esta dirección — por ejemplo, USDC en Ethereum solamente.
6

El cliente envía stablecoins

Una vez que tu cliente envía stablecoins a la dirección offloader, SpherePay convierte automáticamente los fondos e inicia un pago fiat a la cuenta bancaria vinculada. No se requieren más llamadas API de tu parte.

​
Operaciones API adicionales

Además de crear y recuperar offloader wallets, la API soporta:
  • PATCH /v2/offloader-wallet/{id} — actualizar la cuenta bancaria de destino
  • GET /v2/offloader-wallet — listar todos los offloader wallets
El historial de transferencias está disponible a través de la API de Transferencias estándar, no a través de un endpoint específico de billetera. Usa Obtener una Transferencia o Listar Transferencias filtrado por offloader wallet.

​
Notas

Las notificaciones webhook no están actualmente soportadas para Offloader Wallets. Consulta la API de Transferencias para verificar el estado de conversiones individuales.
Para información sobre comisiones aplicables y límites de transacciones, contacta a tu representante de ventas de SpherePay.

​
Regiones soportadas

Los Offloader Wallets están disponibles para usuarios finales globalmente, excepto en regiones sancionadas o de otro modo prohibidas por ley. Contacta a SpherePay para obtener una lista actualizada de regiones restringidas.
Última modificación el 17 de junio de 2026