New: BRL/PIX transfers now supported View changelog
Onramper Account

List Onramper Accounts

A **virtual account** Virtual Account provides a streamlined, automatic solution to convert fiat currency into stablecoins directly into your customers' bank accounts.

GET
/v2/virtual-account
AuthorizationBearer <token>

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.spherepay.co/v2/virtual-account"
[
  {
    "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"
  }
]
{
  "status": 400,
  "detail": "Invalid request parameters",
  "code": "address/invalid",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}
{
  "status": 404,
  "detail": "Resource not found",
  "code": "resource/not-found",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}
{
  "status": 422,
  "detail": "Validation failed",
  "code": "validation/failed",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
  "errors": [
    {
      "detail": "Invalid email format",
      "pointer": "/email"
    },
    {
      "detail": "Name is required",
      "pointer": "/name"
    }
  ]
}

Last updated on