Pular para o conteúdo principal
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

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

​
Destinos fiat suportados

MoedaRails
USDACH, Wire
EURSEPA

​
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.
1

Cadastrar o cliente

Cada cliente deve ser registrado via API Criar Cliente, 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.
2

Registrar uma conta bancária para o cliente

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

Criar um Offloader Wallet

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.
{
  "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.
{
  "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 o endereço da carteira

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}.
5

Compartilhar o endereço da carteira com seu cliente

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

Cliente envia stablecoins

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 ou Listar Transferências 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.
Última modificação em 17 de junho de 2026