微信支付 APIv3 配置教程：从商户平台获取参数到表单填写

系列文章导航：主要讲解微信支付 APIv3 基础参数的获取与配置。如果你还未完成商户号注册或应用绑定，请先阅读前序文章。

引言

在接入微信支付时，第一步也是极其关键的一步，就是准确无误地获取并配置 API 参数。本文将以微信支付 APIv3（平台公钥模式） 为标准，手把手教你如何从商户平台获取各项核心参数，并正确填入配置表单中。

一、配置前准备

在开始获取参数前，请确认你已具备以下条件：

1. 已注册并认证的微信支付商户号。
2. 已有一个与商户号绑定的 AppID（公众号、小程序或移动应用）。
3. 当前操作账号为超级管理员（或已授予“技术负责人”权限），因为申请证书和设置密钥需要最高权限。

安全警告：本文示例中涉及的 AppID、商户号、私钥、密钥等，均为脱敏占位符。在实际配置时，切勿将真实私钥和 APIv3 密钥泄露，也不要将其提交到公开的代码仓库。

二、参数总览与获取路径

以下是配置表单中需要填写的 6 个核心参数及其对应的用途：

三、逐项获取与配置指南

1. AppID

AppID 根据你的应用载体类型获取：

• 公众号/服务号：微信公众平台 →「设置与开发 → 开发接口管理 → 基本配置」。
• 小程序：微信公众平台小程序后台 →「开发 → 开发管理 → 开发设置」。
• 移动应用：微信开放平台 →「管理中心 → 移动应用 → 应用详情」。

注意：获取后请务必确认该 AppID 已在商户平台完成关联绑定。

2. 商户号 (mchid)

登录微信支付商户平台，进入「账户中心 → 商户信息」，页面中展示的“微信支付商户号”即为所需参数。

3. API v3 密钥

APIv3 密钥用于解密回调通知中的敏感数据。它由你自己设定，并非由微信支付分配。

• 设置路径：超级管理员登录商户平台 →「账户中心 → 账户设置 → API 安全」→ 找到「APIv3 密钥」→ 点击“设置”。
• 格式要求：必须是 32 个字符（支持数字和大小写字母组合）。
• 重要提示：设置成功后无法再次查看明文，只能重新设置。请务必在设置时立即将其保存到密码管理器中。

4. 商户证书序列号 & 商户私钥

这两个参数来自“商户 API 证书”。私钥是申请过程中本地生成的，序列号则是微信支付对该证书的编号。

1. 申请证书：登录商户平台，进入「账户中心 → 账户设置 → API 安全 → 申请 API 证书」。
2. 生成私钥：下载并使用“微信支付证书工具”，按照提示生成证书请求串并换取证书。
3. 提取私钥：在生成的文件夹中找到 apiclient_key.pem，用文本编辑器打开，复制完整内容（包含 -----BEGIN PRIVATE KEY----- 和 -----END PRIVATE KEY-----）。
4. 查看序列号：在商户平台「API 安全 → 管理证书」页面中，可以查看到该证书对应的序列号。

避坑指南：请勿将 apiclient_cert.pem（证书文件）误当作 apiclient_key.pem（私钥文件）填入。两者内容完全不同。

5. 微信支付平台公钥

当前微信支付推荐使用平台公钥模式，这可以免去每 5 年更换一次平台证书的运维烦恼。

• 获取路径：商户平台 →「账户中心 → API 安全 → 微信支付公钥 → 管理公钥」→ 点击“下载公钥”。
• 配置操作：下载 .pem 格式文件后，用文本编辑器打开，复制包含 -----BEGIN PUBLIC KEY----- 和 -----END PUBLIC KEY----- 的全部内容填入表单。
• 核心动作：下载后，需要在页面中手动开启“公钥切换”。若不开启，微信支付可能仍按旧版平台证书模式返回应答。

四、配置后的验证要点

参数填写完成后，请进行以下验证：

1. 匹配性检查：确保填入的“商户私钥”与商户平台上展示的“证书序列号”属于同一套证书。
2. 确认公钥开关：再次确认商户平台的“公钥切换”开关已处于开启状态。
3. 发起最小金额测试：使用 0.01 元发起一笔真实支付，观察下单请求是否成功，以及回调是否能被正确解密并验签。

五、常见问题速查 (FAQ)