微信支付配置指南

微信支付是中国最流行的支付方式,支持扫码支付、公众号支付、小程序支付等多种支付场景。

准备工作

注册微信商户平台

访问微信支付商户平台 (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。