Acepta Pagos Fiat y Liquida en Stablecoins

​

Cuándo usar este patrón

• E-commerce y facturación B2B. Factura a clientes en USD, EUR o BRL — pagan vía wire o ACH contra una cuenta virtual, y tú recibes USDC.
• Marketplaces. Provisiona un Onramper Account por vendedor. Las ganancias fiat de cada vendedor se liquidan automáticamente en una billetera controlada por el vendedor.
• Fondeo DeFi. Permite que los usuarios financien una posición on-chain vía wire o tarjeta. El usuario hace un wire fiat a su Onramper Account, USDC se liquida directamente al contrato del protocolo o una billetera que barres hacia el protocolo.
• Facturación por suscripción. Los débitos ACH recurrentes de los clientes aterrizan en su Onramper Account y convierten sin trabajo de API por ciclo de facturación.
• Entrada de tesorería. Recibe pagos de clientes en fiat sin mantener fiat — convierte en el momento de la recepción.

​

Cómo funciona

1. Provisiona un Onramper Account para cada pagador (o por billetera receptora — depende de tu modelo).
2. Comparte las instrucciones de depósito con tu usuario final — hacen un wire USD, ACH o SEPA contra la cuenta virtual como cualquier otra cuenta bancaria.
3. SpherePay convierte automáticamente y liquida. Cada depósito entrante se convierte a la stablecoin configurada y se entrega a la dirección de billetera registrada — no se requiere llamada a la API de transferencia.

​

Configuración

​

Paso 1 — Verificar al cliente

​

Paso 2 — Registrar la billetera de destino

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

​

Paso 3 — Crear el Onramper Account

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

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

​

Paso 4 — Compartir instrucciones de depósito

​

Paso 5 — Recibir

1. Sphere recibe el fiat en la cuenta virtual.
2. Sphere convierte a la stablecoin configurada a la tasa vigente.
3. La stablecoin se entrega a la billetera registrada — {{wallet_id}}.

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

​

Aplicación DeFi

1. El usuario decide depositar en tu protocolo.
2. Tu app les muestra las instrucciones de depósito para un Onramper Account configurado para liquidar USDC directamente al contrato de bóveda del protocolo (o una billetera intermediaria que barres hacia el protocolo).
3. El usuario hace un wire USD desde su banco.
4. USDC aterriza en el contrato del protocolo; el depósito se refleja en su posición on-chain automáticamente.

​

Aplicación de 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,
  };
}

​

Consideraciones de cumplimiento

• KYC al propietario de la cuenta. El cliente que posee el Onramper Account debe estar verificado. Para marketplaces, esto significa que cada vendedor pasa por KYC/KYB.
• Fuente de fondos. Los depósitos grandes o inusuales pueden requerir documentación adicional según las políticas de cumplimiento de Sphere.
• Screening de sanciones. Sphere realiza screening de depósitos a nivel de riel, pero tú sigues siendo responsable de la legalidad de tu actividad comercial subyacente.
• Declaración de impuestos. Los eventos de conversión a stablecoin pueden ser gravables en algunas jurisdicciones — coordina con tu asesor fiscal.

​

Mejores prácticas

• Una cuenta por receptor. No compartas un Onramper Account entre múltiples vendedores o casos de uso — la conciliación se complica. Las cuentas dedicadas hacen que cada depósito sea inequívoco.
• Establece límites conservadores. Usa los límites de depósito por cuenta de Sphere para acotar la exposición en cualquier cuenta individual.
• Consulta el estado del depósito. El Onramper Account no dispara webhooks hoy; consulta GET /v2/transfer filtrado por cliente (usa type=microdeposit para depósitos de verificación) para detectar nuevos depósitos.
• Usa SEPA Instant donde sea posible para flujos EUR que requieran liquidación rápida.
• Planifica para reembolsos. Si el modelo de negocio subyacente requiere devolver fondos, necesitarás un flujo separado de off-ramp (consulta Offloader Wallets).

​

Relacionado