> ## 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 para Fiat Automatizado
> Offloader Wallets dão a cada cliente um endereço on-chain dedicado que converte automaticamente stablecoins recebidas em pagamentos fiat para conta bancária.
Offloader Wallets automatizam a conversão de stablecoin para fiat sem exigir uma chamada de API por transferência. Você cria um endereço de carteira on-chain para cada cliente (`customer`), e qualquer stablecoin enviada para esse endereço é automaticamente convertida para a moeda fiat vinculada e depositada na conta bancária registrada do cliente.
Offloader Wallets são um produto adicional. Elas usam endpoints diferentes da API de Transferências e não suportam webhooks.
## Como funciona
Quando você cria um Offloader Wallet, o SpherePay provisiona um endereço de carteira on-chain dedicado vinculado a uma conta bancária específica. O fluxo completo é:
1. Você registra uma conta bancária para o cliente.
2. Você cria um Offloader Wallet vinculando o endereço on-chain do cliente à conta bancária dele.
3. Você compartilha o endereço da carteira com seu cliente.
4. O cliente envia stablecoins para o endereço do offloader.
5. O SpherePay converte automaticamente as stablecoins para fiat e inicia um pagamento para a conta bancária vinculada — sem chamadas adicionais de API.
## Quando usar Offloader Wallets vs. a API de Transferências
Use Offloader Wallets quando quiser conversão totalmente automatizada e acionada por depósito, sem chamada de API por transferência e sem dependência de webhook. Use a API de Transferências quando precisar de controle explícito por transferência ou notificações de webhook orientadas a eventos.
## Uma carteira por cliente
Um Offloader Wallet não tem atribuição por transferência e não suporta webhooks. Se múltiplos clientes compartilharem um único endereço de offloader, identificar quem enviou um depósito requer correspondência manual por valor, horário ou carteira de origem — o que é propenso a erros. Sempre crie um Offloader Wallet por cliente.
## Stablecoins e redes suportados
| Stablecoin | Redes Suportadas |
| ---------- | ---------------------------------------------------- |
| USDC | Arbitrum, Avalanche, Base, Ethereum, Polygon, Solana |
| USDT | Ethereum, Tron |
| EURC | Base, Ethereum, Solana |
## Destinos fiat suportados
| Moeda | Rails |
| ----- | --------- |
| USD | ACH, Wire |
| EUR | SEPA |
## Etapas de integração
Antes de começar, confirme que Offloader Wallets estão habilitados para sua aplicação SpherePay. Entre em contato com seu representante de vendas se precisar de acesso.
Cada cliente deve ser registrado via API [Criar Cliente](/pt-BR/api-reference/customer/post), ter aceito os Termos de Serviço, concluído o KYC (para pessoas físicas) ou KYB (para empresas), e ter status de cliente `approved`.
Crie um registro de conta bancária para o cliente usando a API de conta bancária. Esta é a conta de destino fiat onde os fundos convertidos serão pagos.
Chame `POST /v2/offloader-wallet` com o ID do cliente, a stablecoin e rede a aceitar, e um objeto de destino apontando para a conta bancária do cliente.
```json theme={"dark"}
{
"customerId": "customer_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
"currency": "usdc",
"network": "ethereum",
"destination": {
"bankAccountId": "bankAccount_6221e8d4299f4a889bd882255e92f581",
"currency": "usd",
"network": "ach",
"achReference": "REF123"
}
}
```
A resposta inclui o `address` on-chain para o qual seu 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"
}
```
O campo `address` na resposta é o endereço da carteira on-chain. Você também pode recuperá-lo a qualquer momento com `GET /v2/offloader-wallet/{offloader_wallet_id}`.
Forneça ao cliente o `address` da resposta. Instrua-o a enviar apenas a stablecoin e rede configuradas para este endereço — por exemplo, somente USDC na Ethereum.
Assim que seu cliente enviar stablecoins para o endereço do offloader, o SpherePay converte automaticamente os fundos e inicia um pagamento fiat para a conta bancária vinculada. Nenhuma chamada de API adicional é necessária da sua parte.
## Operações adicionais de API
Além de criar e recuperar offloader wallets, a API suporta:
* `PATCH /v2/offloader-wallet/{id}` — atualizar a conta bancária de destino
* `GET /v2/offloader-wallet` — listar todas as offloader wallets
O histórico de transferências está disponível pela API de Transferências padrão, não por um endpoint específico de carteira. Use [Obter uma Transferência](/pt-BR/api-reference/transfer/get-id) ou [Listar Transferências](/pt-BR/api-reference/transfer/get) filtrado por offloader wallet.
## Notas
Notificações de webhook não são suportadas atualmente para Offloader Wallets. Consulte a API de Transferências para verificar o status de conversões individuais.
Para informações sobre taxas aplicáveis e limites de transação, entre em contato com seu representante de vendas SpherePay.
## Regiões suportadas
Offloader Wallets estão disponíveis para usuários finais globalmente, exceto em regiões sancionadas ou de outra forma proibidas por lei. Entre em contato com o SpherePay para uma lista atual de regiões restritas.