> ## 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.
# Offloader Wallets: Cripto a Fiat Automatizado
> Los Offloader Wallets le dan a cada cliente una dirección on-chain dedicada que convierte automáticamente las stablecoins entrantes en pagos fiat bancarios.
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
| Stablecoin | Redes Soportadas |
| ---------- | ---------------------------------------------------- |
| USDC | Arbitrum, Avalanche, Base, Ethereum, Polygon, Solana |
| USDT | Ethereum, Tron |
| EURC | Base, Ethereum, Solana |
## Destinos fiat soportados
| Divisa | Rieles |
| ------ | --------- |
| USD | ACH, Wire |
| EUR | SEPA |
## 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.
Cada cliente debe estar registrado vía la API de [Crear Cliente](/es/api-reference/customer/post), haber aceptado los Términos de Servicio, completado KYC (para individuos) o KYB (para empresas), y tener un estado de cliente `approved`.
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.
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.
```json theme={"dark"}
{
"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.
```json theme={"dark"}
{
"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"
}
```
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}`.
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.
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](/es/api-reference/transfer/get-id) o [Listar Transferencias](/es/api-reference/transfer/get) 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.