# 开发者使用指南

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

# 接入模式

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

# 商家自研模式

接入步骤：

1. 获取 AppID、AppSecret：前往「微信小店后台 - 服务市场 - 经营工具 - 自研」，可查看 AppID 和 AppSecret
2. 获取接口调用凭据：使用 AppID、AppSecret，调用 获取稳定版接口调用凭据 接口获取 access_token，后续所有业务 API 调用均需携带
3. 调用业务 API：使用 access_token 调用对应业务接口，完整接口列表详见 API 接口
4. 配置消息推送：接收事件通知（事件通知列表）需配置回调地址，前往「微信小店后台 - 服务市场 - 经营工具 - 自研 - 消息推送」设置，详见 消息通知（回调）说明

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

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

服务商侧接入步骤：

1. 入驻服务市场 & 上架服务：参阅 微信小店服务市场接入指引
2. 查看授权信息：
   • 拉取已授权的账号信息（getAuthorizerList）：获取 authorizer_appid、refresh_token 等
   • 获取授权账号详情（getAuthorizerInfo）：获取授权账号信息、授权信息
3. 代商家调用 API：
   • 生成 authorizer_access_token：参阅 Token 生成说明
   • 使用 authorizer_access_token 代商家调用接口：参阅 如何代商家调用接口
4. 权限集说明：参阅 微信小店权限集。各业务 API 文档中均注明其所属权限集 ID，可按需查阅

遇到 48001（无接口权限）或 61007（第三方平台未获授权），参阅 权限集常见排错指南；也可使用官方 API 诊断工具 定位问题。

# UnionID 机制

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

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

绑定规则：

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

操作：

• 绑定：前往 微信开发者平台 - 我的业务 - 微信小店 - 绑定关系 - 开放平台，输入开放平台账号的邮箱或 AppID，点击「绑定」，由开放平台账号管理员授权后完成绑定
• 解绑：同上入口操作解除绑定
• 查看绑定关系：
  • 微信小店后台 - 店铺管理 - 基础信息 - 账号信息 - 开放平台账号
  • 微信开发者平台 - 我的业务 - 微信小店 - 绑定关系 - 开放平台（还可查看该开放平台账号下绑定的其他应用，如小程序）

# IP 白名单

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

配置入口：微信小店后台 - 服务市场 - 经营工具 - 自研 - IP 白名单（仅小店管理员可操作）

# 公共错误码

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

如遇 48001（无接口权限）或 61007（第三方平台未获授权），建议参考权限集常见排错指南进行排查。

# 资源下载

• 微信礼物 LOGO：下载链接