微信支付-支付基础配置
微信支付配置指南
TDuckX 商品支付及红包功能基于微信支付实现，使用前请先完成微信支付商户号申请及相关配置。
使用前准备
请确保已完成以下准备工作：
- 已申请微信支付商户号
- 已认证微信公众号（服务号）
- 服务号与商户号已完成关联绑定
微信支付必须关联服务号后才能正常发起支付。
⚠️ 微信支付场景配置说明
TDuckX 根据用户访问环境使用不同的微信支付方式，请根据实际使用场景完成对应配置：
1. 微信内支付
用户通过微信打开表单并进行支付时，使用 JSAPI 支付。由于 JSAPI 支付需要获取当前微信用户的 OpenID，因此必须在微信公众号后台配置 网页授权域名。
配置路径：微信公众平台 → 设置与开发 → 公众号设置 → 功能设置 → 网页授权域名
同时，还需要在微信支付商户平台配置 JSAPI 支付授权目录。
2. 微信外浏览器支付
用户通过 Safari、Chrome 等微信外部浏览器打开表单并支付时，使用 H5 支付（MWEB），需要在微信支付商户平台配置 H5 支付域名。
配置路径：微信支付商户平台 → 产品中心 → 开发配置 → H5支付
3. PC 浏览器支付
PC 浏览器通常使用 Native 扫码支付，用户通过微信扫描支付二维码完成付款。
注意
网页授权域名、JSAPI 支付授权目录、H5 支付域名属于不同配置项，不能相互替代。
如果出现“微信内无法支付”或无法获取用户身份的问题，请重点检查网页授权域名和 JSAPI 支付授权目录；如果出现“微信外浏览器无法拉起支付”，请重点检查 H5 支付域名。
开始配置
进入：系统配置 → 微信支付
基础收款配置
服务号系统AppID
填写已认证服务号的 AppID。
获取路径：微信公众平台 → 设置 → 基本设置
请注意：服务号需与商户号完成关联绑定。登录微信支付后台，产品中心，找到AppID账号管理，将服务号和微信商户号进行关联。
微信支付商户号（MCH ID）
填写微信支付商户号。获取路径：微信支付商户平台 → 账户中心
商户密钥 (API Key)
填写微信支付 API 密钥（V2）。
获取路径：微信支付商户平台 → 账户中心 → API安全 → API密钥
注意：
- 微信官方不会保存密钥明文
- 如遗失需重新设置
- 修改后需同步更新 TDuckX 配置
支付回调地址
填写格式：https://你的域名/tduck-api/form/ext/goods/pay/notify
示例：https://example.com/tduck-api/form/ext/goods/pay/notify
⚠️要求：必须使用 HTTPS，并且服务器需具备公网访问能力
公众号网页授权域名配置
请注意：完成此项配置之前，请确保已经在表单系统后台-系统配置-公众号配置 完成服务号的参数配置，且生效！
在微信中调用微信支付需要获取用户OpenID，此时需要配置已认证服务号。在服务号中-账号设置-功能设置，网页授权域名，配置您系统访问的域名。完成后才能拉起微信支付
公众号 IP 白名单配置
微信内支付过程中，TDuckX 服务端需要调用微信公众
号接口获取 JSAPI 相关信息，因此需要将 TDuckX 服务端的公网出口 IP 加入微信公众号 IP 白名单。
配置路径：
微信公众平台 → 设置与开发 → 基本设置 → IP白名单
将 TDuckX 服务端实际访问微信接口时使用的公网出口 IP 添加到白名单。
H5支付配置（按需）
如果您的业务场景存在需要在第三方浏览器中调用微信支付，则需要进行H5支付配置。
请在微信支付后台-产品中心-H5支付开通此产品。
然后在开配置填写H5支付域名
