微信支付配置指南

微信支付支持扫码支付、公众号支付、小程序支付等场景,适合主要面向国内用户的店铺。

准备工作

注册微信商户平台

访问微信支付商户平台 (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 格式,三处最容易出错。