---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012716430.md"
title: "JSAPI调起用户确认收款"
doc_id: 4012716430
---

>更新时间：2025.03.07

商家转账用户确认模式下，在微信客户端通过小程序或H5拉起页面请求用户确认收款。



## 接口说明

支持商户：【普通商户】

注意：

1. WeixinJSBridge内置对象在其他浏览器中无效。

2. 商户需参考下方对应的调用示例，用接口判断微信客户端版本、小程序基础库版本是否支持requestMerchantTransfer 方法，如不支持，需做好兼容性处理


## 接口定义

名称：requestMerchantTransfer

## 请求参数

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| mchId | string(32) | true | 【商户号】商户号，由微信支付生成并下发，和发起转账传入的mchid必须是同一个 |
| appId | string(32) | true | 【商户AppID】商户绑定的AppID（企业号corpid即为此AppID），由微信生成，和发起转账传入的appid必须是同一个 |
| package | string(1024) | true | 【package信息】对应 [发起转账](https://pay.weixin.qq.com/doc/v3/merchant/4012716434.md#%E5%BA%94%E7%AD%94%E5%8F%82%E6%95%B0) 接口应答参数中的 package\_info（仅当转账单据状态为WAIT\_USER\_CONFIRM: 待收款用户确认时才返回），用于唤起用户确认收款页面。 |

调用示例

小程序示例

```
if (wx.canIUse('requestMerchantTransfer')) {
  wx.requestMerchantTransfer({
    mchId: '1230000000',
    appId: wx.getAccountInfoSync().miniProgram.appId,
    package: 'affffddafdfafddffda==',
    success: (res) => {
      // res.err_msg将在页面展示成功后返回应用时返回ok，并不代表付款成功
      console.log('success:', res);
    },
    fail: (res) => {
      console.log('fail:', res);
    },
  });
} else {
  wx.showModal({
    content: '你的微信版本过低，请更新至最新版本。',
    showCancel: false,
  });
}

```

H5示例

```
wx.config({
  // 参考：https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html
});
wx.ready(function () {
  wx.checkJsApi({
    jsApiList: ['requestMerchantTransfer'],
    success: function (res) {
      if (res.checkResult['requestMerchantTransfer']) {
        WeixinJSBridge.invoke('requestMerchantTransfer', {
            mchId: '1230000000',
            appId: 'wx8888888888888888',
            package: 'affffddafdfafddffda==',
          },
          function (res) {
            if (res.err_msg === 'requestMerchantTransfer:ok') {
              // res.err_msg将在页面展示成功后返回应用时返回success，并不代表付款成功
            }
          }
        );
      } else {
        alert('你的微信版本过低，请更新至最新版本。');
      }
    }
  });
});

```

## 返回结果值说明

| 描述 | 解决方案 |
| --- | --- |
| requestMerchantTransfer:ok | 展示页面成功 |
| requestMerchantTransfer:fail | 展示页面失败 |
| requestMerchantTransfer:cancel | 用户取消。发生场景：用户未确认收款，点击取消，返回APP |