📌 整理来源：微信官方文档（developers.weixin.qq.com / open.weixin.qq.com / mp.weixin.qq.com / pay.weixin.qq.com）— 2026 年 6 月

一、平台体系概览#

微信开发生态由四大核心平台组成，每个平台职责不同，注册入口也不同。搞清楚这四个平台的关系，是进入微信生态开发的第一步。

二、微信开放平台（open.weixin.qq.com）#

官方文档：开放平台介绍

🎯 能干什么#

• 将移动 App、网站应用、小程序、公众号等所有产品绑定到同一账号，获得 UnionID，实现跨应用用户身份打通
• 为移动应用（iOS / Android / HarmonyOS）接入微信登录、微信分享、微信支付
• 为网站应用（PC 网页）接入微信扫码登录
• 管理第三方平台（代理运营他人公众号 / 小程序）

📋 注册与管理#

• open.weixin.qq.com → 注册开发者账号 → 需要企业资质认证（300元/年）
• 管理：open.weixin.qq.com 后台，部分功能已迁移至 微信开发者平台

🔑 核心概念#

• AppID / AppSecret：每个应用的唯一凭证，所有 API 调用的基础
• OpenID：同一用户对不同应用有不同 OpenID（用户 + AppID → 唯一标识）
• UnionID：同一开放平台账号下所有应用共享同一个 UnionID（跨产品用户打通的关键）

🛠 主要 API#

# 移动应用 / 网站应用微信登录
GET https://api.weixin.qq.com/sns/oauth2/access_token
  ?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

# 获取用户信息
GET https://api.weixin.qq.com/sns/userinfo
  ?access_token=TOKEN&openid=OPENID

# PC 扫码登录（网站应用）
https://open.weixin.qq.com/connect/qrconnect
  ?appid=APPID&redirect_uri=URI&response_type=code&scope=snsapi_login

三、微信公众平台（mp.weixin.qq.com）#

官方入口：mp.weixin.qq.com | 开发文档：公众号文档 / 服务号文档 公众平台是注册和运营所有微信内产品的主入口，包含四种账号类型。

📊 账号类型对比#

⚠️ 公众号 vs 服务号重要区别#

• 消息入口：服务号消息出现在聊天列表（一级），公众号折叠在订阅号文件夹（二级，要点两次）
• 微信支付：仅服务号认证后支持，公众号不支持
• 自定义菜单：服务号无需认证即有；公众号需认证才有
• 多客服：服务号支持，公众号不支持

ℹ️ 注：原「订阅号」已正式更名为「公众号」

🛠 主要 API（公众号 / 服务号）#

文档：公众号 API 文档

# 获取 access_token（所有 API 的入口凭证，有效期 2 小时，需服务端缓存刷新）
GET https://api.weixin.qq.com/cgi-bin/token
  ?grant_type=client_credential&appid=APPID&secret=SECRET

# 网页授权（在微信内 H5 获取用户身份）
https://open.weixin.qq.com/connect/oauth2/authorize
  ?appid=APPID&redirect_uri=URI&response_type=code&scope=snsapi_userinfo

# 发送模板消息
POST https://api.weixin.qq.com/cgi-bin/message/template/send

# 内容安全检测
POST https://api.weixin.qq.com/wxa/msg_sec_check

四、小程序 vs 小游戏#

小程序文档：developers.weixin.qq.com/miniprogram | 小游戏文档：developers.weixin.qq.com/minigame

🧮 公式：小游戏 = 小程序 + (Canvas渲染 / 文件系统 / 多线程) − (多页面 / WXSS / WXML)

五、移动应用 & 网站应用#

注册与管理均在 open.weixin.qq.com，需企业认证（300元/年）。

移动应用 SDK 接入#

接入指南：iOS / Android / 鸿蒙

# Android（gradle）
implementation 'com.tencent.mm.opensdk:wechat-sdk-android:+'

# iOS（CocoaPods）
pod 'WechatOpenSDK'

# 鸿蒙 HarmonyOS：通过 ohpm 引入微信 OpenSDK

六、微信开发者平台（一站式工作台）#

地址：developers.weixin.qq.com/platform 这是面向开发者的统一管理后台，获得「开发者权限」后可在此集中管理旗下所有微信产品。

🎯 能干什么#

• 管理和配置：公众号、服务号、小程序、小游戏、小店、移动应用、网站应用的开发信息（AppID、域名白名单等）
• 管理产品间的绑定关系（如将小程序绑定到开放平台账号以获取 UnionID）
• 管理授权关系（如第三方平台代运营授权）
• API 接口监控与告警（调用量、错误率、耗时统计）
• 成员管理（添加开发者、体验者权限）
• 查看微信支付、流量主等数据概览

七、统一身份机制（UnionID）#

官方说明：开放平台介绍 - UnionID 机制 这是微信跨产品打通用户体系的核心机制，理解它对设计会员系统至关重要。

🔑 速记公式：微信用户 + AppID = OpenID | 微信用户 + 开放平台账号 = UnionID

如何获得 UnionID#

1. 将小程序 / 公众号 / 移动应用全部绑定到同一个开放平台账号（open.weixin.qq.com）
2. 用户授权登录任意一个产品后，即可在后端通过 API 获取该用户的 UnionID
3. 用 UnionID 作为用户唯一 key，关联所有产品的用户数据

典型应用场景#

• 会员体系打通：小程序积分 + App 购买记录 + 公众号互动数据，用 UnionID 统一归一
• 跨端数据分析：同一用户的多端行为关联分析
• 统一用户画像：整合各端数据建立完整用户档案

八、注册决策树：我该在哪里注册？#

根据你的需求，选择对应平台和账号类型：

九、常见坑 & 注意事项#

🚫 小程序和小游戏账号不互通#

即使类目选错，AppID 已生成就无法更改账号类型，必须重新注册新账号。注册前务必确认是小程序还是小游戏。

🚫 UnionID 不是自动就有的#

必须先将所有产品绑定到同一开放平台账号，才能获取 UnionID。单独用 mp.weixin.qq.com 注册的小程序，只有 OpenID，没有 UnionID。

🚫 个人主体有功能限制#

个人注册的公众号无法使用微信支付、多客服、模板消息等高级功能。小游戏个人主体无法开通虚拟支付（内购）。

🚫 access_token 有效期只有 2 小时#

需要在服务端定时刷新并缓存 access_token，不能每次请求都重新获取（有调用频率限制，超限会返回 45009 错误）。

🚫 小程序域名必须提前配置#

小程序只能访问已在 mp.weixin.qq.com 后台 配置了 request 合法域名的服务器，开发期间可在开发者工具中关闭域名校验。

十、快速参考：各平台 API 根域名#

# 通用 API（公众号、服务号、小程序、开放平台）
https://api.weixin.qq.com/

# 小程序登录
POST https://api.weixin.qq.com/sns/jscode2session
  ?appid=APPID&secret=SECRET&js_code=CODE&grant_type=authorization_code

# 微信支付（APIv3）
https://api.mch.weixin.qq.com/

# 开放平台 OAuth
https://open.weixin.qq.com/connect/oauth2/authorize
https://open.weixin.qq.com/connect/qrconnect  # PC 扫码

十一、微信支付平台（pay.weixin.qq.com）#

文档中心：pay.weixin.qq.com/doc/v3/merchant | 接入指引：申请商户号 微信支付是独立于公众平台和开放平台的第四个核心平台，接入它需要同时准备好 mchid（商户号）和 AppID 两个凭证，然后将二者绑定。

1. 开通费用#

💡 服务商费率机制：服务商并非吃费率差，而是靠微信官方返点盈利。公式：返点比例 = 交易结算费率 − 0.2%（费率 ≤ 0.2% 则返点 0.05%）。服务商额外收入来自收银系统、小程序商城等增值服务。参考：服务商模式说明

2. 接入模式#

官方文档：接入模式说明

3. 支付产品选型（按场景）#

官方文档：支付产品说明

⚠️ H5 支付 vs JSAPI 支付容易混淆：JSAPI 在微信客户端内浏览器里调起，需服务号 AppID 获取 openid；H5 在手机外部浏览器（Safari/Chrome）里调起，跳转到微信 App 完成支付再跳回。两者 API 接口和参数完全不同，不能混用。

4. 完整申请流程：mchid 与 AppID#

官方文档：mchid 与 AppID 申请 申请 mchid 和 AppID 互不影响，可并行进行，最后再绑定。

Step 1 — 申请商户号（mchid）#

• 入口：pay.weixin.qq.com → 接入微信支付 → 普通商户入驻
• 支持主体：个体工商户、企业、政府机关、事业单位、社会组织（注意：纯个人不支持）
• 审核通过后，联系邮箱会收到含 mchid 及登录账号密码的通知邮件
• ⚠️ 一个 mchid 只能对应一种结算币种；同一法人申请数量由系统风控策略动态分配

Step 2 — 申请 AppID（按场景选载体）#

• 服务号 → mp.weixin.qq.com 注册 → 企业认证 300元/年（用于 JSAPI 支付）
• 小程序 → mp.weixin.qq.com 注册 → 认证 300元/年（用于小程序支付）
• 移动应用 → open.weixin.qq.com 注册开放平台 → 创建移动应用 → 审核通过才有移动应用 AppID → 认证 300元/年（用于 APP 支付、H5 支付）

⚠️ 重要：open.weixin.qq.com 认证完成后，账号设置里的 AppID 是「开放平台账号本身的 ID」，不是移动应用的 AppID，不能用于绑定商户号。必须在开放平台内单独「创建移动应用」并审核通过后，才会生成真正可绑定商户号的移动应用 AppID。两者是不同层级的凭证。

Step 3 — 绑定 mchid 与 AppID#

• 普通商户：登录商户平台 → 账户中心 → AppID 账号管理 → 关联 AppID
• 服务商：登录服务商平台 → 同上路径操作，绑定自己的 AppID 或子商户的 AppID
• 官方操作指引：管理商户号绑定的 APPID 账号

5. APIv3 技术规范#

官方文档：APIv3 概述 | 签名与验签说明 微信支付当前主推 APIv3，相比旧版 V2 的主要变化：

• 数据格式：XML → JSON
• 签名算法：MD5 / HMAC-SHA256 → SHA256-RSA（非对称密钥），需要商户 API 证书签名
• 验签方式（二选一）：微信支付公钥模式（推荐，按需更新）或平台证书模式（有效期 5 年，到期需更新）
• 敏感字段加密：AES-256-GCM 对回调关键信息加密
• 风格：遵循 REST 设计规范

APIv3 根域名与关键端点#

# 所有 APIv3 接口根域名
https://api.mch.weixin.qq.com/

# JSAPI / 小程序下单（appid 填对应 AppID）
POST https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi

# H5 下单
POST https://api.mch.weixin.qq.com/v3/pay/transactions/h5

# Native 下单（返回 code_url 二维码）
POST https://api.mch.weixin.qq.com/v3/pay/transactions/native

# APP 下单
POST https://api.mch.weixin.qq.com/v3/pay/transactions/app

# 查询订单（微信订单号）
GET https://api.mch.weixin.qq.com/v3/pay/transactions/id/{transaction_id}

# 查询订单（商户订单号）
GET https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/{out_trade_no}

# 申请退款
POST https://api.mch.weixin.qq.com/v3/refund/domestic/refunds

官方 SDK（强烈推荐，封装签名/加密/验签）#

Java SDK：接入文档 | Go SDK：接入文档 | GitHub：wechatpay-apiv3 | Postman 工具：下载

开发必备凭证清单#

6. 微信支付接入常见坑#

🚫 账号级 AppID ≠ 移动应用 AppID#

• open.weixin.qq.com 认证后账号设置里的 AppID 是开放平台账号本身的 ID，不能用于绑定商户号。必须额外「创建移动应用」并审核通过后才有可用的移动应用 AppID。

🚫 服务商模式下子商户 AppID 是可选的#

• 服务商用自己的 sp_appid 代子商户发起支付时，sub_appid 可以不传。但若传了 sub_appid，用户的 sub_openid 和 sp_openid 会同时返回，便于后续用户身份关联。参考：参数说明

🚫 Native 支付不强依赖 AppID#

• PC 网站展示收款二维码走 Native 支付，只需商户号即可下单生成 code_url 二维码，无需绑定 AppID。是 PC 场景接入成本最低的方式。参考：Native 支付文档

🚫 支付回调必须做幂等处理#

• 微信支付的支付成功通知（notify）可能重复推送，服务端必须以商户订单号做幂等判断，避免重复发货。参考：回调和查单最佳实践

🚫 证书和密钥需要安全存储#

• 商户 API 私钥（apiclient_key.pem）绝对不能提交到 Git 仓库或写入代码。建议用环境变量或密钥管理服务（KMS）存储。参考：API 安全最佳实践

🗓️ 文档整理时间：2026 年 6 月 | 数据来源：微信开放平台文档 / 微信公众平台文档 / 微信支付文档中心