配置微信支付需要的信息

原创于 2025-12-06 18:32:39 发布 · 675 阅读

CC 4.0 BY-SA版权

文章标签：

WECHAT_APP_ID=
WECHAT_MCH_ID=
WECHAT_API_KEY=xxxxx
WECHAT_CERT_PATH=/app/certs/apiclient_cert.pem
WECHAT_KEY_PATH=/app/certs/apiclient_key.pem
WECHAT_SANDBOX=false

WECHAT_APP_ID 是什么？

AppID / 公众号ID / 小程序ID / 应用ID
• 这是你在微信开放平台或公众平台上创建的应用本身的唯一标识。
• 可能是：
• 公众号的 AppID（服务号/订阅号）
• 小程序的 AppID
• H5/APP 使用的某个关联 AppID
• 作用：
• 标识“是谁在发起支付”，对应你这个业务应用。
• 在 JSAPI、H5、App 支付等场景里，微信要知道用户是给哪个“应用”付款。

一般在「微信公众平台」或「微信开放平台」后台可以看到：
AppID（小程序ID/公众号ID） = wx 开头的一长串字符。

⸻

WECHAT_MCH_ID 是什么？

商户号（MchID）
• 这是你在「微信支付商户平台」开通微信支付后，由微信支付分配的商户号。
• 形式通常是：10位左右纯数字，例如 190000**** 之类。
• 作用：
• 标识“哪个公司在收款”，跟银行账户、结算、账单全部关联。
• 支付请求里，都是通过这个商户号来确认资金归属。

商户平台登录地址一般是 pay.weixin.qq.com，登录后首页就能看到“商户号”。

⸻

WECHAT_API_KEY 是什么？

微信支付 API v3 密钥（不是证书，也不是 AppSecret）
• 这是在「微信支付商户平台 → 账户中心 → API安全 → APIv3 密钥」里由你自己设置的一串 32 位字符串。
• 用途：
• 签名 & 验签：你调用微信支付 V3 接口时，用它对请求内容签名；微信回调给你的通知，你也用它来验证是否被篡改。
• 加解密敏感数据：部分接口返回的敏感字段会用这个密钥做加密。

注意：
• 这不是老版本的“API 密钥（API key V2）”，而是 V3 的。
• 必须妥善保管，绝对不能暴露在前端或日志中。

⸻

WECHAT_CERT_PATH 是什么？

商户 API 证书（apiclient_cert.pem）路径
• 这是你在商户平台申请并下载的“商户 API 证书” 里的公钥证书文件。
• 通常下载下来压缩包里有：
• apiclient_cert.pem ← 证书（公钥）
• apiclient_key.pem ← 私钥
• 有时还有一个 apiclient_cert.p12（旧版）。
• 作用：
• 在 V3 接口里，你发请求时会用对应私钥做签名，
• 某些双向 TLS 场景下会用证书进行 SSL 握手（看你用的 SDK/场景）。

在你的服务端容器里，这个文件被放到了 /app/certs/apiclient_cert.pem。

⸻

WECHAT_KEY_PATH 是什么？

商户 API 证书私钥（apiclient_key.pem）路径
• 对应上面证书的私钥文件。
• 这个文件和证书是一对，来自同一份证书申请。
• 作用：
• 服务器端在请求微信支付接口时，使用这个私钥对请求进行签名，
• 确保“确实是这个商户发出的请求”。

这个文件权限要严格控制，只能在服务器上、后端程序可读，不能泄露。

⸻

WECHAT_SANDBOX 是什么？

是否使用沙箱环境
• false：使用正式环境（真实支付、真实扣款）。
• true：使用沙箱环境（测试用，通常用官方提供的测试商户号和测试 Key，不走真实资金）。

不同 SDK 会根据这个变量来决定调用的域名是：
• 正式环境：https://api.mch.weixin.qq.com / https://api.mch.weixin.qq.com/v3/…
• 沙箱环境：沙箱专用的接口域名或带 /sandboxnew/ 的路径。

⸻

简单对照表

配置项中文含义从哪里拿主要作用
WECHAT_APP_ID 应用的 AppID（公众号/小程序）微信公众平台/开放平台标识发起支付的应用
WECHAT_MCH_ID 商户号微信支付商户平台标识收款的商户身份
WECHAT_API_KEY API v3 密钥商户平台 API 安全设置请求签名、回调验签、加解密
WECHAT_CERT_PATH 商户 API 证书（公钥）路径证书下载后放到服务器双向 TLS、配合私钥使用
WECHAT_KEY_PATH 商户 API 证书私钥路径证书下载后放到服务器请求签名的私钥
WECHAT_SANDBOX 是否使用沙箱环境自己配置决定用测试环境还是正式环境