跳转到主要内容
本快速入门演示完整的钱包资金流转：开设一个专用的消费账户、为其注资、在账户之间移动资金、将资金提回到外部账户，并在每一步核对总账——这是每张卡和每笔交易流程背后的底层管道。
先决条件
  • 一个带有暂存应用的 Fluz 账户——任何快速入门的第 1–2 步，或参见准备你的账户和 API 凭证。
  • 一个已关联的测试银行账户用于存款与提款环节——你的沙盒自带测试资金来源，或从测试银行账户添加更多。
  • 每个动账变更都需要唯一的 idempotencyKey——参见幂等性。

​
完整流程

铸造包含四个钱包 scope 的令牌

此流程涉及四个 scope——每个能力一个：
MANAGE_PAYMENT 用于创建账户和存款，LIST_PAYMENT 用于读取，MAKE_INTERNAL_TRANSFER 在你的账户间移动资金，MAKE_WITHDRAWAL 将资金转出。铸造详情：API 凭证。

创建一个消费账户

消费账户是具名的子总账——“Team Travel（团队差旅）”“Operations（运营）”“Marketing（市场）”——在同一 Fluz 账户下分隔预算。
保存 userCashBalanceId——后续每一步都会用它来指向该账户。你的账户还自带一个默认消费账户；你将在第 4 步在两者之间转账。

为其存款

使用 depositCashBalance 从已关联的资金来源为新账户注资，并通过 userCashBalanceId 指定目标：
依据资金来源不同，存款可能即时结算，或在 2–5 个工作日内结算；返回的 balances 反映当前可用金额。资金来源 ID 可从 getWallet 获取——参见查看资金来源。

在你的账户之间转账

使用 transferInternalBalance 将 $25 从新账户转入默认账户。系统会内部记录为两个关联的动账——从来源账户提款、向目标账户存款——响应会同时返回两者：
两个 ID 必须都是你自己的消费账户，且不能相同，并且来源账户需要有足够的可用余额。向其他 Fluz 用户转账是不同的操作——转到另一个 Fluz 钱包。

提回到外部账户

使用 withdrawCashBalance 将资金提至外部账户完成闭环——此处示例为 ACH：
method 也接受 BANK_CARD（推卡到卡，bankCardId）、PAYPAL（paypalVaultId），以及 VENMO（venmoAccountId）——每种方式都需要提供对应的 ID 字段。ACH 通常在 1–3 个工作日内结算，因此初始状态预期为 PENDING / PROCESSING。完整参考：提至外部账户。

核验总账

使用 getUserCashBalances 读取账户，闭合整个流程：
你应能从数值中看到这段“故事”：“Team Travel” 的 lifetimeCashBalance 为 100.00，而可用余额减少（转出 25、提取 50），你的默认账户增加 25.00。lifetimeCashBalance 只增不减——它是所有存入行为的审计轨迹。

​
大功告成 🎉

你已经跑完了完整的总账生命周期——创建、注资、转移、转出、核验。这些账户是其他一切的基础：

从该账户为虚拟卡注资

将 userCashBalanceId 指向你的新账户，以实现按预算清晰分账的卡片支出。

向另一个 Fluz 用户汇款

查询收款人并进行钱包到钱包的转账。

管理消费账户

随时间重命名、关闭并管理账户。

交易活动

上述每一次动账，尽在一个可筛选的动态流中，并带有备注与分类。
想了解更多？ 通过 support@fluz.app 联系我们，与专家交流或预约演示。