JSAPI调起用户确认收款
更新时间：2025.12.24||
商家转账用户确认模式下，在微信客户端通过小程序或H5拉起页面请求用户确认收款。
接口说明
| WeixinJSBridge内置对象在其他浏览器中无效。 商户需参考下方对应的调用示例，用接口判断微信客户端版本、小程序基础库版本是否支持requestMerchantTransfer 方法，如不支持，需做好兼容性处理
|
|
接口定义
名称：requestMerchantTransfer
请求参数
mchId 必填 string(32)
【商户号】商户号，由微信支付生成并下发，和发起转账传入的mchid必须是同一个
subMchId 必填 string(32)
【子商户号】子商户号，由微信支付生成并下发，和发起转账传入的sub_mchid必须是同一个
appId 必填 string(32)
【商户AppID】商户绑定的AppID（企业号corpid即为此AppID），由微信生成，和发起转账传入的appid必须是同一个
package 必填 string(1024)
【package信息】对应发起转账接口应答参数中的 package_info（仅当转账单据状态为WAIT_USER_CONFIRM: 待收款用户确认时才返回），用于唤起用户确认收款页面。
subAppId 选填 string(1024)
【子商户AppID】微信开放平台审核通过的移动应用appid，如发起转账传入sub_appid，则需要传入，必须与发起转账时传入的值是同一个。
调用示例
小程序示例
1if (wx.canIUse('requestMerchantTransfer')) {
2 wx.requestMerchantTransfer({
3 mchId: '1230000000',
4 subMchId : '1230000001',
5 appId: wx.getAccountInfoSync().miniProgram.appId,
6 subAppId: 'wx8888888888888889',
7 package: 'affffddafdfafddffda==',
8 success: (res) => {
9
10 console.log('success:', res);
11 },
12 fail: (res) => {
13 console.log('fail:', res);
14 },
15 });
16} else {
17 wx.showModal({
18 content: '你的微信版本过低，请更新至最新版本。',
19 showCancel: false,
20 });
21}
22H5示例
1wx.config({
2
3});
4wx.ready(function () {
5 wx.checkJsApi({
6 jsApiList: ['requestMerchantTransfer'],
7 success: function (res) {
8 if (res.checkResult['requestMerchantTransfer']) {
9 WeixinJSBridge.invoke('requestMerchantTransfer', {
10 mchId: '1230000000',
11 subMchId : '1230000001',
12 appId: 'wx8888888888888888',
13 subAppId: 'wx8888888888888889',
14 package: 'affffddafdfafddffda==',
15 },
16 function (res) {
17 if (res.err_msg === 'requestMerchantTransfer:ok') {
18
19 }
20 }
21 );
22 } else {
23 alert('你的微信版本过低，请更新至最新版本。');
24 }
25 }
26 });
27});
28返回结果值说明
|
requestMerchantTransfer:ok | 展示页面成功 |
requestMerchantTransfer:fail | 展示页面失败 |
requestMerchantTransfer:cancel | 用户取消。发生场景：用户未确认收款，点击取消，返回APP |
