> ## 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.

# 在消費帳戶之間轉帳

在你自己的兩個 Fluz **消費帳戶**之間移轉資金——於單一操作中，從來源消費帳戶提領並存入目標消費帳戶，使用 `transferInternalBalance` mutation。

<Note>
  **此操作僅在你自己的消費帳戶之間轉移資金。**

  消費帳戶是一種現金餘額帳戶（`UserCashBalance` 型別）。此 mutation 會將資金從你的一個消費帳戶移至另一個消費帳戶。若要將資金轉給**其他 Fluz 使用者**，請改用[轉帳到另一個 Fluz 錢包](/features/transfer-to-another-fluz-wallet)。
</Note>

***

## 在消費帳戶之間轉移資金

若要將資金從一個消費帳戶移至另一個，請使用 `transferInternalBalance` mutation。它接受一個 `TransferInternalBalanceInput` 輸入物件，用來指定來源消費帳戶、目標消費帳戶，以及金額。

### TransferInternalBalanceInput

| Field                        | Type    | Required | Description                                    |
| ---------------------------- | ------- | -------- | ---------------------------------------------- |
| amount                       | Float!  | Yes      | 要從來源消費帳戶轉至目標消費帳戶的金額。                           |
| idempotencyKey               | String! | Yes      | 由客戶端產生的唯一字串，用於確保冪等請求處理。若相同的鍵被多次提交，只有第一次請求會被處理。 |
| sourceUserCashBalanceId      | UUID!   | Yes      | 要提領資金的消費帳戶。                                    |
| destinationUserCashBalanceId | UUID!   | Yes      | 要存入資金的消費帳戶。                                    |

<Callout icon="💡">
  ### 兩個 ID 都必須是你自己的消費帳戶。

  使用[取得消費帳戶](/features/get-spend-accounts)來查詢每個消費帳戶的 `userCashBalanceId`。來源與目標必須是兩個不同的消費帳戶，且來源必須有足夠的可用餘額來支付此次轉帳。
</Callout>

### 範例請求

GraphQL

```text theme={null}
mutation transferInternalBalance($input: TransferInternalBalanceInput!) {
  transferInternalBalance(input: $input) {
    cashBalanceDeposit {
      cashBalanceDepositId
      depositDisplayId
      depositAmount
      depositFee
      bankAccountId
      transactionDate
      clearedDate
      status
      expectedClearedDate
      cashBalanceDepositType
      cashBalanceSettlements {
        cashBalanceSettlementId
        cashBalanceDepositId
        availabilityType
        status
      }
    }
    withdraw {
      withdrawId
      amount
      processingFee
      chargedFee
      status
      displayStatus
      withdrawSource
      submissionDate
      createdAt
      updatedAt
      transactionLogId
      externalTransactionId
      payoutId
      emailAddress
      bankAccountId
      userCashBalanceId
      seatId
    }
  }
}
```

### 範例輸入

此範例中，將 \$6.00 從來源消費帳戶移轉至目標消費帳戶。

JSON

```text theme={null}
{
  "idempotencyKey": "1f1df3e7-5d43-4e3d-83de-31922d4aefb7",
  "amount": 6.00,
  "sourceUserCashBalanceId": "6d1b4b19-deef-42f5-80d7-ec34804ce090",
  "destinationUserCashBalanceId": "bb584e49-d030-4a6e-a5a9-1c34368cbaed"
}
```

### 範例回應

***

## 瞭解回應內容

內部轉帳會被記錄為兩個相互關聯的動作：從來源消費帳戶的**提領**，以及存入目標消費帳戶的**存款**。回應會同時回傳兩者。

| Field Name         | Type               | Description   |
| ------------------ | ------------------ | ------------- |
| cashBalanceDeposit | CashBalanceDeposit | 存入目標消費帳戶的存款。  |
| withdraw           | Withdraw           | 從來源消費帳戶提領的紀錄。 |

### cashBalanceDeposit

`cashBalanceDeposit` 物件包含存入目標消費帳戶的詳細資料。

| Field Name             | Type                      | Description                                                         |
| ---------------------- | ------------------------- | ------------------------------------------------------------------- |
| cashBalanceDepositId   | UUID!                     | 現金餘額存款的唯一識別碼。                                                       |
| depositDisplayId       | String!                   | 用於使用者介面的存款顯示識別碼。                                                    |
| depositAmount          | String!                   | 存款金額。                                                               |
| depositFee             | String                    | 與存款相關的手續費（若適用）。                                                     |
| bankCardId             | UUID                      | 用於存款的銀行卡識別碼。                                                        |
| bankAccountId          | UUID                      | 用於存款的銀行帳戶識別碼。                                                       |
| paypalVaultId          | UUID                      | 用於存款的 PayPal vault 識別碼。                                             |
| transactionDate        | DateTime!                 | 交易發生的日期與時間。                                                         |
| clearedDate            | DateTime                  | 存款入帳的日期與時間（若適用）。                                                    |
| status                 | CashBalanceDepositStatus! | 存款的目前狀態。                                                            |
| expectedClearedDate    | DateTime!                 | 預計入帳的日期與時間。                                                         |
| cashBalanceDepositType | CashBalanceDepositType!   | 現金餘額存款的類型，包括 CASH\_BALANCE、GIFT\_CARD\_PREPAYMENT、RESERVE\_BALANCE。 |
| cashBalanceSettlements | \[CashBalanceSettlement]  | 存款的結算時間細節，包括狀態與類型。                                                  |

### withdraw

`withdraw` 物件包含從來源消費帳戶提領的詳細資料。

| Field Name            | Type            | Description                  |
| --------------------- | --------------- | ---------------------------- |
| withdrawId            | UUID!           | 提領的唯一識別碼。                    |
| amount                | String!         | 提領金額。                        |
| processingFee         | String!         | 提領處理所收取的手續費。                 |
| chargedFee            | String!         | 向使用者收取的提領手續費。                |
| status                | String!         | 提領的內部狀態。                     |
| displayStatus         | String!         | 提領的使用者可讀顯示狀態。                |
| withdrawSource        | WithdrawSource! | 提領資金來源的餘額類型。                 |
| submissionDate        | DateTime!       | 提交提領的日期與時間。                  |
| createdAt             | DateTime!       | 建立提領的日期與時間。                  |
| updatedAt             | DateTime!       | 最後更新提領的日期與時間。                |
| transactionLogId      | UUID            | 關聯交易記錄的識別碼。                  |
| externalTransactionId | String          | 付款閘道的外部交易識別碼（用於 ACH）。        |
| payoutId              | String          | 付款閘道的撥款識別碼（用於 PayPal/Venmo）。 |
| emailAddress          | String          | 與提領關聯的電子郵件地址。                |
| bankAccountId         | UUID            | 使用的銀行帳戶識別碼（若適用）。             |
| userCashBalanceId     | UUID            | 提領資金之來源消費帳戶的識別碼。             |
| seatId                | UUID            | 與帳戶關聯的席次識別碼。                 |

<Warning>
  **需要授權**

  此 mutation 需要 `MAKE_INTERNAL_TRANSFER` 權限範圍。請在嘗試於消費帳戶之間進行內部轉帳前，確認你的 access token 已被授予此範圍。
</Warning>

<br />