WEBHOOK
提币外部验证通知
由服务端主动推送的回调通知,需在你的服务实现接收端点。
获取 WaaS 项目提币申请的通知,需在您的服务实现接收端点。回调 URL 在 Cregis 客户端(PC)WaaS 项目中设置。该接口为 Cregis 向指定业务方发起的回调通知请求,只会产生一次回调。
当您的服务端点收到回调事件时,应返回以下响应之一:
| 响应 | 含义 |
|---|---|
ok | 批准交易请求 |
deny | 拒绝交易请求 |
如果端点未响应,或返回其他内容,则为回调失败。不同类型的业务回调内容不同,强烈建议使用不同接口接收回调,保证业务逻辑清晰明确。回调失败可以进行重新推送,可登录 Cregis 客户端,在 WaaS 项目菜单中选择对应项目,在异常回调记录菜单中重新推送。
请求
回调载荷
application/jsonpidinteger<int64>您创建的 WaaS 项目 ID
cidinteger<int64>由 Cregis 生成的唯一业务编号
third_party_idstring调用方业务编号,由您的业务系统生成
chain_idstring区块链的 ID
token_idstring代币编号
from_addressstring发送方地址
to_addressstring接收方地址
amountstring提币金额
noncestring6 位随机字符串
timestampinteger<int64>当前请求时间戳,单位毫秒
signstring对该接口请求进行的数字签名以防止非法请求,请参考签名规则。
remarkstring转账的描述,不超过 256 个字符
memostringmemo、tag 等上链附加信息,仅 Ton、XRP 网络支持和需要
响应
200您的服务端需返回 HTTP 200 且响应体严格等于纯文本 `ok` 或 `deny`(text/plain)。`ok` 表示批准交易,`deny` 表示拒绝交易;返回其他内容则为回调失败。text/plainstringenum: "ok", "deny"