“消费账户”和“现金余额账户”是同一概念。在 API 中,消费账户由
UserCashBalance 类型表示,相关操作以 ...UserCashBalance 命名(例如 createUserCashBalance)。本页面统一使用“消费账户”这一术语。余额
每个消费账户会追踪三种余额,全部以字符串形式返回:
用户可以持有多个消费账户,其中一个会被标记为默认(
isDefault: true)。
你可以做什么
账户生命周期
消费账户会经历一小组状态(UserCashBalanceStatus):通常为 ACTIVE,关闭后为 CLOSED。
关闭账户不只是修改状态。当你关闭一个仍有可用余额的消费账户时,该余额必须被转移到另一个消费账户。如果有任何虚拟卡由被关闭的账户提供资金,你必须在同一请求中将它们重新分配到新的资金来源,或将其锁定。
关闭账户需要先解决其余额与依赖的虚拟卡。如果账户仍有可用余额,请提供
transferUserCashBalanceId 以转移余额。若有虚拟卡绑定到该账户,请提供 newFundingSource 以重新分配,或提供 lockAllVirtualCards 以将其锁定。完整输入参考见关闭消费账户。消费账户如何融入体系
消费账户位于用户钱包的中心:- 使用从外部账户存入资金为其注资,或使用在消费账户间内部转账在账户间划转资金。
- 通过礼品卡和虚拟卡从中支出。
- 任何时候都可使用查询账户余额或上述消费账户查询来检查余额。
要求
列出消费账户需要LIST_PAYMENT scope。创建、编辑和关闭消费账户需要 MANAGE_PAYMENT scope。调用这些操作前,请确保你的用户访问令牌携带正确的 scope。
想了解更多? 联系我们的专家以获取更多信息或申请演示。