Offloader Wallets: Cripto para Fiat Automatizado

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

Você registra uma conta bancária para o cliente.
Você cria um Offloader Wallet vinculando o endereço on-chain do cliente à conta bancária dele.
Você compartilha o endereço da carteira com seu cliente.
O cliente envia stablecoins para o endereço do offloader.
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.

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.

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.

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"
}

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

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.

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.

​Como funciona

​Quando usar Offloader Wallets vs. a API de Transferências

​Uma carteira por cliente

​Stablecoins e redes suportados

​Destinos fiat suportados

​Etapas de integração

​Operações adicionais de API

​Notas

​Regiões suportadas

Como funciona

Quando usar Offloader Wallets vs. a API de Transferências

Uma carteira por cliente

Stablecoins e redes suportados

Destinos fiat suportados

Etapas de integração

Operações adicionais de API

Notas

Regiões suportadas