微信支付

微信支付 V3 API Native 和 JSAPI 配置指南

微信支付使用 V3 API,支持 Native(扫码)和 JSAPI(公众号/小程序内)两种渠道。

注册商户号:在 微信支付商户平台 注册并通过审核,获取商户号(mchId)

获取 API 密钥:在商户平台的 API 安全中生成 APIv3 密钥,并下载商户私钥证书

配置环境变量

WECHAT_PAY_APP_ID=wx1234567890         # 公众号/小程序 AppID
WECHAT_PAY_MCH_ID=1234567890           # 商户号
WECHAT_PAY_SERIAL_NO=XXXXXXXXXX        # 证书序列号
WECHAT_PAY_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n..."  # 商户私钥
WECHAT_PAY_API_V3_KEY=your-api-v3-key  # API v3 密钥
WECHAT_PAY_NOTIFY_URL=https://your-domain.com/api/webhooks/wechat-pay

支付渠道说明

Native 支付:生成二维码图片,用户扫码完成支付。适合 PC 网站场景。

JSAPI 支付:在微信公众号或小程序内直接调起支付。需要获取用户的 openid。适合微信生态内的 H5 页面。

微信支付私钥是敏感文件。建议通过环境变量注入,不要将 .pem 文件放在项目目录中。

常见问题

相关资源