Virtual Account
Update Virtual Account
AuthorizationBearer <token>
JWT Bearer token authentication
In: header
Path Parameters
virtual_account_idstring
The virtual account's unique ID generated by SpherePay upon virtual account creation.
Match
^virtualAccount_[a-z0-9]+$destinationCurrencystring
The stablecoin received from sending funds to the virtual account. See Currency Codes.
Value in
"USDC" | "USDT"networkstring
The blockchain network for the destination wallet. See Onramper Accounts and Supported Rails & Currencies for supported networks.
walletAddressstring
The wallet address to send the funds to.
integratorBpsFee?string
The basis point percentage fee for the integrator.
Default
"0"Match
^[0-9]+$Response Body
curl -X PATCH "https://api.sandbox.spherepay.co/v2/virtual-account/virtualAccount_1ab2c3d4" \
-H "Content-Type: application/json" \
-d '{
"sourceCurrency": "USD",
"destinationCurrency": "USDC",
"network": "ethereum",
"walletAddress": "0x1234...abcd"
}'{
"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"
}{
"ts": "2025-04-20T00:09:16.870Z",
"error": {
"information": [
"Required"
]
}
}{
"ts": "2025-04-20T00:09:16.870Z",
"error": {
"general": "{{information}} Not Found"
}
}