存币通知回调
{
"requestUUID": "fbd70fb4-c302-4228-bd61-6326e0539551",
"chainName": "TRON",
"symbol": "TRX",
"amount": "2.500000000000",
"business": 0,
"toAddress": "TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP",
"fromAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
"riskLevelTo": 3,
"riskLevelFrom": 3,
"txId": "b00a4aa3d6426f6409a83ae72a79de5b559a2c339ebc89b8b75427c2600978e3",
"tenantUserId": "2049",
"type": 1,
"txIndex": -1,
"newAddress": "TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP",
"trackingId": "6484"
}
{
"apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
"data": "{\"type\":1,\"callBackId\":null,\"trackingId\":\"6484\",\"state\":null,\"txId\":\"b00a4aa3d6426f6409a83ae72a79de5b559a2c339ebc89b8b75427c2600978e3\",\"txIndex\":-1,\"chainName\":\"TRON\",\"symbol\":\"TRX\",\"amount\":\"2.500000000000\",\"fromAddress\":\"TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK\",\"toAddress\":\"TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP\",\"tenantType\":null,\"requestUUID\":\"fbd70fb4-c302-4228-bd61-6326e0539551\",\"tenantUserId\":\"2049\"}",
"errCode": 0,
"message": ""
}
NOTIFY_DEPOSITED
(type=1)
当用户向其在WaaS中的存币地址存入数字货币时,WaaS会通过此回调通知您存币操作的详细信息,商户需要在响应中告诉 WaaS 是否接受了此回调。
请求参数
WaaS发送的请求是经过RSA加密的Base64字符串,商户需要使用公钥解密后才能获取以下业务参数:
区块链交易Hash
链名称,比如TRON、ETH、BSC…
代币符号,比如USDT、USDC、PHT…
存币金额
存币来源地址(用户的外部地址)
存币目标地址(用户在WaaS中的存币地址)
来源地址风险评分(0-100)
目标地址风险评分(0-100)
交易索引
新地址,type为4时代替toAddress
响应参数
商户处理完回调后,需返回 JSON 格式的响应体。其中 data
字段需返回 RSA加密的Base64字符串(使用 WaaS 提供的公钥加密),其余字段为明文:
商户的唯一 API 标识符
加密的业务数据,比如:i2H9eQf22gLnJoTeo1WbWVR6wmNv(具体可参考右侧示例)
由以下原始业务参数加密生成:
type (Integer) : 回调类型
trackingId (String) : 业务事件标识符
txId (String) : 区块链交易Hash
txIndex (Integer) : 交易在区块中的序号
chainName (String) : 区块链名称
symbol (String) : 代币符号
amount (Integer) : 存款金额
fromAddress (String) : 存款来源地址
toAddress (String) : 存款目标地址
requestUUID (String) : 请求的唯一标识符号,商户在响应中需要同样返回相同的requestUUID以帮助 WaaS 确认
tenantUserId (String) : 发起存款的用户ID(在商户系统中,并非WaaS系统中)
全局处理状态码:
0
=成功,非0
=失败
错误详情(失败时必填):
- 成功时可返回空字符串
- 失败时需描述具体错误
{
"requestUUID": "fbd70fb4-c302-4228-bd61-6326e0539551",
"chainName": "TRON",
"symbol": "TRX",
"amount": "2.500000000000",
"business": 0,
"toAddress": "TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP",
"fromAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
"riskLevelTo": 3,
"riskLevelFrom": 3,
"txId": "b00a4aa3d6426f6409a83ae72a79de5b559a2c339ebc89b8b75427c2600978e3",
"tenantUserId": "2049",
"type": 1,
"txIndex": -1,
"newAddress": "TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP",
"trackingId": "6484"
}
{
"apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
"data": "{\"type\":1,\"callBackId\":null,\"trackingId\":\"6484\",\"state\":null,\"txId\":\"b00a4aa3d6426f6409a83ae72a79de5b559a2c339ebc89b8b75427c2600978e3\",\"txIndex\":-1,\"chainName\":\"TRON\",\"symbol\":\"TRX\",\"amount\":\"2.500000000000\",\"fromAddress\":\"TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK\",\"toAddress\":\"TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP\",\"tenantType\":null,\"requestUUID\":\"fbd70fb4-c302-4228-bd61-6326e0539551\",\"tenantUserId\":\"2049\"}",
"errCode": 0,
"message": ""
}
{
"requestUUID": "fbd70fb4-c302-4228-bd61-6326e0539551",
"chainName": "TRON",
"symbol": "TRX",
"amount": "2.500000000000",
"business": 0,
"toAddress": "TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP",
"fromAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK",
"riskLevelTo": 3,
"riskLevelFrom": 3,
"txId": "b00a4aa3d6426f6409a83ae72a79de5b559a2c339ebc89b8b75427c2600978e3",
"tenantUserId": "2049",
"type": 1,
"txIndex": -1,
"newAddress": "TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP",
"trackingId": "6484"
}
{
"apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
"data": "{\"type\":1,\"callBackId\":null,\"trackingId\":\"6484\",\"state\":null,\"txId\":\"b00a4aa3d6426f6409a83ae72a79de5b559a2c339ebc89b8b75427c2600978e3\",\"txIndex\":-1,\"chainName\":\"TRON\",\"symbol\":\"TRX\",\"amount\":\"2.500000000000\",\"fromAddress\":\"TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchnK\",\"toAddress\":\"TYLdkix4wqk1wLXbqbxrrY1oi1mHEM6uwP\",\"tenantType\":null,\"requestUUID\":\"fbd70fb4-c302-4228-bd61-6326e0539551\",\"tenantUserId\":\"2049\"}",
"errCode": 0,
"message": ""
}