---
title: "Create Collection Account"
method: POST
path: "/v3/collection_account"
---

# Create Collection Account

`POST /v3/collection_account`

Create a new virtual account or stablecoin wallet for collecting funds.

## Request body

- object
  - `type` 'virtual_account' | 'wallet', required — Type of collection account to create.
  - `description` string — Usecase description for opening this account.
  - `on_behalf_of` string — ID of the entity in case the collection account is being configured on behalf of an entity.
  - `country` string — Country in which the account is opened (ISO 3166 alpha-2). Mandatory for virtual accounts.
  - `currencies` string[] — Currencies to enable for the account, in ISO format. Mandatory for virtual accounts.
  - `payment_method_type` 'wire_transfer' | 'local_bank_transfer_cad' | 'local_bank_transfer_sgd' | 'local_bank_transfer_krw' | 'local_bank_transfer_dkk' | 'local_bank_transfer_ngn' | 'local_bank_transfer_vnd' | 'local_bank_transfer_gbp' | 'local_bank_transfer_eur' | 'local_bank_transfer_usd' | 'local_bank_transfer_php' | 'local_bank_transfer_idr' | 'local_bank_transfer_aud' | 'stablecoin_usdt' | 'stablecoin_usdc', required — Type of payment method for the collection account.
  - `wallet` object — Wallet-specific details. Required when type is wallet.
    - `type` string, required — Blockchain type (e.g. Ethereum, Tron, Solana, Algorand, Arbitrum, Avalanche, Base, Flow, Hedera, Near, Noble, Polkadot, Polygon Pos, Stellar, Binance, Op Mainnet).
  - `alias` string — Nickname for the account.
  - `metadata` object — Set of key-value pairs to attach to the collection account object.

## Response `200`

Collection account created 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/revisions/bf5f4b8f6f5d/schema)