开发指南
对接清单
上线前保留真实环境的请求、响应和本地处理记录，至少验证以下场景。演示值和文档页面成功打开都不属于支付验收证据。
| 场景 | 预期结果 | 不符时先查 |
|---|---|---|
| 正确签名、错误签名、过期时间戳 | 合法请求通过，错误凭据或签名返回 401 | 五段原文字节、环境凭据、系统时间 |
| 首次与重复取址 | 同一玩家、同一条链、同一 USDT 合约，在收款合约未更换时返回相同地址 | 玩家标识、开放链、USDT 合约与地址服务 |
| 充值进度、确认、重复通知与重复查询 | 进度不入账，有效充值只入账一次 | txRef、资产比对与本地账务记录 |
| 其他代币、失效、冲正后的迟到成功通知 | 错误资产不入账；失效只冲正一次；旧通知不直接恢复 | 合约比对、当前单笔结果、版本检查 |
| 提现提交、同单重试、同单改内容 | 同内容不重复创建；改内容不覆盖原订单 | 首次规范化内容与 withdrawOrderId |
| 手机连续两笔提现、受理后清空 | 每笔明确受理并持久保存后生成下一笔，历史各一条处理中；旧单状态更新不覆盖新草稿 | 受理原字段校验、本地事务、订单号和提交锁 |
| 玩家提现分页及空页 | 页码/大小有效，按受理时间与订单号排序，跨页按 ID 合并；本地未知预扣不因空页消失 | 认证接入方、原玩家、登记链和分页边界 |
| 提现超时、404、503、长时间处理中 | 保留原订单及预扣，通过查询核实 | 在途请求、原订单和平台受理记录 |
| 提现终态先后从查询与通知到达 | 只确认扣款或释放预扣一次，旧进度不倒退账务 | 本地终态与预扣记录 |
| 未广播提现取消、重复取消、已处理取消 | 成功为 refunded 且只释放一次；409 正文为 conflict，预扣与原状态保持 | 原订单号、钱包是否仍待处理、终态通知条数 |
| 通知重试、错误回签、服务恢复后补查 | 正确验签回签、重复不改账；已受理订单查询复核，每日上限拒单缺通知须平台核查 | 原始请求、应答头、事务记录与投递情况 |
| 每日上限、同用户换地址、不同用户及不同链 | 同用户同链合并累计，用户与链分别计算；当前普通通道通用 422 不释放，完整拒绝通知仅释放一次 | 玩家身份、当前链配置、首次生效时间、拒绝与投递记录 |
| 超限通知迟到、重复及重启后重投 | 原单仅拒绝/释放一次；按 resetAt 校准倒数，不能从收件时重算旧秒数 | 原始正文、eventId、原单与持久事务 |
| 北京时间跨日、再次保存、清空后重新保存 | 昨日未完成单不占今日；再次保存保留当天计入，清空重存从新时刻起算；旧拒单不重开 | 申请日期、配置生效时间与旧单回执 |
| 手机实时通道断连、切换玩家/网络 | 重连读取当前账本，后台查询继续；迟到响应不能覆盖当前玩家和网络 | 用户授权、当前玩家和网络、请求时序、后台补偿游标 |