Changelog

August 21, 2025

Introducing the Virtual Account API

We’re excited to announce our new Virtual Account API, which lets you:

Generate dedicated bank accounts for your application or customers
Automatically convert incoming fiat deposits into stablecoins (USDC/USDT)
Deliver funds directly to on-chain wallet addresses

How to use it?

Create a Virtual Account by calling the Virtual Account endpoint:

Create Virtual Account Request

POST https://api.spherepay.co/v2/virtualAccount
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
    "customerId": "customer_1ab2c3d4",
    "sourceCurrency": "USD",
    "destinationCurrency": "USDC",
    "network": "ethereum",
    "walletAddress": "0x1234...abcd",
    "integratorBpsfee": "10"
}

Inspect the response for your new virtualAccount object, including bank deposit instructions:

Create Virtual Account Response

{
  "id": "virtualAccount_987xyz654",
  "active": true,
  "fees": {
    "totalBpsRate": "20",
    "integratorFee": {
      "bpsRate": "10"
    },
    "platformFee": {
      "bpsRate": "10"
    }
  },
  "depositInstructions": {
    "currency": "USD",
    "bankName": "Bank of Example",
    "bankAccountNumber": "000123456789",
    "bankRoutingNumber": "1234567890",
    "bankBeneficiaryName": "John Doe",
    "bankBeneficiaryAddress": "123 Main St, Anytown, USA"
  },
  "destination": {
    "currency": "USDC",
    "walletAddress": "0x1234...abcd",
    "network": "ethereum"
  },
  "created": "2025-04-20T21:49:46.697Z",
  "updated": "2025-04-20T21:50:18.854Z"
}

Fund the account by sending the exact USD amount to the provided bank details. SpherePay will automatically convert the deposit to USDC and deliver it to your wallet.

For full API details, see our Virtual Account API Reference and Virtual Account Guide.

June 18, 2025

Introducing Starknet Network Support

We are excited to announce that we have added support for Starknet network for USDC onRamp and offRamp. This means that you can now accept and send transfers using Starknet network.

How to use it?

You can use the network parameter to specify the network you want to use for the onRamp and offRamp.

offRamp Request

{
    "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
    "amount": "1.12",
    "source": {
        "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
        "network": "starknet",
        "currency": "usdc"
    },
    "destination": {
        "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
        "network": "achSameDay",
        "currency": "usd"
    }
}

onRamp Request

{
    "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
    "amount": "2",
    "source": {
        "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
        "network": "wire",
        "currency": "usd"
    },
    "destination": {
        "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
        "network": "starknet",
        "currency": "usdc"
    }
}

June 03, 2025

API Endpoint Deprecation

API Endpoint Deprecation: The /v1/customer endpoint will be deprecated on June 6, 2025.

Action Required: Migrate to /v2/customer before the deprecation date.

Benefits: /v2/customer is the new standard for creating and managing customers and will receive additional features for easier onboarding.

Migration Guide: See our Customer API documentation for the full details.

On this page