微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 商品上下架

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

    事件英文名：product_spu_listing

    微信小店会通过该接口将商品的上下架操作消息通知给商户

    # 1. 消息参数

    # 请求体 Request Payload

    参数名类型说明
    ToUserNamestring小店UserName
    FromUserNamestring微信团队的 OpenID(固定值)
    CreateTimenumber事件时间,Unix时间戳(即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒起至现在的总秒数)
    MsgTypestring消息类型,固定为 event
    Eventstring事件类型,本接口固定为 product_spu_listing
    ProductSpuListingobject 事件主体

    # Body.ProductSpuListing Object Payload

    事件主体

    参数名类型说明
    product_idstring商品ID
    statusnumber状态。5:上架；11:自主下架；13:系统下架；14:保证金违规下架；15:品牌到期下架; 20:封禁下架。
    reasonstring下架原因，非必填字段
    product_typenumber商品类型。1:小店自营商品；4:在售赠品；5:非卖商品。

    # 2. 消息返回

    # 返回体 Response Payload

    回复 success 或空字符串（无需加密）

    # 3. 注意事项

    • 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，商户将无法收微信小店发送的通知；

    # 4. 代码示例

    请求示例

    {
    "ToUserName":"gh_*",
    "FromUserName":"OPENID",
    "CreateTime":1662480000,
    "MsgType":"event",
    "Event":"product_spu_listing",
    "ProductSpuListing": {
        "product_id":"12345678",
        "status":3,
        "reason":"abc",
        "product_type":1
    }
}

    返回示例

    success
    文档变更日志（1条）
    2026 年 02 月 12 日
    新增 proudct_type 字段