Saltar al contenido principal
Update a Virtual Account
curl --request PATCH \
  --url https://api.spherepay.co/v2/virtual-account/{virtualAccountId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destinationCurrency": "usdc",
  "network": "base",
  "walletAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97"
}
'
{
  "id": "virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "customer": "customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  "active": true,
  "depositInstructions": {
    "currency": "usd",
    "bankName": "Lead Bank",
    "bankAddress": "1801 Main St, Kansas City, MO 64108",
    "bankAccountNumber": "9876543210",
    "bankRoutingNumber": 21000089,
    "bankBeneficiaryName": "Bridge Financial Inc.",
    "bankBeneficiaryAddress": "123 Finance St, San Francisco, CA 94105",
    "iban": "DE89370400440532013000",
    "bic": "COBADEFFXXX"
  },
  "destination": {
    "currency": "usdc",
    "walletAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97",
    "network": "base"
  },
  "fee": {
    "totalBpsRate": "130",
    "integratorFee": {
      "bpsRate": "100"
    },
    "platformFee": {
      "bpsRate": "30"
    }
  },
  "created": "2025-01-15T10:30:00.000Z",
  "updated": "2025-01-16T08:45:00.000Z"
}
Usa este endpoint para actualizar la configuración de destino de un Onramper Account existente. Puedes cambiar la stablecoin de destino, la red blockchain, la dirección de billetera y la comisión de integrador. Todos los campos en el cuerpo de la solicitud son opcionales — incluye solo los campos que deseas cambiar. Los depósitos futuros usarán la configuración de destino actualizada inmediatamente después de la actualización.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

virtualAccountId
string
requerido

Cuerpo

application/json
destinationCurrency
enum<string>
requerido

The crypto currency deposited funds are converted into. See Supported Rails & Currencies.

Opciones disponibles:
usdc,
usdt,
eurc
Ejemplo:

"usdc"

network
enum<string>
requerido

The blockchain network the destination wallet is on. See Supported Rails & Currencies.

Opciones disponibles:
arbitrum,
avalanche,
base,
ethereum,
polygon,
sol,
tron
Ejemplo:

"ethereum"

walletAddress
string
requerido

The on-chain wallet address where converted crypto is sent. Must be valid for the selected network.

Ejemplo:

"0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97"

integratorFeeBps
string

Integrator fee in basis points (1 bps = 0.01%). Defaults to 0 if not provided.

Ejemplo:

"100"

Respuesta

id
string
requerido

Unique identifier for the virtual account.

Ejemplo:

"virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"

active
boolean
requerido

Whether the virtual account is currently active and accepting deposits.

Ejemplo:

true

depositInstructions
object
requerido

Bank account details that depositors should use to send fiat funds into the virtual account.

destination
object
requerido

The crypto destination where converted funds are sent after deposit.

created
string
requerido

Timestamp when the virtual account was created (ISO 8601).

Ejemplo:

"2025-01-15T10:30:00.000Z"

updated
string
requerido

Timestamp when the virtual account was last updated (ISO 8601).

Ejemplo:

"2025-01-15T12:00:00.000Z"

customer
string

The customer ID who owns the virtual account.

Ejemplo:

"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"

fee
object

Fee breakdown for the virtual account, including integrator and platform fees.

Última modificación el 18 de junio de 2026