Pular para o conteúdo principal
Deactivate a Virtual Account
curl --request PATCH \
  --url https://api.spherepay.co/v2/virtual-account/{virtualAccountId}/deactivate \
  --header 'Authorization: Bearer <token>'
{
  "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"
}
Use este endpoint para desativar uma Onramper Account. Uma vez desativada, a conta para de processar novos depósitos em fiat — qualquer fundo depositado na conta bancária virtual após a desativação não será convertido e encaminhado. As instruções de depósito da conta permanecem inalteradas e a conta pode ser reativada a qualquer momento usando o endpoint de reativação.
Desativar uma conta para todo o processamento de novos depósitos imediatamente. Informe seu cliente antes de desativar a conta virtual para evitar rejeições inesperadas de fundos recebidos.

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

​
virtualAccountId
string
obrigatório

Resposta

​
id
string
obrigatório

Unique identifier for the virtual account.

Exemplo:

"virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"

​
active
boolean
obrigatório

Whether the virtual account is currently active and accepting deposits.

Exemplo:

true

​
depositInstructions
object
obrigatório

Bank account details that depositors should use to send fiat funds into the virtual account.

​
destination
object
obrigatório

The crypto destination where converted funds are sent after deposit.

​
created
string
obrigatório

Timestamp when the virtual account was created (ISO 8601).

Exemplo:

"2025-01-15T10:30:00.000Z"

​
updated
string
obrigatório

Timestamp when the virtual account was last updated (ISO 8601).

Exemplo:

"2025-01-15T12:00:00.000Z"

​
customer
string

The customer ID who owns the virtual account.

Exemplo:

"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"

​
fee
object

Fee breakdown for the virtual account, including integrator and platform fees.

Última modificação em 18 de junho de 2026