Webhook API
提币失败通知回调
Copy
{
"business": 0,
"requestUUID": "47b8d46c-12c9-4d64-98a0-ad1fbb6d0c29",
"tenantUserId": "ryan_test_3",
"callBackId": "D846735969",
"type": 5,
"toAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchn2",
"trackingId": "102007"
}
Copy
{
"apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
"data": "{\"tenantUserId\":\"ryan_test_3\",\"callBackId\":\"D846735969\",\"trackingId\":\"102007\",\"requestUUID\":\"47b8d46c-12c9-4d64-98a0-ad1fbb6d0c29\",\"type\":5}"
"errCode": 0,
"message": ""
}
NOTIFY_INVALID_ADDRESS
(type=5)
当提币操作因地址无效或其他原因失败时,WaaS会通过此回调通知商户:该提币操作已完全终止,可以安全解冻用户资金
核心说明
- 操作终结:此提币操作不会重试或完成
- 资金安全:商户可以解除用户的资金冻结
- 失败原因:
- 地址无效(格式错误或黑名单地址)
- 目标链不支持该资产
- 其他无法完成提币的技术限制
请求参数
请求是经过RSA加密的Base64字符串,商户需解密获取业务参数:
响应参数
商户处理完回调后,需返回 JSON 格式的响应体。其中 data
字段需返回 RSA加密的Base64字符串(使用 WaaS 提供的公钥加密),其余字段为明文:
商户API密钥
加密的业务数据,比如:BDn6Liv5Z4TJ9vjfd(具体参考右侧响应示例) 由以下原始业务参数加密生成:
tenantUserId (String) : 发起存款的用户ID(在商户系统中,并非WaaS系统中)
callBackId :商户需同样返回 callBackId 帮助 WaaS 二次确认
trackingId (String) : 业务事件标识符
type (String) : 回调类型
requestUUID (String) : 请求的唯一标识符号,商户在响应中需要同样返回相同的requestUUID以帮助 WaaS 确认
全局处理状态码:
0
=成功,非0
=失败
错误详情(失败时必填):
- 成功时可返回空字符串
- 失败时需描述具体错误
Copy
{
"business": 0,
"requestUUID": "47b8d46c-12c9-4d64-98a0-ad1fbb6d0c29",
"tenantUserId": "ryan_test_3",
"callBackId": "D846735969",
"type": 5,
"toAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchn2",
"trackingId": "102007"
}
Copy
{
"apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
"data": "{\"tenantUserId\":\"ryan_test_3\",\"callBackId\":\"D846735969\",\"trackingId\":\"102007\",\"requestUUID\":\"47b8d46c-12c9-4d64-98a0-ad1fbb6d0c29\",\"type\":5}"
"errCode": 0,
"message": ""
}
Copy
{
"business": 0,
"requestUUID": "47b8d46c-12c9-4d64-98a0-ad1fbb6d0c29",
"tenantUserId": "ryan_test_3",
"callBackId": "D846735969",
"type": 5,
"toAddress": "TGDHyoMpgDQj4DmoZdwJP2FSkSG4DEchn2",
"trackingId": "102007"
}
Copy
{
"apiKey": "88c47568-8d24-4983-9b4c-y1ec8b939e9b",
"data": "{\"tenantUserId\":\"ryan_test_3\",\"callBackId\":\"D846735969\",\"trackingId\":\"102007\",\"requestUUID\":\"47b8d46c-12c9-4d64-98a0-ad1fbb6d0c29\",\"type\":5}"
"errCode": 0,
"message": ""
}
助手
Responses are generated using AI and may contain mistakes.