# 开发者使用指南

在接入微信小店 API 前，请先完成以下基础配置与概念了解。

| 章节 | 说明 | 是否必须 |
|------|------|---------|
| 接入模式 | 选择商家自研或第三方服务商接入方式 | 必接 |
| UnionID 机制 | 打通小程序、公众号、小店的用户身份 | 按需 |
| IP 白名单 | 限制 API 访问来源，防止盗刷 | 按需 |
| 公共错误码 | 接口调用报错时排查使用 | 按需 |
| 资源下载 | 官方设计素材下载 | 按需 |

## 接入模式

微信小店 API 支持两种接入模式，请根据自身角色选择：

| 模式 | 适用对象 | 鉴权方式 |
|------|---------|---------|
| **商家自研模式** | 商家自建系统，直接管理自己的小店 | 使用小店自身的 `access_token` |
| **第三方服务商模式（ISV）** | SaaS 服务商为多个商家提供统一技术服务 | 商家授权后使用 `authorizer_access_token` 代商家调用 |

### 商家自研模式

接入步骤：

1. **获取 AppID、AppSecret**：前往「[微信小店后台](https://store.weixin.qq.com/shop/servicemarket/home) - 服务市场 - 经营工具 - 自研」，可查看 AppID 和 AppSecret
2. **获取接口调用凭据**：使用 AppID、AppSecret，调用 [获取稳定版接口调用凭据](/doc/store/shop/API/apimgnt/common/api_getstableaccesstoken) 接口获取 `access_token`，后续所有业务 API 调用均需携带
3. **调用业务 API**：使用 `access_token` 调用对应业务接口，完整接口列表详见 [API 接口](/doc/store/shop/API/apimgnt/)
4. **配置消息推送**：接收事件通知（[事件通知列表](/doc/store/shop/notify/)）需配置回调地址，前往「[微信小店后台](https://store.weixin.qq.com/shop/servicemarket/home) - 服务市场 - 经营工具 - 自研 - 消息推送」设置，详见 [消息通知（回调）说明](message_push)

### 第三方服务商模式（ISV）

**商家侧**：在「微信小店 - 服务市场 - 经营工具」购买所需第三方服务，购买后会静默将对应权限集授权给第三方服务商。

**服务商侧**接入步骤：

1. **入驻服务市场 & 上架服务**：参阅 [微信小店服务市场接入指引](/doc/oplatform/partner/service_market/provider_guideline/enter_guideline/sph_enter_guideline.md)
2. **查看授权信息**：
   - [拉取已授权的账号信息](/doc/oplatform/openApi/authorization-management/api_getauthorizerlist.md)（`getAuthorizerList`）：获取 `authorizer_appid`、`refresh_token` 等
   - [获取授权账号详情](/doc/oplatform/openApi/authorization-management/api_getauthorizerinfo.md)（`getAuthorizerInfo`）：获取授权账号信息、授权信息
3. **代商家调用 API**：
   - 生成 `authorizer_access_token`：参阅 [Token 生成说明](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/creat_token.md)
   - 使用 `authorizer_access_token` 代商家调用接口：参阅 [如何代商家调用接口](/doc/oplatform/Third-party_Platforms/2.0/getting_started/how_to_call_api.md)
4. **权限集说明**：参阅 [微信小店权限集](/doc/oplatform/Third-party_Platforms/2.0/product/miniprogram_authority.md)。各业务 API 文档中均注明其所属权限集 ID，可按需查阅

> 遇到 `48001`（无接口权限）或 `61007`（第三方平台未获授权），参阅 [权限集常见排错指南](/doc/oplatform/Third-party_Platforms/2.0/troubleshooting/third_party_authority_instructions_troubleshooting.md)；也可使用官方 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug) 定位问题。

## UnionID 机制

UnionID 用于在同一微信开放平台账号下，打通小程序、公众号、小店等多个应用的用户唯一标识。

**前置条件**：需将微信小店绑定到微信开放平台账号。

**绑定规则**：
- 开放平台账号需完成开发者资质认证
- 支持同主体或关联主体绑定
- 一个小店只能绑定一个开放平台账号
- 一个开放平台账号最多可绑定 20 个小店

**操作**：
- **绑定**：前往 [微信开发者平台](https://developers.weixin.qq.com/platform/) - 我的业务 - 微信小店 - 绑定关系 - 开放平台，输入开放平台账号的邮箱或 AppID，点击「绑定」，由开放平台账号管理员授权后完成绑定
- **解绑**：同上入口操作解除绑定
- **查看绑定关系**：
  - [微信小店后台](https://store.weixin.qq.com/shop/setting/home) - 店铺管理 - 基础信息 - 账号信息 - 开放平台账号
  - [微信开发者平台](https://developers.weixin.qq.com/platform/) - 我的业务 - 微信小店 - 绑定关系 - 开放平台（还可查看该开放平台账号下绑定的其他应用，如小程序）

## IP 白名单

配置 IP 白名单可限制 API 访问来源，防止恶意盗刷。

**配置入口**：[微信小店后台](https://store.weixin.qq.com/shop/servicemarket/home) - 服务市场 - 经营工具 - 自研 - IP 白名单（仅小店管理员可操作）

| 规则 | 说明 |
|------|------|
| IP 数量上限 | 200 个 |
| 网段格式 | 仅支持 `/8`、`/16`、`/24` |
| 端口格式 | 不支持 `IP:端口` 形式 |
| 生效方式 | 启用后，未匹配白名单的 IP 访问返回 403 |
| 失效方式 | 删除所有 IP 后白名单自动失效 |

## 公共错误码

调用 API 时，若出现错误，请参阅公共错误码说明进行排查：[公共错误码](commErrCode)

> 如遇 `48001`（无接口权限）或 `61007`（第三方平台未获授权），建议参考[权限集常见排错指南](/doc/oplatform/Third-party_Platforms/2.0/troubleshooting/third_party_authority_instructions_troubleshooting.md)进行排查。

## 资源下载

- 微信礼物 LOGO：[下载链接](https://res.wx.qq.com/op_res/3kWcgkmldD0U2Lw1hMVI68GLul6ZnFhsWcVnyYTf44mJU1Kcj5pfTPmesNIEflINhZb6ziS-ABnYjqG9ADy2iQ)

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条）
2026 年 04 月 29 日新增 开发者使用指南