# VirtualAccount

Schema: #/components/schemas/VirtualAccount

Method: SCHEMA
Version: 1.0.0

## Schema fields:

  - `account_id` (string, required)
    The unique identifier for the virtual account.
    Example: va_6943ae9eFO3GW

  - `currency` (string, required)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format.
    Example: USD

  - `name` (string, required)
    The name associated with the virtual account, typically the business name.
    Example: test response

  - `status` (string, required)
    The current status of the virtual account.
- `active` — the account can receive funds.
- `inactive` — the account exists but cannot receive funds yet.
- `disabled` — the account has been closed and does not receive funds.
    Enum: "active", "inactive", "disabled"

  - `created_at` (string, required)
    When the virtual account was created, as an ISO 8601 date-time in UTC.
    Example: 2025-08-19T07:00:00Z

  - `updated_at` (string, required)
    When the virtual account was last updated, as an ISO 8601 date-time in UTC.
    Example: 2025-08-19T07:00:00Z

  - `disabled_at` (string | null)
    When the virtual account was disabled, as an ISO 8601 date-time in UTC. `null` if the account has not been disabled.
    Example: null

  - `merchant_id` (string, required)
    The unique identifier for the merchant associated with the virtual account.
    Example: merch_694bb0289P4Cz

  - `account_number` (string)
    The unique account number for the virtual account, formatted according to the country's banking standards. Applicable for AED, GBP, AUD, and USD accounts.
    Example: AE580863912382801669068

  - `iban` (string)
    The International Bank Account Number (IBAN) for the virtual account. Applicable for EUR accounts.
    Example: DK2089000025417759

  - `sort_code` (string)
    The sort code for the virtual account. Applicable for GBP accounts.
    Example: 608382

  - `bsb_number` (string)
    The Bank State Branch (BSB) number for the virtual account. Applicable for AUD accounts.
    Example: 252000

  - `routing_number` (string)
    The routing number for the virtual account. Applicable for USD accounts.
    Example: 026009593

  - `payment_rails` (string)
    The payment rail type for the virtual account. Applicable for USD accounts. Possible values are 'ach' for ACH transfers and 'wire' for Fedwire transfers.
    Enum: "ach", "wire"