# 小程序连接小店

# 开发前准备

• 功能了解：开发前建议先阅读以下运营文档了解完整业务流程
  • 微信小店「小程序连接小店」功能指引
  • 微信小店「关联账号」使用指南：介绍视频号、公众号、企业微信、小程序等各渠道的关联能力与操作方法
  • 微信小店「礼物抽奖」使用指南：介绍小程序/公众号/视频号直播场景下的礼物抽奖活动创建与管理
• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对权限集 ID：131的授权，使用 authorizer_access_token
• 消息推送配置：需配置消息推送回调 URL，本模块涉及的事件：[事件] 订单通知 / cooperation_shop_order。详见 消息通知（回调）说明

# 关联账号

小程序与微信小店之间需要先建立关联关系才能使用连接能力。关联关系由小店侧发起邀请，小程序侧接受后生效（status=1）；解绑后 status=2。

# 接入流程

# 关联关系建立

# 小程序组件接入

关联关系建立后，小程序可以直接使用以下原生组件展示小店内容：

# 小程序 API 接入

# 定制商品接入

适用于个性化印刷、定制刻字、3D 打印等定制商品场景。用户在小程序内完成定制操作后先上传文件获取 media_id，将 media_id 作为参数传入 <store-product> 商品卡；用户点击商品卡跳转到小店下单页完成下单；商家收到订单后通过小店服务端获取文件下载链接，完成定制发货。

两个接口均须在服务端调用，不可在小程序前端直接调用。上传资料权限集 ID：180，获取文件下载链接权限集 ID：131。

# 礼物营销接入

礼物营销支持两种玩法：直接送礼（第三方应用直接发放礼物给指定用户）和礼物抽奖（在第三方应用内发起抽奖活动，用户参与后随机中奖）。两种玩法均需在小店后台创建礼物活动并授权关联第三方应用，通过相同的 API 接口实现。

礼物 API 支持小程序、小游戏、微信小店、移动应用四种账号类型调用。小店商家在后台创建礼物活动，授权关联的第三方应用作为发礼方；第三方应用服务端通过接口查询活动、指定收礼者、创建礼物订单，完成礼物发放；用户在小程序内通过 <store-gift> 礼物组件查看和领取礼物。

角色说明：

完整接入流程：

以上接口均使用第三方应用的 access_token 调用，支持小程序、小游戏、微信小店、移动应用四种账号类型。

# 事件通知接入

配置消息推送后，当用户通过小程序进入小店下单成功，小店侧会向渠道小程序推送订单通知回调。

[事件] 订单通知 / cooperation_shop_order 推送至小程序侧配置的消息回调地址，存在两个 Event 值：

回调消息示例（解密后的明文 JSON）：

{
    "ToUserName": "gh_2defbb026678",
    "FromUserName": "OPENID",
    "CreateTime": 1706518830,
    "MsgType": "event",
    "Event": "cooperation_shop_order",
    "Data": {
        "order_id": "coiqBw3B****TdtdzIpQ",
        "shop_appid": "店铺appid"
    }
}

order_id 并非小店侧的订单 ID，仅供渠道小程序查询使用。

重试策略：0s / 0s / 10s / 1min / 5min / 30min / 60min / 60min / 60min，最多推送 10 次。

# 接口全览

# 第三方应用服务端接口

以下接口支持小程序、小游戏、微信小店、移动应用四种账号类型调用。

存在旧版接口 查询礼物订单列表（旧） 和 查询礼物订单详情（旧），推荐使用上方新版接口。

# 小店服务端接口

# 事件通知（推送至小程序侧）

# 小程序组件

# 小程序 API

# 常见问题 FAQ

Q：订单通知的 Event 有两个值，如何区分？ A：cooperation_shop_order 用于旧版关联账号，related_shop_order_submission 用于新版关联账号。两者消息结构相同，开发者需根据实际的关联关系类型处理对应的 Event 值。

Q：礼物 API 使用哪个 access_token 调用？ A：所有礼物接口均由第三方应用服务端调用，使用对应应用的 access_token，支持小程序、小游戏、微信小店、移动应用四种账号类型；上传资料（uploadec）仅小程序场景使用，由小程序服务端调用，使用小程序 access_token；获取文件下载链接（getdownloadurl）由小店服务端调用，使用小店 access_token。

文档变更日志（1条）

2026 年 04 月 28 日

新增 小程序连接小店 开发指南