回调 API

回调URL由对应业务发起方传入,具体了解提币接口中的callback_url参数

该接口为Cregis向业务发发起回调通知请求,该回调分四种情况,根据回调内容中的status判断,且四种情况是互斥的,只会产生一次回调:

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

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

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

请求方式

HTTP POST application/json

请求参数

名称类型描述
pidinteger(int64)项目编号
cidinteger(int64)系统流水号
chain_idstring链编号
token_idstring代币编号
currencystring币种标识
addressstring地址
amountstring金额
third_party_idstring调用方业务编号D
remarkstring备注
statusinteger(int32)状态
txidstring交易hash
block_heightstring区块高度
block_timeinteger(int64)区块时间
noncestring6位随机字符串
timestampinteger(int64)时间戳
signstring签名
示例
{
  "pid": 1382528827416576,
  "cid": 1391751691788288,
  "address": "TXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FS",
  "chain_id": "195",
  "token_id": "195",
  "currency": "TRX",
  "amount": "1.1",
  "third_party_id": "1e0fb3a0a9454ad8928d26b592e8b3c7",
  "remark": "payout",
  "status": 0,
  "txid": "6dd05b0972075542219a3fcc116c58feaf9480f1f698cc46c4367ded83955cfd",
  "block_height": "34527604",
  "block_time": 1686814482000,
  "nonce": "ubqso3",
  "timestamp": 1687850657960,
  "sign": "f5be13fdd8c6f63951ca4427359457cb"
}