接入准备

1. 准备

在开始接入前，请联系技术人员获取以下必要信息：

• 商户ID (Merchant ID)： 您的唯一商户身份标识。
• 商户密钥 (API Key)： 用于接口鉴权和签名，请务必妥善保管，严禁泄露。
• 接口地址 (Base URL)： {BASE_URI} (请替换为实际地址)

提供信息：

• 商户服务器IP地址

2. 接口流程

• 步骤 1： 获取可使用的 TOKEN 列表，列表包含 TOKEN 对应的ID及其基本信息。
• 步骤 2： 根据业务需求，发送发送对应的token_id和 using_user(商户用户uuid或商户订单号)，创建收款订单。
• 步骤 3： 用户根据订单信息，将 TRC20 Token 或 TRX 转入订单提供的 TRON 地址。链上转账确认后，系统将向您的服务端发起回调通知。(请实现回调接口，用于接收TRON链上交易回调通知。)

3. 接口约定

• 传输方式： HTTPS
• 请求方式： POST
• 字符编码： UTF-8
• 数据格式： application/json

3.1 请求头

• 请求头中需包含 uu-api-key 字段，值为您的商户密钥，用于接口鉴权。

{
  "uu-api-key": "{您的商户密钥}"
}

3.2 请求体

• 请求体需为 JSON 格式，包含接口所需的参数。

3.3 响应体

• 所有接口返回数据均为 JSON 格式，结构如下：

{
  "code": 1000,       // 状态码，1000 表示成功，其他表示失败
  "message": "success", // 提示信息
  "data": { ... }     // 业务数据
}

3.4 回调签名&验证

• 请求头中包含 uu-api-merchant-id 字段，值为您的商户ID，用于接口鉴权。

{
  "uu-api-merchant-id": "{您的商户ID}"
}

3.5 常见状态码

• 1000: 请求成功
• 1001: 参数错误
• 1002: 签名错误 / 鉴权失败