微信支付配置指南
微信支付支持扫码支付、公众号支付、小程序支付等场景,适合主要面向国内用户的店铺。
准备工作
注册微信商户平台
访问微信支付商户平台 (pay.weixin.qq.com),注册并完成企业认证,记录商户号(mch_id)。
获取 AppID
登录微信公众平台或微信开放平台,在【开发】->【基本配置】中获取 AppID。
设置 APIv3 密钥
在商户平台【账户中心】->【API安全】中设置一组 32 位 APIv3 密钥。
申请商户 API 证书
用微信证书工具生成证书,保留 apiclient_key.pem 私钥文件和证书序列号。
配置步骤
1
步骤一:进入支付平台管理
在管理后台,进入【系统设置】->【支付平台管理】,找到微信支付配置项。
2
步骤二:填写基本信息
填入 AppID、商户号和证书序列号。
3
步骤三:上传证书文件
粘贴 apiclient_key.pem 私钥内容,或上传对应证书文件。
4
步骤四:配置回调地址
支付回调地址填写:https://yourdomain.com/api/v1/webhook/recharge/notify/wechat
5
步骤五:保存并测试
保存后,用小额订单走一遍支付和回调。
注意事项
- 回调地址要使用 HTTPS
- 私钥和证书不要发给无关人员
- APIv3 密钥固定 32 位,建议随机生成
- 上线前在商户平台加入回调地址白名单
常见问题
证书序列号在哪里查看?
可以用 OpenSSL 查看:openssl x509 -in apiclient_cert.pem -noout -serial,也可以到商户平台 API 安全页面查看。
支付回调失败怎么办?
先看回调地址是否为 HTTPS,再确认公网能访问,防火墙也没有拦截。
签名验证失败怎么解决?
核对 APIv3 密钥、私钥文件路径和 PEM 格式,三处最容易出错。