Z Zise Developers
稳定币账户 › 指南

会员的数字资产:余额、充值、链上提现、流水,以及站内兑换与转账。

稳定币账户概述

会员在你这里持有数字资产。我方只记账,不托管 —— 资产由你托管,我方的账本回答「谁有多少」。

四件事

端点一句话
余额GET /v1/balances会员各资产、各桶的余额
充值POST /v1/deposits你上报一笔入金,会员余额增加
提现POST /v1/withdrawals链上转出,两段式
流水GET /v1/transactions全部账本变动

外加两条不出账本的:站内兑换站内转账

POST /v1/deposits 是全系统唯一凭空产生余额的端点

它有六道闸,一道都不能省:

1. 签名不可关闭2. 幂等带你的流水号3. 单笔与日累计上限4. 资产白名单,认不出一律拒不挂账 5. 照常过风控准入6. 全量审计

⚠ 第 4 条尤其:传一个我方不认得的资产代码不会创建一个新资产,

会被拒。别指望靠上报来「开通」一个币种。

余额分桶

会员的余额不是一个数,是几个桶(可用、冻结、理财、卡内…)。能花的只有可用。界面上显示「余额」时请说清是哪一个 ——把总额显示成可用,用户会以为自己能花冻结中的钱。