Aceite Pagamentos Fiat e Liquide em Stablecoins

​

Quando usar este padrão

• E-commerce e faturamento B2B. Fature clientes em USD, EUR ou BRL — eles pagam via wire ou ACH contra uma conta virtual, e você recebe USDC.
• Marketplaces. Provisione um Onramper Account por vendedor. Os recebimentos fiat de cada vendedor são liquidados automaticamente em uma carteira controlada pelo vendedor.
• Financiamento DeFi. Permita que usuários financiem uma posição on-chain via wire ou cartão. O usuário faz wire de fiat para seu Onramper Account, e USDC é liquidado diretamente no contrato do protocolo ou em uma carteira que você varre para o protocolo.
• Faturamento por assinatura. Cobranças ACH recorrentes de clientes chegam ao Onramper Account e são convertidas sem trabalho de API por ciclo de faturamento.
• Entrada de tesouraria. Receba pagamentos de clientes em fiat sem manter fiat — converta no ponto de recebimento.

​

Como funciona

1. Provisione um Onramper Account para cada pagador (ou por carteira receptora — depende do seu modelo).
2. Compartilhe as instruções de depósito com seu usuário final — eles fazem wire em USD, ACH ou SEPA contra a conta virtual como qualquer outra conta bancária.
3. O SpherePay converte automaticamente e liquida. Cada depósito recebido é convertido para a stablecoin configurada e entregue ao endereço de carteira registrado — sem chamada de API de transferência necessária.

​

Configuração

​

Etapa 1 — Verificar o cliente

​

Etapa 2 — Registrar a carteira de destino

{
  "customerId": "{{customer_id}}",
  "network": "ethereum",
  "address": "0xabcd1234...your wallet or contract..."
}

​

Etapa 3 — Criar o Onramper Account

{
  "customerId": "{{customer_id}}",
  "destination": {
    "walletId": "{{wallet_id}}",
    "currency": "usdc",
    "network": "ethereum"
  },
  "source": {
    "currency": "usd",
    "networks": ["ach", "wire"]
  }
}

"source": {
  "currency": "eur",
  "networks": ["sepa"]
}

​

Etapa 4 — Compartilhar instruções de depósito

​

Etapa 5 — Receber

1. O Sphere recebe o fiat na conta virtual.
2. O Sphere converte para a stablecoin configurada à taxa vigente.
3. A stablecoin é entregue na carteira registrada — {{wallet_id}}.

curl "https://api.spherepay.co/v2/transfer?customer={{customer_id}}" \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Aplicação DeFi

1. O usuário decide depositar no seu protocolo.
2. Seu app mostra as instruções de depósito de um Onramper Account configurado para liquidar USDC diretamente no contrato de vault do protocolo (ou em uma carteira intermediária que você varre para o protocolo).
3. O usuário faz wire em USD do seu banco.
4. USDC chega ao contrato do protocolo; o depósito reflete na posição on-chain automaticamente.

​

Aplicação em marketplace

async function onboardSeller(sellerCustomerId, sellerWalletId) {
  // Each seller gets their own dedicated virtual account
  const va = await createVirtualAccount({
    customerId: sellerCustomerId,
    destination: {
      walletId: sellerWalletId,
      currency: "usdc",
      network: "polygon",
    },
    source: {
      currency: "usd",
      networks: ["ach"],
    },
  });

  // Hand the seller their unique deposit details
  return {
    routing: va.accountDetails.routingNumber,
    account: va.accountDetails.accountNumber,
    name: va.accountDetails.accountHolderName,
  };
}

​

Considerações de conformidade

• KYC no proprietário da conta. O cliente que possui o Onramper Account deve ser verificado. Para marketplaces, isso significa que cada vendedor passa por KYC/KYB.
• Origem dos fundos. Depósitos grandes ou incomuns podem exigir documentação adicional de acordo com as políticas de conformidade do Sphere.
• Triagem de sanções. O Sphere triagem depósitos no nível do rail, mas você permanece responsável pela legalidade da sua atividade de negócio subjacente.
• Relatório fiscal. Eventos de conversão para stablecoin podem ser tributáveis em algumas jurisdições — coordene com seu consultor tributário.

​

Boas práticas

• Uma conta por receptor. Não compartilhe um Onramper Account entre múltiplos vendedores ou casos de uso — a reconciliação fica confusa. Contas dedicadas tornam cada depósito inequívoco.
• Defina limites conservadores. Use os limites de depósito por conta do Sphere para limitar a exposição em qualquer conta individual.
• Consulte o status de depósito. O Onramper Account não dispara webhooks atualmente; consulte GET /v2/transfer filtrado por cliente (use type=microdeposit para depósitos de verificação) para detectar novos depósitos.
• Use SEPA Instant quando possível para fluxos em EUR que exigem liquidação rápida.
• Planeje para reembolsos. Se o modelo de negócio subjacente exigir devolução de fundos, você precisará de um fluxo separado de off-ramp (consulte Offloader Wallets).

​

Relacionados