Skip to main content
depositCashBalance 當你準備把資金轉入你的 Fluz 帳戶時，你可以將資金存入以下三種餘額：
  1. 現金餘額 - 一般的現金餘額存款。
  2. 禮品卡餘額 - 不可提領的禮品卡餘額存款。
  3. 保留餘額 - 存入並保留於保留餘額。

​
進行存款

進行存款需要在存取權杖上具有 MAKE_DEPOSIT 權限範圍。 若要將資金存入你的某個 Fluz 餘額，請使用 depositCashBalance mutation。此 mutation 接受 DepositCashBalanceInput 作為輸入物件型別，讓你可以指定以下細節：
  1. Amount： 必填 - 你希望存入的金額。
  2. idempotencyKey： 必填 - 由用戶端產生的唯一 UUID，確保請求只被處理一次。
  3. 資金來源 (Funding Source)： 進行存款所使用的付款方式（例如銀行帳戶、信用卡或金融卡、PayPal）。若要取得你的資金來源 ID，請使用 getWallet query。
    1. bankAccountId - 若要以銀行帳戶付款，請在 depositCashBalance mutation 中填入銀行帳戶 ID。
    2. bankCardId - 若要以銀行卡付款，請在 depositCashBalance mutation 中填入銀行卡 ID。
    3. paypalVaultID - 若要以 PayPal 帳戶付款，請在 depositCashBalance mutation 中填入 PayPal 帳戶 ID。
  4. 存款目標 (Deposit Destination)： 你要將資金存入的餘額。可用選項定義於 CashBalanceDepositType 列舉：
    1. CASH_BALANCE
    2. GIFT_CARD_BALANCE
    3. RESERVE_BALANCE
  5. 商家類別代碼 (Merchant Category Code)： 僅適用於 GIFT_CARD_BALANCE。用於依其提供的產品或服務類型分類商家的四位數代碼。使用 getMccList 以取得有效的 MCC 清單。
  6. userCashBalanceId - 若選擇 CASH_BALANCE，你可以指定要存入資金的現金餘額（消費帳戶）
  7. memo* - 若要為此交易附上備註，請在此提供純文字備註。最多 255 個字元。
  8. transactionCategory - 若要為此交易分類，請提供分類名稱。分類會在首次使用時自動建立，之後若傳入相同名稱則會重複使用。
  9. attachmentId - 若要為此交易附加檔案，請提供由上傳端點返回的 ID。請參閱 新增費用明細。📘 完整的附件上傳與備註、分類操作細節，請見 新增費用明細。

​
範例請求

graphql

​
DepositCashBalanceInput

​
範例回應

​
金融卡存款

由金融卡資助的存款可能會以**帳戶資金交易（AFT）**處理——這是一種為將資金轉入帳戶而設計的卡網路交易類型。Fluz 會在可用時自動套用；沒有欄位可供手動要求。其對你的影響在於手續費。 僅在以下所有條件皆成立時才會套用 AFT：
  • 資金來源為 bankCardId，且該卡的 cardType 為 DEBIT。
  • depositType 為 CASH_BALANCE。存入 GIFT_CARD_BALANCE 與 RESERVE_BALANCE 永不使用 AFT。
  • 該卡符合 AFT 資格。
CREDIT 與 PREPAID 銀行卡永不使用 AFT，銀行帳戶（bankAccountId）或 PayPal（paypalVaultId）亦同。它們會依其付款方式收取標準費率——這是正常結果，非錯誤。

​
金融卡存款費用

符合 AFT 資格的卡片會收取 AFT 專屬費率。不符合 AFT 資格的卡片則收取標準金融卡費率——這是正常結果，非錯誤。由於兩種費率不同，請從回應中讀取 depositFee，而不是在用戶端自行計算費用。

​
卡片資格

卡片是否支援 AFT 是卡片本身的屬性，而非你可以設定的項目。資格會在提交存款時進行評估。
資格無法事先得知，且不會延伸至提領。沒有可用的查詢能回報卡片是否支援 AFT——這會反映在該卡首次存款的費用上。存款與提領的資格彼此獨立，因此使用者可用於存款的卡片，不一定能用於提領。請參閱 提領至外部帳戶。
請處理以下金融卡存款的拒絕代碼： 在你的介面中保留另一個可用的資金來源，以避免因卡片不符資格或被拒而中斷流程。

​
存款回應

當你使用 depositCashBalance mutation 發起存款後，你將收到包含該筆存款詳細資訊的回應。 CashBalanceDeposit 物件包含你所發起存款的重要資訊。
📘 請注意 存款可能即時結算，或在 2-5 個工作天內結算。若要了解結算時間如何計算，請閱讀這篇文章。