订单通知
业务流程关联
下单发码流程
POST /api/order/create到店核销流程
订单完成流程
退单流程
POST /api/order/cancel通知机制详解
通知触发条件
| 状态码 | 状态描述 | 业务场景 | 触发条件 |
|---|---|---|---|
| 1 | 发码成功 | 核销码生成 | 系统自动生成核销码后 |
| 2 | 核销成功 | 到店服务 | 门店验证核销码成功后 |
| 3 | 订单完成 | 服务结束 | 服务完成，订单生命周期结束 |
| 6 | 订单取消 | 用户主动取消 | 用户主动申请取消订单后 |
重试机制
通知地址要求
接口技术规范
请求规范
| 属性 | 值 |
|---|---|
| 请求方法 | POST |
| 内容类型 | application/json |
| 字符编码 | UTF-8 |
| 请求头 | Content-Type: application/json |
通知数据结构
| 字段名称 | 字段类型 | 必填 | 长度限制 | 描述 |
|---|---|---|---|---|
| outOrderNo | String | 是 | 1-64 | 发现周边系统生成的唯一订单号 |
| channelOrderNo | String | 是 | 1-64 | 合作方系统的订单号 |
| orderTitle | String | 是 | 1-100 | 订单标题，如" 标准洗车服务" |
| orderSubTitle | String | 否 | 0-100 | 订单副标题，如"轿车专用" |
| orderDesc | String | 否 | 0-500 | 订单详细描述 |
| originPrice | Double | 是 | - | 门市价，保留2位小数 |
| salePrice | Double | 是 | - | 销售价，保留2位小数 |
| settlePrice | Double | 是 | - | 结算价，保留2位小数 |
| quantity | Integer | 是 | 1-999 | 购买数量 默认1 |
| totalSettleAmount | Double | 是 | - | 总结算价（settlePrice × quantity） |
| status | Integer | 是 | - | 订单状态，见状态说明 |
响应规范
{
"code": "200",
"message": "success"
}{
"code": "500",
"message": "具体错误信息"
}安全建议
集成指南
开发流程
1.
2.
3.
4.
修改于 2026-02-03 22:52:06