小程序
取消
开发
中文
EN
取消
  • 平台能力

    • # 用户领券通知

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