通知消息
1、設置回調 URL
請求 URL:
http://wallet.unn.com:8080/v2/wallet/config
請求方式:POST
Header
參數 | 類型 | 必選 | 說明 |
---|---|---|---|
token | string | true | Access Token |
請求參數
參數 | 類型 | 必選 | 說明 |
---|---|---|---|
callback | string | true | 回調地址 |
請求示例
curl --location 'http://wallet.unn.com:8080/v2/wallet/config' \
--header 'token: service.eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiMHhBNTZhQThiN0YzRmIwNDEzZEE0MTc1MjdDOWIwQzkzOUM4MDI0NEU5IiwiZW50ZXJwcmlzZV9saXN0IjpbeyJjaGFpbiI6IkVSQzIwIiwiY29udHJhY3RfYWRkciI6IjB4YzI3MTkzNTE1ODAwRjhiMTVBYzE5Qjc5MEJiNTFkODA0M2U2QmI5MiIsImVudGVycHJpc2UiOiI2NGYyOTc0YjhkZDg5NGJjNjExNWUyNjAiLCJpc19vd25lciI6ZmFsc2UsInBlcm1pc3Npb24iOlsxXSwiaWQiOiI2NTAxMTE1MmQyNjhhMTZmMGZhMTEwMjkifSx7ImNoYWluIjoiVFJDMjAiLCJjb250cmFjdF9hZGRyIjoiVENtRkhNdzk4aEE3em1HRVBmVWh4WEZjakJLaEphQ01uaCIsImVudGVycHJpc2UiOiI2NGYyOTc0YjhkZDg5NGJjNjExNWUyNjAiLCJpc19vd25lciI6ZmFsc2UsInBlcm1pc3Npb24iOlsxXSwiaWQiOiI2NTAxMTE1MmQyNjhhMTZmMGZhMTEwMjkifV0sImNyZWF0ZVRpbWUiOjE2OTUyNjMzNjYsImV4cCI6MTY5Nzg1NTM2NiwiYWNjb3VudF9uYW1lIjoiIn0.dkGAMfHMR6YQZjSMsxxLb-aCwn55FjyF7RIn_ebo7Yg' \
--header 'Content-Type: application/json' \
--data '{
"body": {
"callback": "http://43.198.64.79:30104/unn_pay/notify"
}
}'
返回參數
參數名 | 類型 | 說明 |
---|---|---|
id | string | ID |
返回示例
{
"code": 200,
"message": "success",
"data": {
"entity": {
"id": "64901a10a859a3412833ba1a"
}
}
}
2、通知消息格式
2.1、Test消息
设置回调URL时会发送该消息测试URL是否可用
消息格式
參數 | 類型 | 必選 | 說明 |
---|---|---|---|
type | int | true | 消息類型:0-Test 消息, 1-充幣通知,2-提幣通知 |
content_type | string | true | json |
content | dict | true | 消息內容 |
--heartbeat | int | true | 心跳時間戳 |
消息示例
{
"type": 0,
"content_type": "json",
"content": {
"heartbeat": 1695697870
}
}
2.2、用戶充幣通知
消息格式
參數 | 類型 | 必選 | 說明 |
---|---|---|---|
type | int | true | 消息類型:0-Test 消息, 1-充幣通知,2-提幣通知 |
content_type | string | true | json |
content | dict | true | 消息內容 |
--merchant_id | string | true | 商戶ID |
--uid | string | true | 用戶ID |
--txn_id | string | true | 交易ID |
--chain | string | true | 區塊鏈 ERC20/TRC20 |
--from_addr | string | true | 付款地址 |
--to_addr | string | true | 收款地址 |
--value | string | true | 轉帳本幣金額 |
--token_addr | string | true | 轉帳代筆地址 |
--token_value | string | true | 轉帳代筆金額 |
--status | string | true | 状态,1-pending,2-成功,3-失敗 |
--exchange | dict | true | 汇率数据 |
消息示例
{
"type": 0,
"content_type": "json",
"content": {
"merchant_id": "6510f473dd0e3494c90c72fa",
"uid": "2b063E",
"txn_id": "0x7aff9094356518b3eadadab4cce701f8040d79ba2c79d0c2451982fa3d61e94c",
"chain": "ERC20",
"from_addr": "0x52C540Ed7A198e48B57F60a791aaE83a5A2b063E",
"to_addr": "0x0F42Db9fB309E6E3a1E2E47B69ED4dd5d7aE4b14",
"value": "0",
"token_addr": "0x85E3fC24B618cE2aEad700d51710756dFC88F765",
"token_value": "100000000",
"status": 2,
"exchange": {}
}
}
2.3、用戶提幣通知
消息格式
參數 | 類型 | 必選 | 說明 |
---|---|---|---|
type | int | true | 消息類型:0-Test 消息, 1-充幣通知,2-提幣通知 |
content_type | string | true | json |
content | dict | true | 消息內容 |
--id | string | true | 订单ID |
--txn_id | string | true | 交易ID |
--chain | string | true | 區塊鏈 ERC20/TRC20 |
--uid | string | true | 用户ID |
--to_addr | string | true | 收款地址 |
--value | string | true | 轉帳本幣金額 |
--token_addr | string | true | 轉帳代筆地址 |
--token_value | string | true | 轉帳代筆金額 |
--status | string | true | 状态,3-审核员拒绝,4-失败,5-成功 |
--detail | dict | true | 订单详情 |
消息示例
{
"type": 0,
"content_type": "json",
"content": {
"id": "6478417858624eeddde32df3",
"txn_id": "0x7aff9094356518b3eadadab4cce701f8040d79ba2c79d0c2451982fa3d61e94c",
"status": 5,
"chain": "ERC20",
"uid": "2b063E",
"to_addr": "0x0F42Db9fB309E6E3a1E2E47B69ED4dd5d7aE4b14",
"value": "0",
"token_addr": "0x85E3fC24B618cE2aEad700d51710756dFC88F765",
"token_value": "100000000",
"detail": {}
}
}