接入准备

1. 准备

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

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

提供信息：

• 商户服务器IP地址

2. 接口流程

• 步骤 1：请求 TRC20 订单，调用接口 /v1/trc20/recharge，获取订单号、TRC20地址及等信息。
• 步骤 2：用户根据订单信息，将 TRC20 TOKEN 转入订单提供的 TRC20 地址。
• 步骤 3：链上转账确认后，系统将向您的服务端发起回调通知。请实现回调接口，用于接收并处理订单状态更新。

3. 接口约定

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

3.1 请求头

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

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

3.2 请求体

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

{
  "param1": "value1", // 参数1
  "param2": "value2" // 参数2
}

3.3 响应体

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

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

3.4 回调签名&验证

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

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

3.4 常见状态码

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