打开微信支付设置
使用能保存瓜奇设置的后台账号,进入「支付」→「微信支付」,打开「启用此支付方式」。填写展示信息,并选择业务需要的「支持的货币」。
「支付渠道」当前支持官方微信支付、虎皮椒和易支付。先确定使用哪一家服务,再准备对应凭据。
填写官方微信支付参数
使用官方渠道前,先确认应用与商户的关联关系,以及所需支付产品是否可用。当前代码读取 API v2 参数,相关说明见微信支付 API v2 配置。
| 字段 | 填写内容 |
|---|---|
| App ID | 参与本次支付的微信应用 AppID,不是商户号。 |
| 商户号 | 与该应用配套使用的微信支付商户号。 |
| API密钥 | 该商户的 API v2 密钥,不是 API v3 密钥或证书内容。 |
将「支付渠道」设为「官方微信支付」,再填入这三项。不要照搬 API v3 接入教程中的密钥和证书字段。
需要在微信内付款时
官方 JSAPI 支付会检查支付设置的 App ID 是否与公众号配置的 App ID 一致。不一致时会返回 GQ_WECHAT_CONFIG_INVALID,应先修正这两处配置。
付款还需要当前用户的 OpenID,用来识别微信用户。缺少 OpenID 时,系统会先进入授权流程;这一步不会直接创建支付订单。完成授权后,还要继续付款并确认订单结果。
使用虎皮椒或易支付时
选择「虎皮椒」后,填写其支付网关、APPID 和 SECRET。默认网关为 https://api.xunhupay.com/payment/do.html。这些资料来自虎皮椒,不能用官方微信支付的商户号和 API 密钥替代。
选择「易支付」后,使用「易支付商户」中的共用商户资料。「易支付支持微信内付款」仅在所用平台确实支持微信内收银台时开启,不能仅靠打开开关获得该能力。
选择支付形式并检查通知地址
「前台支付形式」可选跳转收银台或扫码。接口返回二维码时可选「扫码」;返回网页收银台时使用「跳转收银台」。微信内、手机普通浏览器和电脑浏览器应分别测试。
官方渠道的异步通知地址根据目标前端自动生成,路径为 /api/callback?gqPayment=wechatpay。它用于接收支付平台发送的结果通知,不是买家阅读的页面,不要添加文章语言前缀。
保存并验证
- 保存设置,从目标前端打开购买项目,确认当前币种下能选择微信支付。
- 在实际支持的浏览器中发起付款,检查二维码、网页收银台或微信付款流程是否正常。
- 在微信内测试官方付款时,检查授权能否完成;如提示 App ID 配置错误,先核对支付与公众号配置。
- 付款后核对订单状态,再检查买家应获得的商品、内容或权益。
渠道启用后仍不显示,需检查支持币种、游客购买条件和浏览器限制。授权完成、付款完成、业务交付是不同步骤,不能只验证其中一步。
本地浏览器能访问网站,不代表微信支付服务器能访问通知地址。若通知入口仅本机可达,完整支付结果仍无法验证。