你上报，我方记账。幂等键必须带你自己的流水号。

充值上报

POST /v1/deposits
x-idempotency-key: <你的入金流水号>
{ "external_member_id": "u_88123", "asset": "USDT", "amount": "100.00", "reference": "…" }

幂等键用你的流水号

不是随机 UUID。 用你系统里那笔入金的唯一标识 ——这样网络重试与你自己的补偿任务都会命中同一条记录。

用随机键的表现是：一次超时重试变成了第二笔入账，而会员的余额凭空多了一份。

金额是字符串定点

"amount": "100.00"      ✓
"amount": 100.00        ✗  JSON number

位数按该资产的 ledger_scale（用GET /v1/assets 查）。链上资产 18 位小数超过 2^53，用 number 解析即精度事故。

上报之后

• 会员余额立刻增加（这条线没有异步）
• 发 deposit.credited 事件
• 你的托管余额相应增加 —— 记得跟

托管核对对上

相关端点

• POST /v1/deposits
• GET /v1/deposits