接入UUAPI
回调通知
当检查到链上有TRC20交易记录时，UUAPI会向你配置的回调地址发出回调通知。
1. 回调地址配置
UUAPI管理后台 => 配置管理 => 技术接口配置 => 通知回调地址
2. 回调通知
2.1 回调方式
- 传输协议：
HTTPS - 请求方式：
POST - 数据格式：
application/json - 字符编码：
UTF-8
回调加密 headers 中包含
uu-api-merchant-id字段，用于验证回调是否来自 UUAPI。
Notify Request Headers
{
"uu-api-merchant-id": "1234567890abcdef1234567890abcdef"
}
2.2 示例
Notify Request Body
{
"token_id": 1,
"transaction_id": "9cdbcaee6126744789198c460...",
"using_user": "user_123",
"using_no": "AU_251129211439...",
"timestamp": 1698380000,
"amount": 100,
"address": "TQCgLnDCtb3...",
"u_price": 1,
}
2.3 参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| token_id | number | 币种ID |
| transaction_id | string | 链上交易hash UUAPI侧唯一标识 |
| using_user | string | 商户侧用户 商户侧唯一标识 |
| using_no | string | 订单号-对应2.1中获取的订单号 |
| timestamp | number | 交易时间(时间戳) |
| amount | number | 金额 |
| address | string | 地址 |
| u_price | number | 实时USD汇率 |
2.4 商户返回
- 商户需要返回
Success，否则 UUAPI 会认为回调失败。 - 回调最多3次，每次间隔30秒。