Documentation Index
Fetch the complete documentation index at: https://developer-cn.cregis.com/llms.txt
Use this file to discover all available pages before exploring further.
回调 API
根据创建订单填写的callback_url,当订单状态变化时会通过该回调地址通知调用方，具体了解创建订单接口中的callback_url参数
该接口为Cregis向业务方发起回调通知请求，只会产生一次回调：
回调事件
| 回调事件名称(event_name) | 回调事件类型(event_type) | 描述 |
|---|
| order | expired | 订单超时通知 |
| order | paid | 订单支付完成通知 |
请求方式
HTTP POST application/json
发起回调请求后当接收到返回内容为success字符串时为回调成功，否则为回调失败
请求参数
| 名称 | 类型 | 描述 |
|---|
| event_name | string | 事件名称 |
| event_type | string | 事件类型 |
| data | JSONString | 订单信息 |
| pid | integer(int64) | 项目编号 |
| nonce | string | 6位随机字符串 |
| timestamp | integer(int64) | 时间戳 |
| sign | string | 签名 |
data 对象
| 名称 | 类型 | 描述 |
|---|
| cregis_id | string | cregis订单编号 |
| order_id | string | 订单编号 |
| receive_amount | string | 汇率转换后的订单金额 |
| receive_currency | string | 汇率转换后的订单货币单位 |
| pay_amount | string | 实际到账金额 |
| pay_currency | string | 到账货币单位 |
| order_amount | string | 订单交易金额 |
| order_currency | string | 订单货币代码，即ISO 4217货币代码,例如 CNY、HKD，参考法币信息列表接口 |
| exchange_rate | string | 货币汇率 |
| payment_address | string | 充值地址 |
| created_time | integer(int64) | 订单创建时间【13位时间戳】 |
| cancel_time | integer(int64) | 订单取消时间【13位时间戳】 |
| transact_time | integer(int64) | 订单支付完成时间【13位时间戳】 |
| valid_time | integer | 订单超时时间【单位/分钟】 |
| status | string | 订单状态【new -待支付 paid-被调用方收到付款 expired-订单超出有效时间】 |
| remark | string | 订单备注信息 |
| tx_id | string | 交易hash |
| payer_id | string | 付款人id标识 |
| payer_name | string | 付款人姓名 |
| payer_email | string | 付款人邮箱 |
请求示例
{
"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"
}
}
