---
title: "Update Collection Account"
method: PUT
path: "/v3/collection_account/{id}"
---

# Update Collection Account

`PUT /v3/collection_account/{id}`

Update the metadata or alias of an existing collection account.

## Path parameters

- `id` string, required

## Request body

- object
  - `metadata` object — Set of key-value pairs to attach to the collection account object.

## Response `200`

Collection account updated successfully.

- CollectionAccount — Represents a collection account (virtual account or stablecoin wallet).
  - `id` string — Unique identifier. Starts with cva_ (virtual account), cwa_ (wallet), or cta_.
  - `object` string — Always "collection_account".
  - `type` 'virtual_account' | 'wallet' — Type of collection account.
  - `description` string — Usecase description for this account.
  - `on_behalf_of` string — ID of the entity this account is configured on behalf of.
  - `country` string — Country in which the account is opened (ISO 3166 alpha-2).
  - `currencies` string[] — List of currencies enabled for this account.
  - `payment_method_type` string — Type of payment method for this account.
  - `virtual_account` object — Virtual account bank details. Present when type is virtual_account.
    - `account_holder_name` string — Name of the account holder.
    - `account_number` string — Account number.
    - `iban` string — IBAN (if applicable).
    - `bank_name` string — Name of the bank.
    - `bank_branch` string — Branch name.
    - `bank_address` object — Address of the bank.
      - `address_line_1` string
      - `address_line_2` string
      - `city` string
      - `country` string
    - `bank_codes` object — Bank codes (e.g. swift_code, routing_code, sort_code, ach_routing_number, etc.).
    - `account_reenablement_supported` boolean — Whether the account can be re-enabled after being disabled.
  - `wallet` object — Wallet details. Present when type is wallet.
    - `type` string — Blockchain type (e.g. Ethereum, Tron, Solana).
    - `deposit_address` string — Deposit address for the wallet.
  - `status` 'disabled' | 'enabled' — Current status of the collection account.
  - `requests` CollectionAccountRequest[] — Enablement, disablement, or reenablement requests attached to this account.
    - `id` string — Unique ID of the request.
    - `object` string — Always "collection_account_request".
    - `collection_account_id` string — ID of the linked collection account.
    - `type` 'enablement' | 'disablement' | 'reenablement' — Type of request.
    - `status` 'processing' | 'approval_hold' | 'requires_action' | 'succeeded' | 'failed' | 'cancelled' — Current status of the request.
    - `requested_currencies` string[] — Currencies requested for enablement (present on enablement requests).
    - `created_at` string, date-time — Timestamp when the request was created.
    - `updated_at` string, date-time — Timestamp when the request was last updated.
    - `status_description` string — Description of the current status or failure reason.
  - `status_description` string — Description of the current status (e.g. disablement reason).
  - `alias` string — Nickname for the account.
  - `balance_transaction` string — ID of the balance transaction linked to this collection account.
  - `metadata` object — Key-value pairs attached to the collection account.
  - `created_at` string, date-time — Timestamp when the account was created.
  - `updated_at` string, date-time — Timestamp when the account was last updated.

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/versions/bf5f4b8f6f5d/schema)