# 用户进入下单页获取默认会员权益
本文档描述服务器端接收的消息或事件,详细说明参见消息推送。
事件英文名:channels_ec_gen_order_info_init
- 用户进入下单页时,将通知商家返回默认会员权益,商家需要实时回调。该接口需要商家小程序侧上线。
- 微信开放平台CallBack回调机制说明:消息推送
相关 API 接口:
# 1. 消息参数
# 请求体 Request Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 小程序UserName |
| FromUserName | string | 小程序用户OpenID |
| CreateTime | number | 事件时间,Unix时间戳 |
| MsgType | string | 消息类型,固定为event |
| Event | string | 事件类型,本接口固定为channels_ec_gen_order_info_init |
| gen_order_info | object | 订单信息主体结构体 |
# Body.gen_order_info Object Payload
订单信息主体结构体
| 参数名 | 类型 | 说明 |
|---|---|---|
| gen_order_info.shop_appid | string | 店铺appid |
| gen_order_info.order_session_id | string | 下单页面的会话id |
| gen_order_info.scene | number | 场景,1: 自购,2: 群送礼,3: 单聊送礼 |
| gen_order_info.product_infos | objarray | 商品信息 |
| gen_order_info.price_info | object | 价格信息 |
# Body.gen_order_info.gen_order_info.product_infos(Array) Object Payload
商品信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| product_id | string | 商品spuid |
| sku_id | string | 商品skuid |
| sku_cnt | number | sku数量 |
| sale_price | number | 售卖单价,单位为分 |
| shop_discounted_price | number | 商家优惠金额,单位为分 |
| order_product_coupon_info_list | objarray | 商品优惠券信息 |
# Body.gen_order_info.gen_order_info.product_infos(Array).order_product_coupon_info_listObject Payload
Object Payload商品优惠券信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| user_coupon_id | string | 用户优惠券id |
| coupon_type | number | 优惠券类型,1:商家优惠 |
| discounted_price | number | 优惠金额,单位为分,该张优惠券抵扣该商品的金额 |
# Body.gen_order_info.gen_order_info.price_info Object Payload
价格信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| product_price_before_vip_discount | number | 会员优惠前商品价格,单位为分 |
| product_price | number | 商品总价,单位为分 |
| shop_discounted_price | number | 商家优惠金额,单位为分 |
# 2. 消息返回
# 返回体 Response Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| errcode | number | 是 | 错误码 |
| errmsg | string | 是 | 错误信息 |
| info.vip_discounted_price | number | 是 | 会员优惠总金额,单位为分 |
| info.product_infos | objarray | 是 | 商品列表 |
| info.use_shop_discount | number | 否 | 是否叠加使用优惠,0为叠加,1为不叠加、仅用小程序优惠;默认为0,会叠加使用优惠;如果希望不使用小程序优惠,仅使用小店优惠,需要使用默认值0,并把优惠金额也传0即可。 |
# Res.info.product_infos(Array) Object Payload
商品列表
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | string | 是 | 商品spuid |
| sku_id | string | 是 | 商品skuid |
| vip_discounted_price | number | 是 | 会员优惠金额 |
# 3. 注意事项
本事件无特殊注意事项
# 4. 代码示例
请求示例
具体取决于你配置的数据格式(JSON或XML)
{
"ToUserName": "gh_*",
"FromUserName": "OPENID",
"CreateTime": 1662480000,
"MsgType": "event",
"Event": "channels_ec_gen_order_info_init",
"gen_order_info": {
"shop_appid": "shop_appid",
"order_session_id": "order_session_id",
"scene": 1,
"product_infos": [{
"product_id": "1234567",
"sku_id": "2345678",
"sku_cnt": 1,
"sale_price": 10000,
"shop_discounted_price": 1000,
"order_product_coupon_info_list": [{
"user_coupon_id": "11111",
"coupon_type": 1,
"discounted_price": 1000
}]
}],
"price_info": {
"product_price_before_vip_discount": 9000,
"product_price": 10000,
"shop_discounted_price": 1000
}
}
}
返回示例
具体取决于你配置的数据格式(JSON或XML)
{
"errcode": 0,
"errmsg": "ok",
"info": {
"vip_discounted_price": 100,
"product_infos": [{
"product_id": "12345",
"sku_id": "23456",
"vip_discounted_price": 100
}],
"unuse_shop_discount": 0
}
}