Update a virtual account

curl -X POST "$RHEON_API/v1/virtual-accounts/va_8f2c91d0a4" \
  -H "Authorization: Bearer $RHEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "0x3333333333333333333333333333333333333333",
    "feeBps": 50
  }'

{
  "id": "va_8f2c91d0a4",
  "wallet": "0x3333333333333333333333333333333333333333",
  "chain": "arbitrum",
  "asset": "USDC",
  "rail": "sepa",
  "currency": "EUR",
  "reference": "user-84921",
  "details": {
    "iban": "IE25XXXX99035504017602",
    "bankName": "Example Bank",
    "swiftCode": "EXAMPIE2XXX",
    "accountName": "Rheon Payments"
  },
  "feeBps": 50,
  "active": true,
  "createdAt": "2026-08-31T10:00:00Z"
}

Not available yet. This endpoint answers 501 not_implemented. The banking partner integration can open an account and report when it is funded, but cannot read one back or amend it, and we will not invent data or pretend the account never existed. Keep the details returned by creation until this lands.

Updates a virtual account. Two things can change: the destination wallet and your fee. The bank details, the rail, and the currency are fixed for the life of the account - the payer saved them, so they must keep working. To collect on a different rail or currency, create a new account. Needs the virtual-accounts permission on your key - see Authentication.

Request

string

required

The virtual account id.

string

A new destination wallet on the same chain. Transfers that arrive after the update settle to the new wallet; a transfer already converting when you update settles to the wallet that was set when it arrived.

number

A new fee in basis points. Applies to money that arrives after the update.

Send at least one of the two. Fields you omit keep their value.

Response

The full updated account object, in the same shape create returns.

curl -X POST "$RHEON_API/v1/virtual-accounts/va_8f2c91d0a4" \
  -H "Authorization: Bearer $RHEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "0x3333333333333333333333333333333333333333",
    "feeBps": 50
  }'

{
  "id": "va_8f2c91d0a4",
  "wallet": "0x3333333333333333333333333333333333333333",
  "chain": "arbitrum",
  "asset": "USDC",
  "rail": "sepa",
  "currency": "EUR",
  "reference": "user-84921",
  "details": {
    "iban": "IE25XXXX99035504017602",
    "bankName": "Example Bank",
    "swiftCode": "EXAMPIE2XXX",
    "accountName": "Rheon Payments"
  },
  "feeBps": 50,
  "active": true,
  "createdAt": "2026-08-31T10:00:00Z"
}

Errors

HTTP	`code`	When
400	`invalid_request`	Neither field sent, or a field is malformed.
401	`unauthorized`	Missing, malformed, or unknown API key.
403	`permission_denied`	Your key does not carry the virtual-accounts permission.
404	`not_found`	No account with that id on your key.
429	`rate_limited`	Over your key’s rate limit.
502	`upstream_error`	The banking partner is unavailable.
500	`internal`	Unexpected server error.

Getting started

Crypto deposits

Card payments

Bank transfers

Virtual accounts

Reference

Update a virtual account

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors