稳定币账户 › 指南
会员的数字资产:余额、充值、链上提现、流水,以及站内兑换。
稳定币账户概述
会员入金仅供平台自营主体(platform_hosted)使用。 非自营商户(merchant_hosted)禁止给 member 入金,只认实际充值的商户预付余额;POST /v1/deposits 返回 403 insufficient_scope,旧审批权限同样不能绕过。下单须传 funding_source: merchant。历史记录仍可查询。
本组会员钱包功能用于平台自营账户。非自营商户应查询商户预付余额,不得将历史会员余额作为新订单的付款来源。
四件事
| 端点 | 一句话 | |
|---|---|---|
| 余额 | GET /v1/balances | 会员各资产、各桶的余额 |
| 充值 | POST /v1/deposits | 仅自营主体可上报会员入金 |
| 提现 | POST /v1/withdrawals | 链上转出,两段式 |
| 流水 | GET /v1/transactions | 全部账本变动 |
外加一条不出账本的:站内兑换。
POST /v1/deposits 是全系统唯一凭空产生余额的端点
它有六道闸,一道都不能省:
- 签名不可关闭
- 幂等带你的流水号
- 单笔与日累计上限
- 资产白名单,认不出一律拒不挂账
- 照常过风控准入
- 全量审计
⚠ 第 4 条尤其:传一个我方不认得的资产代码不会创建一个新资产,
会被拒。别指望靠上报来「开通」一个币种。
余额分桶
会员的余额不是一个数,是几个桶(可用、冻结、理财、卡内…)。能花的只有可用。界面上显示「余额」时请说清是哪一个 ——把总额显示成可用,用户会以为自己能花冻结中的钱。