← 全部文章

微信支付接入 · 需要您配合的 6 项

6 项凭证 · 约 30 分钟 · 两项只能拿一次

微信支付接入 · 需要您配合的 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密钥】→ 点「设置」

  1. 弹窗提示"请确认已和技术人员沟通"→ 点「已沟通
  2. 输入 32 位密钥 → 点「确定」
  3. 安全验证:输入操作密码 + 短信验证码 → 确定
  4. 点「完成」

⚠️ 设置成功后平台不再显示,只能重新设置。

推荐做法我已经生成好一个 32 位密钥了,您直接拿去粘贴设置即可 —— 这样一次成功,不用"先随便设一个、发现看不到、再重设"。密钥我会单独发您。

用途:解密微信支付回调过来的通知数据。无过期时间。

第 3 步 · 商户 API 证书 ⚠️ 私钥丢了不可找回

路径:【账户中心】→【API安全】→【商户API证书】→ 点「申请证书」

这一步需要在您自己的电脑上完成(要装一个小工具),是「平台 ↔ 工具」来回粘贴的过程:

  1. 点「申请证书」→ 弹窗里点「下载证书工具
  2. 复制弹窗里的商户号商户名称(待会要粘进工具)
  3. 安装并打开证书工具 → 选好证书存放位置 → 点「申请证书」
  4. 把商户号 + 商户名称粘进工具 → 下一步
  5. 工具里点「复制证书请求串
  6. 把请求串粘回商户平台的输入框 → 下一步
  7. 安全验证:操作密码 + 短信验证码 → 确定
  8. 商户平台出现「复制证书串」→ 点复制
  9. 把证书串粘回证书工具 → 下一步
  10. 点「查看证书文件夹

拿到的东西:一个文件夹,里面 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 步,试错成本很高。


本文档通过加密链接交付,访问行为有记录。请勿转发给无关人员。