# 用户进入下单页获取默认会员权益

本文档描述服务器端接收的消息或事件,详细说明参见消息推送

事件英文名:channels_ec_gen_order_info_init

  • 用户进入下单页时,将通知商家返回默认会员权益,商家需要实时回调。该接口需要商家小程序侧上线
  • 微信开放平台CallBack回调机制说明:消息推送

相关 API 接口:

# 1. 消息参数

# 请求体 Request Payload

参数名类型说明
ToUserNamestring小程序UserName
FromUserNamestring小程序用户OpenID
CreateTimenumber事件时间,Unix时间戳
MsgTypestring消息类型,固定为event
Eventstring事件类型,本接口固定为channels_ec_gen_order_info_init
gen_order_infoobject订单信息主体结构体

# Body.gen_order_info Object Payload

订单信息主体结构体

参数名类型说明
gen_order_info.shop_appidstring店铺appid
gen_order_info.order_session_idstring下单页面的会话id
gen_order_info.scenenumber场景,1: 自购,2: 群送礼,3: 单聊送礼
gen_order_info.product_infosobjarray商品信息
gen_order_info.price_infoobject价格信息

# Body.gen_order_info.gen_order_info.product_infos(Array) Object Payload

商品信息

参数名类型说明
product_idstring商品spuid
sku_idstring商品skuid
sku_cntnumbersku数量
sale_pricenumber售卖单价,单位为分
shop_discounted_pricenumber商家优惠金额,单位为分
order_product_coupon_info_listobjarray商品优惠券信息

# Body.gen_order_info.gen_order_info.product_infos(Array).order_product_coupon_info_listObject Payload

商品优惠券信息

参数名类型说明
user_coupon_idstring用户优惠券id
coupon_typenumber优惠券类型,1:商家优惠
discounted_pricenumber优惠金额,单位为分,该张优惠券抵扣该商品的金额

# Body.gen_order_info.gen_order_info.price_info Object Payload

价格信息

参数名类型说明
product_price_before_vip_discountnumber会员优惠前商品价格,单位为分
product_pricenumber商品总价,单位为分
shop_discounted_pricenumber商家优惠金额,单位为分

# 2. 消息返回

# 返回体 Response Payload

参数名类型必填说明
errcodenumber错误码
errmsgstring错误信息
info.vip_discounted_pricenumber会员优惠总金额,单位为分
info.product_infosobjarray商品列表
info.use_shop_discountnumber是否叠加使用优惠,0为叠加,1为不叠加、仅用小程序优惠;默认为0,会叠加使用优惠;如果希望不使用小程序优惠,仅使用小店优惠,需要使用默认值0,并把优惠金额也传0即可。

# Res.info.product_infos(Array) Object Payload

商品列表

参数名类型必填说明
product_idstring商品spuid
sku_idstring商品skuid
vip_discounted_pricenumber会员优惠金额

# 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
    }
}