用户领券通知 | 微信开放文档

# 用户领券通知

用户在微信发起领券操作后，会主动回调商家进行领券，商家需根据自己的优惠券库存等情况，返回特定的领券结果。如果商家返回成功，平台侧会记录返回的用户优惠券，为了避免因网络异常等情况导致的记录失败，建议商家在发券成功时调用“添加用户优惠券”接口，平台侧会根据商家返回的商家侧优惠券ID和商家侧用户优惠券ID确保唯一性；建议也调用“更新优惠券库存”接口进行库存更新。

# 回调请求参数示例

以商家设置的数据格式（json或xml）为准，这里以xml为例

<xml>
    <ToUserName>gh_abcdefg</ToUserName> 
    <FromUserName>oABCD</FromUserName> 
    <CreateTime>12344555555</CreateTime>
    <MsgType>event</MsgType> 
    <Event>open_product_receive_coupon</Event>
    <out_coupon_id>real_out_coupon_id</out_coupon_id>
    <request_id>real_request_id</request_id>
</xml>

# 回调回包示例

以商家设置的数据格式（json或xml）为准，这里以xml为例

<xml> 
  <out_user_coupon_id>real_out_user_coupon_id</out_user_coupon_id>  
  <request_id>real_request_id</request_id>  
  <ret_code>0</ret_code>
  <ret_msg>ok</ret_msg>
  <out_coupon_id>real_out_coupon_id</out_coupon_id> 
</xml>

# 回调请求参数说明

参数	类型	说明
ToUserName	string	商家小程序名称
FromUserName	string	微信用户的 OpenID
CreateTime	number	事件时间,Unix时间戳
MsgType	string	消息类型,固定为 event
Event	string	事件类型,本接口固定为 open_product_receive_coupon
out_coupon_id	string	商家端优惠券ID
request_id	string	请求唯一ID

# 回调回包参数说明

参数	类型	说明
ret_code	number	0：成功，1090029：库存不足，1090030：个人限领超限制，1090031：请求限频，1090057：优惠券不存在，1090058：优惠券状态不对，1090032：系统失败，1090033：其他逻辑失败；
ret_msg	string	返回描述，不会在视频号场景领券失败时展示。
out_user_coupon_id	string	商家侧用户优惠券ID
out_coupon_id	string	商家侧优惠券ID
request_id	string	请求唯一ID

# 视频号场景领券失败展示错误文案

返回码	错误文案
1090029	抢光了
1090030	已达最大领取限额
1090031	领券太频繁，请稍后再试
1090032	领取失败，请稍后再试
1090033	领取失败，请稍后再试
1090057	此券无效
1090058	领取失败，请稍后再试