Skip to main content
Use this endpoint to deactivate an Onramper Account. Once deactivated, the account stops processing new fiat deposits — any funds deposited to the virtual bank account after deactivation will not be converted and forwarded. The account’s deposit instructions remain unchanged and the account can be reactivated at any time using the reactivate endpoint.
Deactivating an account stops all new deposit processing immediately. Inform your customer before deactivating their virtual account to avoid unexpected rejections of incoming funds.

​
Endpoint

POST https://api.spherepay.co/v2/virtual-account/{id}/deactivate
The source documentation shows this as a PATCH request. Verify the exact HTTP method against your SpherePay dashboard or contact support if you encounter a method mismatch.

​
Authentication

All requests require a Bearer token in the Authorization header. 
Authorization: Bearer <token>

​
Path parameters

​
id
string
required
The Onramper Account ID to deactivate (e.g., "virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6").
  -H "Authorization: Bearer $SPHERE_API_KEY"

​
Response fields

​
id
string
Unique identifier for the Onramper Account.
​
customer
string
ID of the customer who owns this account.
​
active
boolean
Returns false after successful deactivation.
​
depositInstructions
object
Bank account details. These remain unchanged after deactivation.
​
destination
object
The configured crypto destination.
​
fee
object
Fee configuration for this account.
​
created
string
ISO 8601 timestamp of when the account was created.
​
updated
string
ISO 8601 timestamp of the deactivation.
  "id": "virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "customer": "customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  "active": false,
  "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-20T16:00:00.000Z"
}

​
Error responses

StatusCodeDescription
400address/invalidThe request is malformed or the ID format is invalid.
404resource/not-foundNo Onramper Account with the specified ID exists.
422validation/failedValidation failed. The response includes a per-field errors array.
Last modified on May 12, 2026