Skip to main content

​
回调 API

根据创建订单填写的callback_url,当订单状态变化时会通过该回调地址通知调用方，具体了解创建订单接口中的callback_url参数 该接口为Cregis向业务方发起回调通知请求，只会产生一次回调：

​
回调事件

回调事件名称(event_name)回调事件类型(event_type)描述
orderexpired订单超时通知
orderpaid订单支付完成通知

​
请求方式

HTTP POST application/json 发起回调请求后当接收到返回内容为success字符串时为回调成功，否则为回调失败

​
请求参数

名称类型描述
event_namestring事件名称
event_typestring事件类型
dataJSONString订单信息
pidinteger(int64)项目编号
noncestring6位随机字符串
timestampinteger(int64)时间戳
signstring签名

​
data 对象

名称类型描述
cregis_idstringcregis订单编号
order_idstring订单编号
receive_amountstring汇率转换后的订单金额
receive_currencystring汇率转换后的订单货币单位
pay_amountstring实际到账金额
pay_currencystring到账货币单位
order_amountstring订单交易金额
order_currencystring订单货币代码，即ISO 4217货币代码,例如 CNY、HKD，参考法币信息列表接口
exchange_ratestring货币汇率
payment_addressstring充值地址
created_timeinteger(int64)订单创建时间【13位时间戳】
cancel_timeinteger(int64)订单取消时间【13位时间戳】
transact_timeinteger(int64)订单支付完成时间【13位时间戳】
valid_timeinteger订单超时时间【单位/分钟】
statusstring订单状态【new -待支付 paid-被调用方收到付款 expired-订单超出有效时间】
remarkstring订单备注信息
tx_idstring交易hash
payer_idstring付款人id标识
payer_namestring付款人姓名
payer_emailstring付款人邮箱
请求示例
{
    "event_name": "order",
    "event_type": "paid",
    "data": {
        "cregis_id": "po20240703132452000",
        "order_id": "c9231e604da54469a735af3f449c880f",
        "receive_amount": "20.01",
        "receive_currency": "USDT",
        "pay_amount": "20.01",
        "pay_currency": "USDT",
        "order_amount": "100",
        "order_currency": "CNY",
        "exchange_rate": "7.0000000001",
        "payment_address": "0xd38c2cf366a731dcbe4a32c7ef24ff96d080ca7e",
        "created_time": 1719993183015,
        "cancel_time": null,
        "transact_time": 1719993183325,
        "valid_time": 30,
        "status": "paid",
        "payer_id": "p_001",
        "payer_name": "",
        "payer_email": "[email protected]"
        "remark":"购买商品",
        "tx_id": "0x0502f2bfd96cd0f55edea3343513940f3af7fe594eae77f08d2f46ea24829b11"
    }
}
⌘I