接入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
{
"payment_no": "WD_20250318001",
"amount": 100,
"token_id": 1,
"from": "TQCgLnDCtb3...",
"to": "TRFxk2sJP8e...",
"transaction_id": "9cdbcaee6126744789198c460...",
"timestamp": 1698380000
}
2.3 参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| payment_no | string | 商户侧提现订单号 商户侧唯一标识 |
| amount | number | 提现金额 |
| token_id | number | 币种ID |
| from | string | 发送方地址 (UUAPI提现账户地址) |
| to | string | 接收方地址 (商户提交的提现目标地址) |
| transaction_id | string | 链上交易ID (交易hash) UUAPI侧唯一标识 |
| timestamp | number | 链上交易确认时间 (时间戳) |
2.4 商户返回
- 商户需要返回
success，否则 UUAPI 会认为回调失败。 - 回调最多3次，每次间隔30秒。