微信支付API证书导出就在商户平台API安全,这句话我基本当口诀在用。先把结论摆出来:用管理员账号登录商户平台,左侧「账户中心」往下拉,那一项「API安全」就是入口,证书申请、证书管理、APIv2密钥、APIv3密钥全堆在这一页上。翻遍整个后台都找不到的,先别怀疑浏览器,八成是登录的号权限不够。

微信支付API证书导出就在商户平台API安全,入口在账户中心下一层
新版后台路径就是「账户中心 → API安全」,老版后台那一栏叫「API证书」,位置差不多,名字改过而已。点进去能看到几块内容并排放着:API证书(申请证书、管理证书)、APIv2密钥、APIv3密钥。要看已经申请过的证书,点「管理证书」,列表里有证书序列号、申请时间,右边那个下载按钮点下去之前系统会弹验证——管理员扫码或者短信验证码,加上你当初设的操作密码,这一步谁也替不了你,别想着绕过去吧。
证书序列号顺手复制下来存好,后面验签、排查「商户号与证书不匹配」全靠它比对,来回翻后台找很烦的嘛。各版本页面上按钮的叫法略有出入,以你登录后实际看到的为准。
普通操作员账号,根本看不到这页菜单
我一般这么弄:先问一句,你登的哪个账号?商户平台账号就分管理员和操作员。操作员是管理员在员工账号里加的,权限得一项项勾。API安全这块牵扯私钥,默认只给管理员看。运营、财务的号拿去登?菜单就是不出现。找一下午也找不着呢。要么换管理员账号,要么让管理员把你这号的权限放开。但有些账号类型压根不给开这一项,说白了,以商户平台的权限说明为准。权限比路径更容易出错。
还有个情况,公司好几个商户号,测试号和生产号各一套,你从A号后台下的证书,配到B号的项目里,接口一调就报签名错。这种坑我踩过,翻日志翻了半天才发现是商户号对不上,跟代码一点关系都没有嘛。
压缩包解开,里面就那几个文件
下载下来是个 zip,解开一般能看到 apiclient_cert.pem(证书)、apiclient_key.pem(私钥),有的包里还有个 apiclient_cert.p12。p12 是给 V2 老接口用的,它的密码是商户号,不是你自己设的操作密码,这俩别搞混啊。想验证手里这个 p12 能不能用,敲一行就行:
openssl pkcs12 -in apiclient_cert.p12 -nodes -passin pass:你的商户号
能吐出一堆 PEM 开头的东西就对了,报 mac verify error 就是密码错了。apiclient_key.pem 是私钥啊,这东西等同于你商户的钱袋子,谁拿到谁就能以你的名义发请求,传群里、贴工单、扔进代码仓库,说白了都是给自己埋雷。私钥泄露只能重来。
落到服务器上,位置和权限比文件名重要
我见过把 pem 直接传到 /public 目录下的,图省事呗,结果路径能猜到就能直接下载,跟把钥匙插在门上没啥区别吧。正经做法是放到 web 根目录之外,比如 /data/wxpay/cert/ 这种地方,属主给跑 PHP 或者 Java 的那个用户,文件 600、目录 700。命令就两条:
chown www:www /data/wxpay/cert/apiclient_key.pem chmod 600 /data/wxpay/cert/apiclient_key.pem
改完 systemctl restart php-fpm 或者重启你自己的应用,别忘了。代码里的路径写成绝对路径,别写相对的——相对路径在 CLI 跑脚本时好好的,一切到 php-fpm 或者被 cron 拉起来,工作目录变了,文件找不到,报出来还是「证书无效」,能把你带沟里去啊。你会发现这类问题我一般先看配置文件里那行路径到底指向哪儿,再 ls 一下确认文件真在那儿、权限真读得到,两分钟的事。
V2 和 V3 用的不是一套证书
导出来只是第一步,接下来得搞清楚自己接的是哪套接口。V2 用 apiclient_cert.p12 加 APIv2 密钥,签名是 MD5 或者 HMAC-SHA256;V3 用 apiclient_key.pem 做 SHA256-RSA 签名,请求头要带证书序列号,回调还得用平台证书验签。两套东西混着配,最常见的表现就是签名错误,你怎么改密钥都不对呢,因为你改的是另一套的密钥。V3 的私钥和平台证书是两码事,一个签一个验,缺一个都跑不通。
报错原文比瞎猜有用
几个见得多的:curl: (58) problem with the local SSL certificate,基本是路径错、文件读不到,或者复制 pem 的时候把换行弄丢了;SIGN_ERROR 或者签名错误,多半密钥版本用错;提示证书序列号与商户号不匹配,就是下错号了。把日志里那行原文整段贴出来查,比在群里问「支付报错了怎么办」效率高得多,报错码本身就写着方向呢。非要猜的话,先猜权限和路径,再猜代码。
到期这事儿,别等接口停了才想起来
微信支付 API 证书有有效期的,页面上会显示到期时间;具体年限以商户平台说明为准。到期前重新申请一份,把服务器上的旧文件替掉,重启服务。然后拿一笔小额订单,把完整流程跑一遍:下单、支付、回调。三步都通了,再收工就好。只测下单、不测回调?等于没测。回调那步才用得上私钥和平台证书验签呢。很多人就是这儿漏的。
绕一圈说回来,导证书这动作本身三十秒的事,难的是知道自己该登哪个号、该拿哪套证书、该放哪个目录。三步:管理员登录、账户中心进 API 安全、下载后落到 web 目录外并给 600 权限。卡住了先翻日志原文,别急着换浏览器。
相关阅读
【版权声明】:本站内容若无意侵犯到您的权利,请及时与我们联系将尽快删除相关内容!
评论列表(1条)
[…] 微信支付API证书导出,入口就在商户平台API安全 […]