微信支付配置指南
微信支付是中国最流行的支付方式,支持扫码支付、公众号支付、小程序支付等多种支付场景。
准备工作
注册微信商户平台
访问微信支付商户平台 (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。