接入概览
通过开放接口为你的用户创建收款钱包，查询已确认到账，并通过API配置统一归集目标、自动策略和回调，再将USDT归集到已配置地址。本文档提供完整的接口参数、响应结构和可运行示例。
首次接入，从 快速开始 阅读；已经完成鉴权，可直接查阅 API 接口目录。
接入流程
| 步骤 | 你需要完成的工作 | 文档 |
|---|---|---|
| 1 | 在平台开通租户，取得appID和密钥，由你的服务端完成后续业务配置 | 凭据与 accessToken |
| 2 | 在你的服务端计算签名，获取并缓存 accessToken | 请求签名 · 获取 Token |
| 3 | 为业务用户创建收款钱包，保存平台钱包 ID、地址和自定义 ID 的关联 | 创建收款钱包 |
| 4 | 通过API设置USDT归集目标、自动策略及回调地址 | 完整业务配置流程 |
| 5 | 接收加密到账通知，验证、解密、持久化去重后更新你的业务记录 | 回调通知 |
| 6 | 按需查询到账流水，预估费用、发起归集并跟踪最终结果 | 到账流水 · 创建归集 |
接入信息
| 项目 | 值 |
|---|---|
| API 域名 | 由平台单独提供；本页只列路径 |
| 接口版本 | /open/v1 |
| 区块链 | TRON；资产网络以响应 network 为准 |
| 请求与响应 | UTF-8 JSON；获取 Token 的请求体为空 |
| 接入端 | 三方服务端；appSecret 不应放入浏览器或移动客户端 |
| 金额精度 | USDT / TRX 均以六位精度最小单位的整数字符串传递 |
| 开放接口 | 24 个 /open/v1 操作，另有 2 个公共资源，详见 API 目录 |
示例里的 appID、密钥、Token、钱包 ID 与地址均为演示值。运行时使用你的租户凭据、真实业务参数和当前秒级时间戳。API 域名由平台单独提供，本文档只列接口路径。请求地址由该域名与接口路径组合；不要使用文档站域名代替 API 域名。
先理解三个业务对象
钱包是平台生成并管理的收款地址。custom_id 是你给钱包设置的业务标识，同一租户内唯一；id 是平台返回的钱包 ID，后续查详情或归集时使用。
到账流水来自已确认的链上转入事件。平台不创建或匹配支付订单；你需要在自己的系统中把钱包或到账事件关联到业务订单。余额和流水可能有同步延迟，请结合余额同步高度及到账状态核对。
归集任务是异步操作。创建接口返回任务信息后，后台才会准备、签名、广播并确认交易；HTTP 请求成功不代表链上归集成功。通过 归集详情 或回调获取最终结果。
接入时最容易出错的约定
- 金额不能传小数或浮点数。 100 USDT 应传
"100000000"，不是100或"100.00"。查看金额规则 - 签名和发送必须使用同一份请求体字节。 空格、换行和 JSON 属性顺序都会参与当前签名。查看签名步骤
- Token 应集中缓存。 每次成功获取 Token 都会使该租户之前的 Token 失效，不要每个业务请求都重新获取。查看 Token 生命周期
- 重试写请求时保留
request_id。 相同业务换新编号会被视为新的请求。查看幂等规则 - 回调处理完成后再确认成功。 先验证 AES-GCM 认证标签、解密并持久化去重，再返回 HTTP 200 和
{"code":"SUCCESS"}。查看回调处理