在消費帳戶之間轉帳

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

此操作僅在你自己的消費帳戶之間轉移資金。消費帳戶是一種現金餘額帳戶（UserCashBalance 型別）。此 mutation 會將資金從你的一個消費帳戶移至另一個消費帳戶。若要將資金轉給其他 Fluz 使用者，請改用轉帳到另一個 Fluz 錢包。

在消費帳戶之間轉移資金

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

TransferInternalBalanceInput

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

兩個 ID 都必須是你自己的消費帳戶。

使用取得消費帳戶來查詢每個消費帳戶的 userCashBalanceId。來源與目標必須是兩個不同的消費帳戶，且來源必須有足夠的可用餘額來支付此次轉帳。

範例請求

GraphQL

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

{
  "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	與帳戶關聯的席次識別碼。

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

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

​TransferInternalBalanceInput

​兩個 ID 都必須是你自己的消費帳戶。

​範例請求

​範例輸入

​範例回應

​瞭解回應內容

​cashBalanceDeposit

​withdraw

在消費帳戶之間轉移資金

TransferInternalBalanceInput

兩個 ID 都必須是你自己的消費帳戶。

範例請求

範例輸入

範例回應

瞭解回應內容

cashBalanceDeposit

withdraw