--- title: "Update a Virtual Account" method: PUT path: "/customers/{customerID}/virtual_accounts/{virtualAccountID}" tags: ["Virtual Accounts"] --- # Update a Virtual Account `PUT /customers/{customerID}/virtual_accounts/{virtualAccountID}` Update instructions for an existing Virtual Account ## Path parameters - `customerID` string, required — A UUID that uniquely identifies a resource - `virtualAccountID` string, required — A UUID that uniquely identifies a resource ## Request body - UpdateVirtualAccount - `destination` UpdateVirtualAccountDestination - `currency` 'usdb' | 'usdc' | 'usdt' | 'pyusd' | 'eurc' - `payment_rail` 'arbitrum' | 'avalanche_c_chain' | 'base' | 'celo' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'tempo' | 'tron' - `address` string — The crypto wallet address that the customer wishes to ultimately receive funds at - `blockchain_memo` string — The memo to include when sending funds on chain. Only allowed for blockchains that support memos such as Stellar - `bridge_wallet_id` string — A UUID that uniquely identifies a resource - `developer_fee_percent` string, number — The developer fee percent that will be applied to this Virtual Account. The value is a base 100 percentage, i.e. 10.2% is 10.2 in the API. - `fee_config` FeeConfigRequest — Developer fee configuration. Available by request only. Contact Bridge to enable this feature for your developer account. The `source` object supports direct fee parameters as a shorthand for a default fee, an explicit `default` key, payment-rail keys (e.g. `ach_push`, `wire`), or a mixed default-plus-override form. - `source` union — Source-side fee configuration. Supports direct fee params under `source`, an explicit `default` key, payment-rail keys such as `ach_push` and `wire`, or a mixed default-plus-override form. - FeeConfigFeeParams — Fee parameters for a specific payment rail or default configuration - `fee_percent` string, number — Percentage fee (0-100, exclusive). Applied to the amount remaining after any flat fee deduction. - `fee_amount` string, number — Flat fee amount deducted before percentage calculation - `minimum_fee` string, number — Minimum total fee floor - `maximum_fee` string, number — Maximum total fee cap - object ## Response `200` Updated Virtual Account object - VirtualAccountResponse - `id` string — A UUID that uniquely identifies a resource - `status` 'activated' | 'deactivated' — The activation status of the Virtual Account - `developer_fee_percent` string, number — The developer fee percent that will be applied to this Virtual Account. The value is a base 100 percentage, i.e. 10.2% is 10.2 in the API. - `fee_config` FeeConfigResponse — Developer fee configuration. Available by request only. Contact Bridge to enable this feature for your developer account. Responses render source-side fees keyed by payment rail, using `default` for a catch-all configuration. - `source` object — Source-side fee configuration keyed by payment rail or `default` - `customer_id` string — A UUID that uniquely identifies a resource - `created_at` string, date-time — Time of creation of the virtual account - `source_deposit_instructions` union - VirtualAccountSourceDepositInstructionsUs - `bank_account_number` string, required — The account number of the bank that the customer should send the deposit to - `bank_routing_number` string, required — The routing number of the bank that the customer should send the deposit to - `bank_beneficiary_name` string, required — If available, the name of the beneficiary of the bank account that the customer should send the deposit to - `bank_beneficiary_address` string, required — If available, the address of the beneficiary of the bank account that the customer should send the deposit to - `currency` 'usd', required - `payment_rail` 'ach_push' | 'bre_b' | 'faster_payments' | 'pix' | 'sepa' | 'spei' | 'wire' - `payment_rails` string[], required — The payment rails supported by these deposit instructions - `bank_name` string, required — The name of the bank that the customer should send the deposit to - `bank_address` string, required — The address of the bank that the customer should send the deposit to - VirtualAccountSourceDepositInstructionsEu - `iban` string, required — he IBAN of the account that the customer should send the deposit to - `bic` string, required — The BIC of the bank that the customer should send the deposit to - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to. - `currency` 'eur', required - `payment_rails` 'sepa', required - `bank_name` string, required — The name of the bank that the customer should send the deposit to - `bank_address` string, required — The address of the bank that the customer should send the deposit to - VirtualAccountSourceDepositInstructionsMx - `clabe` string, required — The CLABE (account number) of the account that the customer should send the deposit to - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to. - `currency` 'mxn', required - `payment_rails` string[], required — The payment rails supported by these deposit instructions - `bank_name` string, required — The name of the bank that the customer should send the deposit to - `bank_address` string, required — The address of the bank that the customer should send the deposit to - VirtualAccountSourceDepositInstructionsBr - `br_code` string, required — The BR Code that the customer should send the deposit to - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to. - `currency` 'brl', required - `payment_rails` string[], required — The payment rails supported by these deposit instructions - `bank_name` string, required — The name of the bank that the customer should send the deposit to - `bank_address` string, required — The address of the bank that the customer should send the deposit to - VirtualAccountSourceDepositInstructionsGb - `account_number` string, required — The bank account number - `sort_code` string, required — The sort code, without hyphens - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to. - `currency` 'gbp', required - `payment_rails` 'faster_payments', required - `bank_name` string, required — The name of the bank that the customer should send the deposit to - `bank_address` string, required — The address of the bank that the customer should send the deposit to - VirtualAccountSourceDepositInstructionsCo - `bre_b_key` string, required — The Bre-B key of the Colombian bank account for receiving COP deposits - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to. - `deposit_message` string — The reference message to include with the COP deposit - `currency` 'cop', required - `payment_rails` string[], required — The payment rails supported by these deposit instructions - `bank_name` string, required — The name of the bank that the customer should send the deposit to - `bank_address` string, required — The address of the bank that the customer should send the deposit to - `destination` VirtualAccountDestination - `currency` 'usdb' | 'usdc' | 'usdt' | 'pyusd' | 'eurc', required - `payment_rail` 'arbitrum' | 'avalanche_c_chain' | 'base' | 'celo' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'tempo' | 'tron', required - `address` string — The crypto wallet address that the customer wishes to ultimately receive funds at - `blockchain_memo` string — The memo to include when sending funds on chain. Only allowed for blockchains that support memos such as Stellar - `bridge_wallet_id` string — A UUID that uniquely identifies a resource - `prefunded_account_id` string — A UUID that uniquely identifies a resource --- [API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)