> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.
# 虛擬帳號
> 為每個消費帳戶指派真實的匯款路由與帳號，讓外部匯款方可透過 RTP、FedNow、Wire 或 ACH 主動入金。
**虛擬帳號（VAN）** 是由銀行核發的真實路由號與帳號，指向使用者的其中一個[消費帳戶](/features/spend-accounts)。Fluz 之外的任何人——雇主、銀行、客戶、市集——都能把款項匯至該路由與帳號組合，資金會以存款形式入帳到該消費帳戶。
VAN 不持有資金。**消費帳戶才持有餘額。** VAN 只是另一個匯入該帳戶的路由地址。
**一個餘額，多個地址。**
一個消費帳戶可以擁有多個啟用中的虛擬帳號，且其中恰有一個被標記為**主要**。該帳戶上的每個 VAN 都會入帳至同一個餘額——其存在是為了區分不同的匯款方，例如薪資與特定客戶，而不需要拆分資金。
***
## 架構如何串起來
```mermaid theme={null}
flowchart LR
subgraph EXT["External Senders"]
E1[Employer payroll]
E2[User's outside bank]
E3[Customer or partner]
end
subgraph VANS["Virtual Account Numbers"]
V1["VAN — primary\nrouting + account"]
V2["VAN — secondary\nrouting + account"]
end
SA[("Spend Account\nUserCashBalance\nholds the balance")]
OUT["Gift cards · Virtual cards\nInternal transfers · Withdrawals"]
E1 -->|ACH credit| V1
E2 -->|RTP / FedNow| V1
E3 -->|Wire| V2
V1 --> SA
V2 --> SA
SA --> OUT
```
入金會透過 VAN 進來。出金依舊從消費帳戶以既有方式流出——禮品卡與虛擬卡加值、內部轉帳，以及提領至已連結的外部帳戶。
***
## 支援的金流軌道
匯入至虛擬帳號的款項支援以下四種軌道：
| 軌道 | 方向 | 一般到帳時效 | 備註 |
| ---------- | ------ | --------- | ---------------------------------- |
| **RTP** | 入帳（In） | 近乎即時、全年無休 | 匯款行須為 The Clearing House RTP 參與銀行。 |
| **FedNow** | 入帳（In） | 近乎即時、全年無休 | 匯款行須為 FedNow 參與銀行。 |
| **Wire** | 入帳（In） | 同營業日 | 僅限國內電匯。手續費由匯款行決定並向匯款方收取。 |
| **ACH** | 入帳（In） | 1–2 個營業日 | 標準 ACH credit，包括薪資直接存入。 |
**尚未支援 ACH 扣款（pull）。**
目前虛擬帳號僅能**收款**。你無法使用 VAN 的路由與帳號來發起 ACH 扣款——第三方無法用這些憑證自消費帳戶拉款。ACH 扣款支援**即將推出**。
現階段要把資金匯出，請使用[提領資金至外部帳戶](/features/withdraw-funds)或[內部轉帳](/features/transfer-between-spend-accounts)。
***
## 入帳長什麼樣
當資金匯入虛擬帳號時，Fluz 會在目標消費帳戶記上一筆標準的**存款**。該筆存款的**資金來源為虛擬帳號**——不是銀行卡、銀行帳戶或 PayPal——因為這筆錢是由 Fluz 之外主動推送入金，而非自已連結的付款方式扣款。
這代表：
* 這筆入帳會與其他存款一樣，出現在相同的交易與存款紀錄中。
* 不存在可對帳的連結資金來源物件，也沒有備援卡授權凍結，因為沒有對使用者進行任何扣款。
* 存款會歸屬於收到該款項的特定 VAN，因此當一個消費帳戶有多個 VAN 時，你可以分辨薪資入帳與客戶付款。
```mermaid theme={null}
sequenceDiagram
participant S as External sender
participant B as Receiving bank
participant F as Fluz
participant SA as Spend account
S->>B: Push funds to VAN routing + account
B->>F: Credit received (RTP / FedNow / Wire / ACH)
F->>F: Match VAN to spend account
F->>SA: Post deposit (funding source: virtual account)
F-->>S: Funds available to spend
```
***
## 取得使用者的虛擬帳號
使用 `getSpendAccountVirtualAccountNumbers` 來列出某個消費帳戶上的啟用中 VAN。它會回傳所有啟用中的 VAN，其中一個會被標記為主要。
**所需權限範圍（Scope）：** `LIST_PAYMENT`
```graphql theme={null}
query getSpendAccountVirtualAccountNumbers($userCashBalanceId: UUID!) {
getSpendAccountVirtualAccountNumbers(userCashBalanceId: $userCashBalanceId) {
virtualAccountNumberId
routingNumber
accountNumber
accountType
bankName
isPrimary
status
createdAt
}
}
```
```json Variables theme={null}
{
"userCashBalanceId": "9c1f6b2e-4d7a-4c3b-9f11-2a5e8b0d6c74"
}
```
| 參數 | 類型 | 必填 | 說明 |
| ------------------- | ------- | --- | --------------- |
| `userCashBalanceId` | `UUID!` | Yes | 你想查詢其虛擬帳號的消費帳戶。 |
回傳 `[SpendAccountVirtualAccountNumber!]!`。完整欄位列表請見[型別參考](/api-reference/types/spend-account-virtual-account-number)。
**顯示帳號資訊。**
VAN 的完整帳號屬於敏感資訊。請在清單檢視中遮罩，並只在使用者明確操作時才顯示完整值，就像你對待卡號 PAN 的方式一樣。當使用者需要將詳細資料提供給第三方時，優先使用[虛擬帳號文件](/features/virtual-account-documents)中所述的產生之 PDF 檔案，而非自由複製文字。
***
## 提供第三方所需資訊
與其要使用者手動把路由與帳號輸入薪資系統或以電子郵件傳送給相對方，Fluz 可即時產生 PDF 檔案：
| 文件 | 查詢 | 使用情境 |
| ----------- | ------------------------------------ | ------------------------------- |
| **付款指示** | `getSpendAccountPaymentInstructions` | 提供客戶或合作夥伴進行 Wire 或 ACH 入帳所需的資訊。 |
| **薪資存款表單** | `getSpendAccountPaycheckDepositForm` | 給雇主薪資部門的預先填寫直接存款表單。 |
| **帳戶狀態證明信** | `getSpendAccountStatusLetter` | 帳戶證明，可選擇顯示目前餘額。 |
三者在省略 `virtualAccountNumberId` 時，皆預設使用該消費帳戶的**主要** VAN，且三者皆需 `LIST_PAYMENT` 權限範圍。
完整參考請見[虛擬帳號文件](/features/virtual-account-documents)。
***
## 必要條件
* 使用者須至少擁有一個**啟用中的消費帳戶**。
* 讀取虛擬帳號與產生文件皆需要使用者存取權杖上的 `LIST_PAYMENT` 權限範圍。
* 虛擬帳號由 Fluz 佈建，無法透過 API 建立。
***
## 相關資源
真正持有餘額的帳戶。
付款指示、存款表單與帳戶狀態證明。
從已連結的銀行帳戶或卡片拉入資金。
Fluz 如何分類流入的資金。
***
**想了解更多嗎？** 與我們的專家聯絡以獲取更多資訊或預約示範。