Saltar al contenido principal
Get a Virtual Account
curl --request GET \
  --url https://api.spherepay.co/v2/virtual-account/{virtualAccountId} \
  --header 'Authorization: Bearer <token>'
{
  "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": "ethereum"
  },
  "fee": {
    "totalBpsRate": "130",
    "integratorFee": {
      "bpsRate": "100"
    },
    "platformFee": {
      "bpsRate": "30"
    }
  },
  "created": "2025-01-15T10:30:00.000Z",
  "updated": "2025-01-15T12:00:00.000Z"
}
Usa este endpoint para recuperar un único Onramper Account por su ID. La respuesta incluye las instrucciones de depósito que necesitas compartir con tu cliente, la dirección de billetera de destino donde se entregan las stablecoins convertidas, el estado activo/inactivo y la configuración de comisiones.

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

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