回调 API
回调URL由对应业务发起方传入,具体了解提币接口中的callback_url参数
该接口为Cregis向业务发发起回调通知请求,该回调分四种情况,根据回调内容中的status判断,且四种情况是互斥的,只会产生一次回调:
| 状态(status) | 描述 |
|---|---|
| 2 | 签名驳回 |
| 4 | 审批驳回 |
| 6 | 交易成功 |
| 7 | 交易失败 |
success字符串时为回调成功,否则为回调失败,回调失败可以进行重新推送,可登录Cregis客户端,在项目菜单中选择对应项目,在回调记录菜单中重新推送。
不同类型的业务,回调内容不同,强烈建议使用不同的接口接收回调,保证业务逻辑的清晰明确。
请求方式
HTTP POST application/json请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| pid | integer(int64) | 项目编号 |
| cid | integer(int64) | 系统流水号 |
| chain_id | string | 链编号 |
| token_id | string | 代币编号 |
| currency | string | 币种标识 |
| address | string | 地址 |
| amount | string | 金额 |
| third_party_id | string | 调用方业务编号D |
| remark | string | 备注 |
| status | integer(int32) | 状态 |
| txid | string | 交易hash |
| block_height | string | 区块高度 |
| block_time | integer(int64) | 区块时间 |
| memo | string | memo、tag等上链信息,仅Ton、Xrp支持 |
| nonce | string | 6位随机字符串 |
| timestamp | integer(int64) | 时间戳 |
| sign | string | 签名 |

