> ## Documentation Index
> Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Collection Account

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



## OpenAPI

````yaml post /v3/collection_account
openapi: 3.1.0
info:
  title: sandbox
  version: '3'
servers:
  - url: https://service-sandbox.tazapay.com
security:
  - sec0: []
paths:
  /v3/collection_account:
    post:
      summary: Create Collection Account
      description: Create a new virtual account or stablecoin wallet for collecting funds.
      operationId: create-collection-account
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - type
                - payment_method_type
              properties:
                type:
                  type: string
                  enum:
                    - virtual_account
                    - wallet
                  description: Type of collection account to create.
                description:
                  type: string
                  description: Usecase description for opening this account.
                on_behalf_of:
                  type: string
                  description: >-
                    ID of the entity in case the collection account is being
                    configured on behalf of an entity.
                country:
                  type: string
                  description: >-
                    Country in which the account is opened (ISO 3166 alpha-2).
                    Mandatory for virtual accounts.
                currencies:
                  type: array
                  items:
                    type: string
                  description: >-
                    Currencies to enable for the account, in ISO format.
                    Mandatory for virtual accounts.
                payment_method_type:
                  type: string
                  enum:
                    - 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
                  description: Type of payment method for the collection account.
                wallet:
                  type: object
                  description: Wallet-specific details. Required when type is wallet.
                  properties:
                    type:
                      type: string
                      description: >-
                        Blockchain type (e.g. Ethereum, Tron, Solana, Algorand,
                        Arbitrum, Avalanche, Base, Flow, Hedera, Near, Noble,
                        Polkadot, Polygon Pos, Stellar, Binance, Op Mainnet).
                  required:
                    - type
                alias:
                  type: string
                  description: Nickname for the account.
                metadata:
                  type: object
                  description: >-
                    Set of key-value pairs to attach to the collection account
                    object.
            examples:
              Virtual Account:
                value:
                  type: virtual_account
                  payment_method_type: local_bank_transfer_cad
                  country: CA
                  currencies:
                    - CAD
                  description: This account is used for CAD collections
                  alias: CAD Collection Account
              Stablecoin Wallet:
                value:
                  type: wallet
                  payment_method_type: stablecoin_usdt
                  wallet:
                    type: Ethereum
                  description: USDT Ethereum wallet for collections
      responses:
        '200':
          description: Collection account created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionAccount'
              examples:
                Virtual Account:
                  summary: Virtual Account
                  value:
                    id: cva_crqinja9chqqs7moi8rg
                    object: collection_account
                    type: virtual_account
                    payment_method_type: local_bank_transfer_cad
                    country: CA
                    currencies:
                      - CAD
                    status: disabled
                    alias: CAD Collection Account
                    description: This account is used for CAD collections
                    virtual_account:
                      account_holder_name: John Doe
                      account_number: 1234567890-56-7890
                      iban: ''
                      bank_name: RBC Royal Bank
                      bank_branch: Main Branch
                      bank_address:
                        address_line_1: 100 Main St
                        city: Toronto
                        country: Canada
                      bank_codes:
                        routing_code: '026009593'
                        swift_code: ROYCCAT2
                      account_reenablement_supported: true
                    requests:
                      - id: req_cva001enablement
                        object: collection_account_request
                        collection_account_id: cva_crqinja9chqqs7moi8rg
                        type: enablement
                        status: processing
                        requested_currencies:
                          - CAD
                        created_at: '2024-09-26T09:39:25.03501Z'
                        updated_at: '2024-09-26T09:39:25.03501Z'
                        status_description: Activation in progress.
                    status_description: ''
                    metadata: {}
                    created_at: '2024-09-26T09:39:25.03501Z'
                    updated_at: '2024-09-26T09:39:25.03501Z'
                Stablecoin Wallet:
                  summary: Stablecoin Wallet
                  value:
                    id: cwa_abcdef1234567890
                    object: collection_account
                    type: wallet
                    payment_method_type: stablecoin_usdt
                    currencies:
                      - USD
                    status: enabled
                    wallet:
                      type: Ethereum
                      deposit_address: '0x1234567890abcdef1234567890abcdef12345678'
                    requests:
                      - id: req_cwa001enablement
                        object: collection_account_request
                        collection_account_id: cwa_abcdef1234567890
                        type: enablement
                        status: succeeded
                        created_at: '2024-09-26T09:39:25.03501Z'
                        updated_at: '2024-09-26T09:39:30.03501Z'
                        status_description: Wallet activated successfully.
                    status_description: ''
                    metadata: {}
                    created_at: '2024-09-26T09:39:25.03501Z'
                    updated_at: '2024-09-26T09:39:25.03501Z'
components:
  schemas:
    CollectionAccount:
      type: object
      description: Represents a collection account (virtual account or stablecoin wallet).
      properties:
        id:
          type: string
          description: >-
            Unique identifier. Starts with cva_ (virtual account), cwa_
            (wallet), or cta_.
        object:
          type: string
          description: Always "collection_account".
        type:
          type: string
          enum:
            - virtual_account
            - wallet
          description: Type of collection account.
        description:
          type: string
          description: Usecase description for this account.
        on_behalf_of:
          type: string
          description: ID of the entity this account is configured on behalf of.
        country:
          type: string
          description: Country in which the account is opened (ISO 3166 alpha-2).
        currencies:
          type: array
          items:
            type: string
          description: List of currencies enabled for this account.
        payment_method_type:
          type: string
          description: Type of payment method for this account.
        virtual_account:
          type: object
          description: Virtual account bank details. Present when type is virtual_account.
          properties:
            account_holder_name:
              type: string
              description: Name of the account holder.
            account_number:
              type: string
              description: Account number.
            iban:
              type: string
              description: IBAN (if applicable).
            bank_name:
              type: string
              description: Name of the bank.
            bank_branch:
              type: string
              description: Branch name.
            bank_address:
              type: object
              description: Address of the bank.
              properties:
                address_line_1:
                  type: string
                address_line_2:
                  type: string
                city:
                  type: string
                country:
                  type: string
            bank_codes:
              type: object
              description: >-
                Bank codes (e.g. swift_code, routing_code, sort_code,
                ach_routing_number, etc.).
              additionalProperties:
                type: string
            account_reenablement_supported:
              type: boolean
              description: Whether the account can be re-enabled after being disabled.
        wallet:
          type: object
          description: Wallet details. Present when type is wallet.
          properties:
            type:
              type: string
              description: Blockchain type (e.g. Ethereum, Tron, Solana).
            deposit_address:
              type: string
              description: Deposit address for the wallet.
        status:
          type: string
          enum:
            - disabled
            - enabled
          description: Current status of the collection account.
        requests:
          type: array
          description: >-
            Enablement, disablement, or reenablement requests attached to this
            account.
          items:
            $ref: '#/components/schemas/CollectionAccountRequest'
        status_description:
          type: string
          description: Description of the current status (e.g. disablement reason).
        alias:
          type: string
          description: Nickname for the account.
        balance_transaction:
          type: string
          description: ID of the balance transaction linked to this collection account.
        metadata:
          type: object
          description: Key-value pairs attached to the collection account.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the account was created.
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the account was last updated.
    CollectionAccountRequest:
      type: object
      description: >-
        An enablement, disablement, or reenablement request attached to a
        collection account.
      properties:
        id:
          type: string
          description: Unique ID of the request.
        object:
          type: string
          description: Always "collection_account_request".
        collection_account_id:
          type: string
          description: ID of the linked collection account.
        type:
          type: string
          enum:
            - enablement
            - disablement
            - reenablement
          description: Type of request.
        status:
          type: string
          enum:
            - processing
            - approval_hold
            - requires_action
            - succeeded
            - failed
            - cancelled
          description: Current status of the request.
        requested_currencies:
          type: array
          items:
            type: string
          description: >-
            Currencies requested for enablement (present on enablement
            requests).
        created_at:
          type: string
          format: date-time
          description: Timestamp when the request was created.
        updated_at:
          type: string
          format: date-time
          description: Timestamp when the request was last updated.
        status_description:
          type: string
          description: Description of the current status or failure reason.
  securitySchemes:
    sec0:
      type: http
      scheme: basic

````