用户领券通知

用户在微信发起领券操作后,会主动回调商家进行领券,商家需根据自己的优惠券库存等情况,返回特定的领券结果。 如果商家返回成功,平台侧会记录返回的用户优惠券,为了避免因网络异常等情况导致的记录失败,建议商家在发券成功时调用“添加用户优惠券”接口,平台侧会根据商家返回的商家侧优惠券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