Appearance
商品核销消息推送
推送参数
其他默认推送参数文档,参考消息推送-使用说明。 当商品订单核销成功后,平台会向商家配置的消息推送地址发送事件通知,支持 BI 系统实时获取核销数据。
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| msg_type | 是 | string | 消息类型:event-事件 |
| event | 是 | string | 事件类型:goodsVerify-商品核销消息推送 |
| data | 是 | object | 消息内容 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| uid | 是 | int | 商户 ID |
| wechat_user_space_id | 是 | int | 买家用户 ID |
| room_id | 是 | int | 直播间 ID(频道 ID) |
| order_id | 是 | int | 订单 ID |
| verify_time | 是 | int | 核销时间,Unix 时间戳,单位秒 |
| verify_num | 是 | int | 本次核销数量 |
| verify_money | 是 | float | 本次核销金额 |
| market_channel_id | 是 | int | 门店 ID |
| sale_id | 是 | int | 销售员 ID |
业务场景说明
| 场景 | 说明 |
|---|---|
| 虚拟商品核销 | 用户购买虚拟商品后,销售员或管理员对核销码进行核销,触发推送 |
| 门店核销 | 门店工作人员对用户出示的核销码进行扫码核销时触发 |
room_id 说明
room_id 为直播间 ID(频道 ID),表示本次核销关联的直播间。 部分场景下(如门店独立核销)可能为 0。
推送示例
json
{
"key": "示例key",
"timestamp": 1741595400000,
"sign": "md5sign",
"msg_id": "2177E51538CC0078F0AXXX",
"msg_type": "event",
"event": "goodsVerify",
"push_msg_url": "https://example.com/push/goodsVerify",
"uid": 123456,
"data": {
"uid": 123456,
"wechat_user_space_id": 2040188,
"room_id": 10001,
"order_id": 50001,
"verify_time": 1741449600,
"verify_num": 2,
"verify_money": 99.00,
"market_channel_id": 30001,
"sale_id": 20001
}
}