Reactivate a Deactivated Onramper Account

Use this endpoint to reactivate a previously deactivated Onramper Account. Once reactivated, the account resumes processing fiat deposits and automatically converting them to stablecoins. The deposit instructions, destination wallet, and fee configuration are preserved from before deactivation — no reconfiguration is required.

Endpoint

POST https://api.spherepay.co/v2/virtual-account/{id}/reactivate

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

string

required

The Onramper Account ID to reactivate (e.g., "virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6").

  -H "Authorization: Bearer $SPHERE_API_KEY"

Response fields

string

Unique identifier for the Onramper Account.

customer

string

ID of the customer who owns this account.

active

boolean

Returns true after successful reactivation.

depositInstructions

object

Bank account details your customer uses to deposit fiat funds. These are unchanged from before deactivation.

Show properties

currency

string

The fiat currency accepted.

bankName

string

Name of the receiving bank.

bankAddress

string

Physical address of the receiving bank.

bankAccountNumber

string

Virtual bank account number to deposit to.

bankRoutingNumber

number

ABA routing number of the receiving bank.

bankBeneficiaryName

string

Name of the beneficiary.

bankBeneficiaryAddress

string

Address of the beneficiary.

iban

string

IBAN for SEPA deposits (EUR accounts).

bic

string

BIC/SWIFT code for SEPA deposits (EUR accounts).

destination

object

The configured crypto destination.

Show properties

currency

string

The stablecoin funds are converted to.

walletAddress

string

Destination wallet address.

network

string

Blockchain network of the destination wallet.

fee

object

Fee configuration for this account.

Show properties

totalBpsRate

string

Total fee in basis points (platform + integrator).

integratorFee.bpsRate

string

Integrator fee in basis points.

platformFee.bpsRate

string

SpherePay platform fee in basis points.

created

string

ISO 8601 timestamp of when the account was created.

updated

string

ISO 8601 timestamp of the reactivation.

  "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-22T09:00:00.000Z"
}

Error responses

Status	Code	Description
`400`	`address/invalid`	The request is malformed or the ID format is invalid.
`404`	`resource/not-found`	No Onramper Account with the specified ID exists.
`422`	`validation/failed`	Validation failed. The response includes a per-field `errors` array.

Documentation Index

​Endpoint

​Authentication

​Path parameters

​Response fields

​Error responses

Endpoint

Authentication

Path parameters

Response fields

Error responses