---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4020320137.md"
title: "鸿蒙"
doc_id: 4020320137
---

>更新时间：2026.05.08

## 简介

商家转账用户授权免确认收款模式下，商户通过在移动端应用APP中集成开放SDK调起微信请求用户授权免确认收款。

## 接入前注意事项

在接入前需详细阅读下方说明：

商户需先通过[发起免确认收款授权](https://pay.weixin.qq.com/doc/v3/merchant/4015901167.md)接口申请免确认收款授权，获取到跳转页面的package信息后，商户APP再通过微信[Open SDK](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/WeChat_Pay/Vendor_Service_Center.html)（详见[鸿蒙](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/ohos.html)接入指南）的sendReq方法拉起用户免确认收款授权页面。

## 接口说明

支持商户：【普通商户】

接口名称：WXOpenBusinessView

需要引用新的openSDK：

HarmonyOS Next openSDK下载地址（版本>=1.0.5）：[鸿蒙资源下载](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Downloads/HarmonyOS_Resource.html)

HarmonyOS Next 接入文档链接：[openSDK说明文档](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/ohos.html)

接口兼容：

HarmonyOS Next兼容性表现：若微信版本>=8.0.11.34，开发者可以通过此openSDK接口调起用户免确认收款授权页面；若微信版本< 8.0.11.34，开发者通过此openSDK接口不能跳转到微信或跳转微信后无法拉起用户免确认收款授权页面，此时开发者应在拉起微信前提示用户更新微信版本。

## 接口参数

HarmonyOS Next对应对象：OpenBusinessViewReq

## 请求参数

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| businessType | string(16) | true | 【业务类型】固定配置：requestMerchantTransfer |
| query | string(2048) | true | 【查询参数】使用URL的query string方式传递参数，格式为key=value&key2=value2，其中value、value2需要进行UrlEncode处理。 |
| query.mchId | string(32) | true | 【商户号】商户号，由微信支付生成并下发，和发起转账传入的mchid必须是同一个 |
| query.appId | string(32) | true | 【商户AppID】微信开放平台审核通过的移动应用appid，和发起转账传入的appid必须是同一个 |
| query.package | string(1024) | true | 【package信息】对应[发起免确认收款授权](https://pay.weixin.qq.com/doc/v3/merchant/4015901167.md)接口应答参数中的package\_info（仅当单据状态为WAIT\_USER\_CONFIRM: 待收款用户确认时才返回），用于唤起用户免确认收款授权页面。 |

调用示例

HarmonyOS Next示例

```
import * as wxopensdk from '@tencent/wechat_open_sdk'; // 导入微信sdk包

export const WXApi = wxopensdk.WXAPIFactory.createWXAPI(APP_ID); // APP_ID为移动应用appid，建议全局共享同一份WXApi实例

// 发送请求
async sendRequestMerchantTransfer() {
    let req = new wxopensdk.OpenBusinessViewReq
    req.businessType = "requestMerchantTransfer"; // 固定值
    req.query = "mchId=1230000000&appId=wx8888888888888888&package=0002-affffddafdfafddffda%3D%3D"; // 拼接参数
    let finished = await WXApi.sendReq(getContext(this) as common.UIAbilityContext, req); // 发送请求给微信客户端，其中this为函数所在的组件
}
```
## 返回参数

HarmonyOS Next对应对象：OpenBusinessViewResp

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| businessType | string(16) | true | 【业务类型】打开的业务类型。 |
| extMsg | string | true | 【扩展信息】返回的业务数据，格式为JSON字符串，如 `{"result":"success"}`。具体内部字段如下 |
| extMsg.result | string | true | 【结果信息】<br>`success`：展示页面成功。<br>`fail`：展示页面失败。<br>`cancel`：用户取消。发生场景：用户未确认授权，点击取消，返回APP |

返回示例

```
// 响应微信的回调
// 注册方式见https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Access_Guide/ohos.html 4. 在代码中使用开发工具包
onResp(resp: wxopensdk.BaseResp): void {
	if (resp instanceof wxopensdk.OpenBusinessViewResp) {
		if ("requestMerchantTransfer" === resp.businessType) {
			// 处理结果
  		}
 	}
}
```

注意：

带有返回结果信息不代表订单确认成功，具体状态需以接口查询的结果为准。
