### [06.02.030 配置微信支付接入](https://guaqi.com/docs/77608)

**Published:** 2026-09-11T02:27:59

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 瓜奇官方微信支付当前读取 App ID、商户号和 API v2 密钥。不要按 API v…

[06 商品与交易](/docs-archive/1254) / [06.02 支付接入](/docs-archive/1256)

## 一、这个功能能做什么

瓜奇官方微信支付当前读取 App ID、商户号和 API v2 密钥。不要按 API v3 教程把 v3 密钥或证书内容填进同一字段。

### 对应参数

在商户平台确认商户号与应用关系，取得对应 API v2 密钥，在瓜奇官方微信支付配置中填写。API v2 密钥用于 v2 签名，官方 SDK 说明可见[微信支付 API v2 配置](https://github.com/wechatpay-apiv3/wechatpay-php/blob/main/README_APIv2.md)。

微信公众号内的 JSAPI 支付还会检查支付 App ID 与公众号配置 App ID 一致，并需要相应用户 OpenID。缺少身份时会进入授权流程，不能用商户号替代公众号身份。

### 先认识这几个词

-   **回调**：外部服务在处理后返回信息给网站的过程或入口，例如发送支付结果。
-   **前端**：访客实际打开和使用的网站；同一后台可以对应多个前端网址。
-   **Node**：运行瓜奇前端服务的程序环境；重启对应服务属于网站部署操作。

## 二、设置后会有什么效果

可以接入当前支持的微信支付渠道，并用于适用浏览器和微信内场景。官方配置使用 API v2 参数，不应混填另一套密钥。

## 三、怎么使用

### 支付形式

扫码选项适合接口实际返回二维码的场景；浏览器内支付、普通浏览器和手机环境需要分别验证。选择虎皮椒渠道时则填写虎皮椒网关、APPID 和 SECRET，不能混用官方参数。

### 回调与语言

当前异步通知使用目标前端 `/api/callback?gqPayment=wechatpay`。Node 再转交 WP 处理。不要给这个机器通知地址添加文章语言前缀。

付款前检查当前前端和币种，付款后检查订单归属及实际解锁。公众号授权、支付成功和业务交付是不同步骤。

## 四、常见问题

### 常见问法与直接答案

#### 微信支付填 v3 密钥吗？

本文对应当前官方微信支付接入的 API v2 参数，应填相应 AppID、商户号及 API v2 密钥。不要拿另一套 API v3 证书或密钥教程直接替代当前字段；公众号与支付相关 AppID 也要匹配。



---