跳转到主要内容
消费账户是 Fluz 内部的现金余额账户,用户用它来持有、整理和追踪资金。每个账户都有自己的昵称,因此用户可以按用途分开支出——例如“团队差旅”、“运营钱包”或“市场预算”——且每个账户都维护各自的流水余额。 消费账户是其他一切的资金来源:它们持有用于购买礼品卡、为虚拟卡交易提供资金的款项,并接收存款和转账。
“消费账户”和“现金余额账户”是同一概念。在 API 中,消费账户由 UserCashBalance 类型表示,相关操作以 ...UserCashBalance 命名(例如 createUserCashBalance)。本页面统一使用“消费账户”这一术语。

余额

每个消费账户会追踪三种余额,全部以字符串形式返回: 用户可以持有多个消费账户,其中一个会被标记为默认isDefault: true)。

你可以做什么


账户生命周期

消费账户会经历一小组状态(UserCashBalanceStatus):通常为 ACTIVE,关闭后为 CLOSED 关闭账户不只是修改状态。当你关闭一个仍有可用余额的消费账户时,该余额必须被转移到另一个消费账户。如果有任何虚拟卡由被关闭的账户提供资金,你必须在同一请求中将它们重新分配到新的资金来源,或将其锁定。
关闭账户需要先解决其余额与依赖的虚拟卡。如果账户仍有可用余额,请提供 transferUserCashBalanceId 以转移余额。若有虚拟卡绑定到该账户,请提供 newFundingSource 以重新分配,或提供 lockAllVirtualCards 以将其锁定。完整输入参考见关闭消费账户

消费账户如何融入体系

消费账户位于用户钱包的中心:

要求

列出消费账户需要 LIST_PAYMENT scope。创建、编辑和关闭消费账户需要 MANAGE_PAYMENT scope。调用这些操作前,请确保你的用户访问令牌携带正确的 scope。
想了解更多? 联系我们的专家以获取更多信息或申请演示。