Cregis Developer Docs
WEBHOOK

钱包提币通知

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

回调 URL 由对应业务发起方传入,具体了解 提币 接口中的 callback_url 参数。该接口为 Cregis 向业务方发起回调通知请求,该回调分四种情况,根据回调内容中的 status 判断,且四种情况是互斥的,只会产生一次回调:

状态(status)描述
2签名驳回
4审批驳回
6交易成功
7交易失败

发起回调后当接收到返回内容为 success 字符串时为回调成功,否则为回调失败,回调失败可以进行重新推送,可登录 Cregis 客户端,在项目菜单中选择对应项目,在回调记录菜单中重新推送。

不同类型的业务,回调内容不同,强烈建议使用不同的接口接收回调,保证业务逻辑的清晰明确。

请求

回调载荷

application/json
  • pidinteger<int64>

    项目编号

  • cidinteger<int64>

    系统流水号

  • chain_idstring

    链编号

  • token_idstring

    代币编号

  • currencystring

    币种标识

  • addressstring

    地址

  • amountstring

    金额

  • third_party_idstring

    调用方业务编号D

  • statusinteger<int32>
    enum: 2, 4, 6, 7

    状态

  • noncestring

    6位随机字符串

  • timestampinteger<int64>

    时间戳

  • signstring

    签名

  • remarkstring

    备注

  • txidstring

    交易hash

  • block_heightstring

    区块高度

  • block_timeinteger<int64>

    区块时间

  • memostring

    memo、tag等上链信息,仅Ton、Xrp支持

响应

200您的服务端需返回 HTTP 200 且响应体严格等于纯文本 `success`(text/plain)
text/plain
string