瓜奇
瓜奇

暂无菜单项

首页/文档/商品与交易/支付接入/
打开 MD 链接

配置微信支付接入

二丿小青年
二丿小青年
发布于 9/11更新于 10/13
50

06 商品与交易 / 06.02 支付接入

打开微信支付设置

使用能保存瓜奇设置的后台账号,进入「支付」→「微信支付」,打开「启用此支付方式」。填写展示信息,并选择业务需要的「支持的货币」。

「支付渠道」当前支持官方微信支付、虎皮椒和易支付。先确定使用哪一家服务,再准备对应凭据。

填写官方微信支付参数

使用官方渠道前,先确认应用与商户的关联关系,以及所需支付产品是否可用。当前代码读取 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。它用于接收支付平台发送的结果通知,不是买家阅读的页面,不要添加文章语言前缀。

保存并验证

  1. 保存设置,从目标前端打开购买项目,确认当前币种下能选择微信支付。
  2. 在实际支持的浏览器中发起付款,检查二维码、网页收银台或微信付款流程是否正常。
  3. 在微信内测试官方付款时,检查授权能否完成;如提示 App ID 配置错误,先核对支付与公众号配置。
  4. 付款后核对订单状态,再检查买家应获得的商品、内容或权益。

渠道启用后仍不显示,需检查支持币种、游客购买条件和浏览器限制。授权完成、付款完成、业务交付是不同步骤,不能只验证其中一步。

本地浏览器能访问网站,不代表微信支付服务器能访问通知地址。若通知入口仅本机可达,完整支付结果仍无法验证。

上一篇
配置支付宝接入使用能保存瓜奇设置的后台账号,进入「支付」→「支付宝」,打开「启用此支付方式」。填写前台展示信息,并在「支持的…
下一篇
配置PayPal接入瓜奇使用 PayPal REST 应用收款。先准备相应环境的 Client ID、Secret,以及接收支付通…
0 / 600
细中粗
0 讨论
热门最新
总结
暂无总结
瓜奇
瓜奇
首页
产品中心优惠
扩展中心
模板中心
小店
AI导航
社区演示
文档中心
构建器夯
所有的成功,都源自一个勇敢的开始
不辜负每一个勇敢的开始
关于帮助文档FAQ协议
瓜奇 © 2026