接入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": "8YFWpoSe"
}
2.2 示例
Notify Request Body
{
"token_id": 1,
"transaction_id": "9cdbcaee6126744789198c460...",
"using_user": "user_123",
"no": "AU_251129211439...",
"timestamp": 1698380000,
"amount": 100,
"from": "TQCgLnDCtb3...",
"to": "TQCgLnDCtb3...",
"u_price": 1
}
2.3 参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| token_id | number | 币种ID |
| transaction_id | string | 链上交易id UUAPI侧唯一标识 |
| using_user | string | 商户侧用户 商户侧唯一标识 |
| no | string | 订单号-对应2.1中获取的订单号(uuapi侧订单号) |
| timestamp | number | 交易时间(时间戳) |
| amount | number | 金额 |
| from | string | 发送方地址 |
| to | string | 接收方地址 |
| u_price | number | 实时USD汇率 |
2.4 商户返回
- 商户需要返回
success，否则 UUAPI 会认为回调失败。 - 回调最多3次，每次间隔30秒。