微信支付接入 · 需要您配合的 6 项
一句话:museav 要开通微信支付收款。微信的安全机制决定了密钥和证书只能由您在商户平台生成, 所以需要您花大约 30 分钟做 6 步操作,把生成的东西交给我。
一、为什么必须您来做
微信支付把「商户身份凭证」的生成权只给超级管理员(也就是您)。
更要紧的是,其中两项只有一次机会:
| 东西 | 为什么只有一次 |
|---|---|
| APIv3 密钥 | 设置成功后,商户平台不再显示,只支持「重新设置」—— 重设会让线上支付中断 |
| 商户 API 证书私钥 | 只能由证书工具导出,丢失无法找回,只能把证书作废后重新申请 |
我作为技术方拿不到这两样,只能由您生成后交给我。这不是流程上的客套,是微信的硬性设计。
二、您要交给我的 6 样东西
| # | 东西 | 长什么样 | 从哪拿 |
|---|---|---|---|
| 1 | 商户号 | 10 位数字 | 商户平台首页 / 账户中心 → 商户信息 |
| 2 | APIv3 密钥 | 32 位字母数字 | 账户中心 → API安全 → APIv3密钥 → 设置 |
| 3 | 商户 API 证书 | 一个压缩包(含 4 个文件) | 账户中心 → API安全 → 商户API证书 → 申请证书 |
| 4 | 证书序列号 | 40 位字母数字 | 账户中心 → API安全 → 商户API证书 → 管理证书 |
| 5 | 微信支付公钥 | 一个 .pem 文件 + 一串公钥 ID |
账户中心 → API安全 → 微信支付公钥 → 申请公钥 |
| 6 | AppID | wx 开头的一串 |
产品中心 → AppID账号管理 |
第 3 项那个压缩包整个发给我就行,不用挑文件。
三、操作步骤(照着做)
登录入口:https://pay.weixin.qq.com/ —— 用超级管理员的微信扫码登录。
第 0 步 · 先把我设成「技术负责人」(重要)
【账户中心】→【账户设置】→ 找到「安全联系人 / 技术负责人」,填上我的联系方式。
为什么先做这步:后面所有安全验证提醒、密钥变更风险通知,都只会发给技术负责人。 不设的话,出问题我收不到通知,只能等您转告。
第 1 步 · 商户号
【账户中心】→【商户信息】,页面上直接能看到,10 位数字(形如 1230000109)。
第 2 步 · APIv3 密钥 ⚠️ 只能拿一次
路径:【账户中心】→【API安全】→【解密回调】→【APIv3密钥】→ 点「设置」
- 弹窗提示"请确认已和技术人员沟通"→ 点「已沟通」
- 输入 32 位密钥 → 点「确定」
- 安全验证:输入操作密码 + 短信验证码 → 确定
- 点「完成」
⚠️ 设置成功后平台不再显示,只能重新设置。
✅ 推荐做法:我已经生成好一个 32 位密钥了,您直接拿去粘贴设置即可 —— 这样一次成功,不用"先随便设一个、发现看不到、再重设"。密钥我会单独发您。
用途:解密微信支付回调过来的通知数据。无过期时间。
第 3 步 · 商户 API 证书 ⚠️ 私钥丢了不可找回
路径:【账户中心】→【API安全】→【商户API证书】→ 点「申请证书」
这一步需要在您自己的电脑上完成(要装一个小工具),是「平台 ↔ 工具」来回粘贴的过程:
- 点「申请证书」→ 弹窗里点「下载证书工具」
- 复制弹窗里的商户号和商户名称(待会要粘进工具)
- 安装并打开证书工具 → 选好证书存放位置 → 点「申请证书」
- 把商户号 + 商户名称粘进工具 → 下一步
- 工具里点「复制证书请求串」
- 把请求串粘回商户平台的输入框 → 下一步
- 安全验证:操作密码 + 短信验证码 → 确定
- 商户平台出现「复制证书串」→ 点复制
- 把证书串粘回证书工具 → 下一步
- 点「查看证书文件夹」
拿到的东西:一个文件夹,里面 4 个文件 —— 证书(p12 格式)、证书(pem 格式)、 证书私钥(pem 格式)、说明文档。整个文件夹打包发我。
证书有效期 5 年,到期前我会提前提醒您更换。 一个商户号最多可以同时有 3 份有效证书,换证书不会中断支付。
第 4 步 · 证书序列号
路径:【账户中心】→【API安全】→【商户API证书】→ 点「管理证书」,页面上就能看到那串序列号。
如果页面上找不到也没关系 —— 我拿到证书文件后可以自己算出来。
第 5 步 · 微信支付公钥
路径:【账户中心】→【API安全】→【微信支付公钥】→ 点「申请公钥」
拿到两样东西:
- 一个
.pem公钥文件 - 一串公钥 ID(形如
PUB_KEY_ID_xxxxxxxx)
这个是微信官方推荐的新方案,没有过期时间,比老的"平台证书"省心。 而且它可以随时重新下载,不像密钥和私钥那样一次性。
第 6 步 · 关联 AppID
路径:【产品中心】→【AppID账号管理】→【我关联的AppID账号】→ 点「关联」
- 需要有一个已认证的公众号 / 小程序 / 移动应用
- 要填写主体信息并签署授权协议
- 一个商户号最多可以关联 50 个
微信支付的交易发起依赖 AppID 与商户号的绑定关系 —— 没绑定,下单会直接报错。 顺带确认一下:【产品中心】里的「Native 支付」是否已开通(部分产品需要单独申请)。
四、怎么把东西交给我(请注意安全)
这 6 样里,第 2 项和第 3 项是最高敏感级别的:拿到它们等于能操作您的收款账户。
请不要:
- ❌ 发在微信群里(群成员都能看到,且聊天记录会长期留存)
- ❌ 用普通邮件明文发送
- ❌ 存到公共网盘后把链接和密码一起发
建议这样做:
- ✅ 证书压缩包加密码后再发,密码另走一个渠道(比如电话口述)
- ✅ APIv3 密钥口头告知,或分两条消息发(前半段 + 后半段)
- ✅ 交付后把本地临时文件删掉,不要留在下载目录
这些凭证我会加密保管,不会写进代码、不会上传到任何代码仓库。
五、预计耗时
| 步骤 | 预计 |
|---|---|
| 第 0、1 步 | 3 分钟 |
| 第 2 步(APIv3 密钥) | 5 分钟 |
| 第 3 步(API 证书) | 15 分钟(含下载安装证书工具) |
| 第 4、5 步 | 5 分钟 |
| 第 6 步(关联 AppID) | 2 分钟 |
| 合计 | 约 30 分钟 |
六、如果卡住了
| 现象 | 原因 | 怎么办 |
|---|---|---|
| 找不到某个菜单 | 商户平台改版,菜单位置变了 | 截图发我,我帮您定位 |
| 收不到短信验证码 | 超管手机号变更 / 运营商拦截 | 在【账户中心】核对预留手机号 |
| 证书工具装不上 | 系统安全策略拦截 | 换一台电脑,或告诉我系统版本 |
| 提示"证书数量已达上限" | 已有 3 份有效证书 | 作废一份旧的再申请 |
| 审核/开通类提示 | 部分产品需微信侧审核 | 截图发我,一起判断 |
任何一步不确定,先问我,不要自己试 —— 尤其是第 2 步和第 3 步,试错成本很高。
本文档通过加密链接交付,访问行为有记录。请勿转发给无关人员。