稳定币账户 › 指南
会员的数字资产:余额、充值、链上提现、流水,以及站内兑换与转账。
稳定币账户概述
会员在你这里持有数字资产。我方只记账,不托管 —— 资产由你托管,我方的账本回答「谁有多少」。
四件事
| 端点 | 一句话 | |
|---|---|---|
| 余额 | GET /v1/balances | 会员各资产、各桶的余额 |
| 充值 | POST /v1/deposits | 你上报一笔入金,会员余额增加 |
| 提现 | POST /v1/withdrawals | 链上转出,两段式 |
| 流水 | GET /v1/transactions | 全部账本变动 |
POST /v1/deposits 是全系统唯一凭空产生余额的端点
它有六道闸,一道都不能省:
1. 签名不可关闭2. 幂等带你的流水号3. 单笔与日累计上限4. 资产白名单,认不出一律拒不挂账 5. 照常过风控准入6. 全量审计
⚠ 第 4 条尤其:传一个我方不认得的资产代码不会创建一个新资产,
会被拒。别指望靠上报来「开通」一个币种。
余额分桶
会员的余额不是一个数,是几个桶(可用、冻结、理财、卡内…)。能花的只有可用。界面上显示「余额」时请说清是哪一个 ——把总额显示成可用,用户会以为自己能花冻结中的钱。