Skip to main content
depositCashBalance 当你准备将资金转入你的 Fluz 账户时，可以将资金存入以下三种余额：
  1. 现金余额（Cash balance） - 常规现金余额存款。
  2. 礼品卡余额（Gift card balance） - 仅用于礼品卡余额、不可提现的存款。
  3. 预备金余额（Reserve balance） - 存入预备金余额的存款。

​
进行存款

存款需要在访问令牌上具有 MAKE_DEPOSIT 权限范围（scope）。 要将资金存入你的某个 Fluz 余额，请使用 depositCashBalance 变更。该变更接受 DepositCashBalanceInput 类型的输入对象，你可以在其中指定以下细节：
  1. Amount： 必填 - 你希望存入的金额。
  2. idempotencyKey： 必填 - 客户端生成的唯一 UUID，确保请求只被处理一次。
  3. 资金来源（Funding Source）： 进行存款时所使用的支付方式（例如银行账户、信用卡或借记卡、PayPal）。要获取资金来源的 ID，请使用 getWallet 查询。
    1. bankAccountId - 若要使用银行账户支付，请在 depositCashBalance 变更中指定银行账户 ID。
    2. bankCardId - 若要使用银行卡支付，请在 depositCashBalance 变更中指定银行卡 ID。
    3. paypalVaultID - 若要使用 PayPal 账户支付，请在 depositCashBalance 变更中指定 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 变更发起存款后，你将获得包含该存款详细信息的响应。 CashBalanceDeposit 对象将包含你所发起存款的重要信息。
📘 请注意 存款可能即时结算，或在 2-5 个工作日内结算。要了解结算时间的计算方式，请阅读这篇文章。