Cregis Developer Docs
WEBHOOK

提币外部验证通知

由服务端主动推送的回调通知，需在你的服务实现接收端点。

获取 WaaS 项目提币申请的通知，需在您的服务实现接收端点。回调 URL 在 Cregis 客户端（PC）WaaS 项目中设置。该接口为 Cregis 向指定业务方发起的回调通知请求，只会产生一次回调。

当您的服务端点收到回调事件时，应返回以下响应之一：

响应含义
ok批准交易请求
deny拒绝交易请求

如果端点未响应，或返回其他内容，则为回调失败。不同类型的业务回调内容不同，强烈建议使用不同接口接收回调，保证业务逻辑清晰明确。回调失败可以进行重新推送，可登录 Cregis 客户端，在 WaaS 项目菜单中选择对应项目，在异常回调记录菜单中重新推送。

请求

回调载荷

application/json
  • pidinteger<int64>

    您创建的 WaaS 项目 ID

  • cidinteger<int64>

    由 Cregis 生成的唯一业务编号

  • third_party_idstring

    调用方业务编号，由您的业务系统生成

  • chain_idstring

    区块链的 ID

  • token_idstring

    代币编号

  • from_addressstring

    发送方地址

  • to_addressstring

    接收方地址

  • amountstring

    提币金额

  • noncestring

    6 位随机字符串

  • timestampinteger<int64>

    当前请求时间戳，单位毫秒

  • signstring

    对该接口请求进行的数字签名以防止非法请求，请参考签名规则。

  • remarkstring

    转账的描述，不超过 256 个字符

  • memostring

    memo、tag 等上链附加信息，仅 Ton、XRP 网络支持和需要

响应

200您的服务端需返回 HTTP 200 且响应体严格等于纯文本 `ok` 或 `deny`（text/plain）。`ok` 表示批准交易，`deny` 表示拒绝交易；返回其他内容则为回调失败。
text/plain
string
enum: "ok", "deny"