在公众号内做H5支付时，不少开发者遇到过这样一个报错：调用统一下单接口时返回"当前商户号未开通JSAPI支付且未签署协议"，或者前端调起WeixinJSBridge支付时直接失败。这个错误的本质并不是代码写错了，而是商户号在微信支付侧的资质配置没有完成。本文将围绕这个报错，从原因分析、商户平台配置、代码侧校验三个层面给出完整的排查方案。
一、报错原因分析：为什么提示未开通JSAPI支付
首先需要明确一个概念：微信商户号（mch_id）默认开通的支付产品是有限的。一个新申请的商户号，通常会自动开通公众号支付或小程序支付中的一种，其余支付产品如H5支付、Native支付、APP支付都需要在商户平台手动申请。而JSAPI支付对应的就是“公众号支付”或“小程序支付”场景，如果商户号在申请时选择的是其他经营类目或产品，就会出现这个报错。
该错误常见于以下几种场景：
- 商户号刚申请下来，只开通了Native扫码支付，直接拿来调JSAPI统一下单接口；
- 商户号开通了公众号支付，但登录商户平台后发现《微信支付服务协议》没有完成签署，产品处于“待签约”状态；
- 商户号的经营类目与JSAPI支付不匹配，被平台限制了产品权限；
- 调用的appid与商户号没有完成绑定关系，微信侧校验不到授权记录。
特别要注意最后一点，很多人误以为只要appid和mch_id都是自己的就能用，实际上微信支付要求调用统一下单接口时传入的appid必须在商户平台的“AppID账号管理”中完成授权绑定，否则即使产品权限开通了，也会返回类似的权限错误。
二、商户平台侧的完整配置步骤
1. 开通JSAPI支付产品权限
登录微信商户平台（pay.weixin.qq.com），进入“产品中心”，在产品列表中找到“JSAPI支付”或“公众号支付”，点击“开通”。开通时平台会要求确认经营场景和类目信息，如果类目不符合要求，需要先在“账户中心-商户信息”中调整类目。开通申请一般是即时生效的，部分特殊类目需要平台审核1至3个工作日。
2. 签署支付服务协议
这是最容易被忽略的一步。开通产品权限后，如果协议状态显示“未签署”，产品依然无法使用。在产品详情页会有“签署协议”入口，点击后由超级管理员扫码确认即可。如果找不到入口，可以进入“账户中心-协议管理”查看所有待签署的协议列表。签署完成后，产品状态会变为“已开通”，此时再调用接口就不会报协议错误了。
3. 绑定AppID并配置支付授权目录
进入“产品中心-JSAPI支付-开发配置”，这里有两个关键配置：
- 支付授权目录：调起支付页面的URL必须在授权目录下。例如支付页面地址是
https://www.ipipp.com/pay/checkout，那么授权目录要配置为https://www.ipipp.com/pay/，注意必须以斜杠结尾，且域名需要完成ICP备案并与公众号业务域名一致。 - 授权AppID：将发起支付的公众号appid绑定到商户号，绑定后需在公众号后台确认授权。
支付授权目录的校验是精确到目录级别的，前端调起支付的页面URL如果不在授权目录内，会报“当前页面的URL未注册”错误，这与商户号未签约是两个不同的错误，排查时要注意区分。
三、代码侧的校验与正确调用方式
商户平台配置完成后，还需要确认代码层的参数一致性。JSAPI支付的核心链路是：后端调用统一下单接口获取prepay_id，前端用该prepay_id调起微信支付。下面是一段后端组装统一下单参数的示例（以PHP为例）：
// 统一下单关键参数
$params = [
'appid' => 'wx1234567890abcdef', // 必须与商户号绑定的appid一致
'mch_id' => '1600000000', // 商户号
'trade_type' => 'JSAPI', // 交易类型固定为JSAPI
'openid' => $user_openid, // 必须是该appid下获取的openid
'body' => '商品描述',
'out_trade_no' => 'order20240101001', // 商户订单号
'total_fee' => 100, // 单位为分
'notify_url' => 'https://www.ipipp.com/notify/wechat',
'spbill_create_ip' => $_SERVER['REMOTE_ADDR'],
'nonce_str' => md5(time()),
];
// 签名后通过HTTPS XML请求 https://api.mch.weixin.qq.com/pay/unifiedorder
这里有三个高频踩坑点需要重点说明。第一，openid与appid必须配对：openid是用户在某一个appid下的唯一标识，如果用A公众号的openid配合B公众号的appid下单，会报“openid和appid不匹配”，这类错误经常出现在多个公众号共用一个商户号的场景。第二，trade_type必须写JSAPI而不是其他值，写错会直接触发产品权限校验失败。第三，前端调起支付时的签名参数要与后端返回的保持一致。
前端调起支付的示例代码如下：
function onBridgeReady(payParams) {
WeixinJSBridge.invoke('getBrandWCPayRequest', {
"appId": payParams.appId, // 公众号appid
"timeStamp": payParams.timeStamp,
"nonceStr": payParams.nonceStr,
"package": payParams.package, // prepay_id=xxx
"signType": payParams.signType, // RSA时为RSA，V2为MD5或HMAC-SHA256
"paySign": payParams.paySign
}, function (res) {
if (res.err_msg == "get_brand_wcpay_request:ok") {
// 支付成功，建议以后端通知结果为准
} else if (res.err_msg == "get_brand_wcpay_request:cancel") {
// 用户取消支付
} else {
// 支付失败，输出res.err_msg辅助排查
}
});
}
四、排查清单与常见误区
按照实际排查经验，建议按照以下顺序逐项确认，可以覆盖绝大多数场景：
| 检查项 | 确认要点 | 错误表现 |
|---|---|---|
| JSAPI产品权限 | 产品中心显示已开通 | 未开通JSAPI支付且未签署协议 |
| 协议签署状态 | 协议管理中无待签署项 | 同上报错 |
| AppID绑定关系 | 商户平台与公众号双向确认 | appid与mch_id不匹配 |
| 支付授权目录 | 精确匹配且以斜杠结尾 | 当前页面的URL未注册 |
| openid与appid配对 | 同一主体下获取 | openid与appid不匹配 |
还有一个常见误区是：商户平台显示JSAPI已开通，但仍然报未签署协议。这种情况通常是因为API版本的问题，部分老商户号使用V2接口正常，而V3接口需要单独完成API安全相关的证书和密钥配置。排查时可以先用商户平台的“在线接口调试”工具发起一次统一下单请求，绕过自有代码验证商户号状态，这样可以快速区分是商户配置问题还是代码问题。
总结来说，“商户号未开通JSAPI支付且未签署协议”这个报错九成以上出在商户平台配置环节，核心是三件事：开通产品、签署协议、绑定appid并配置授权目录。代码层面只需保证trade_type、openid与appid的配对关系正确，支付链路即可正常走通。