鸿蒙

更新时间：2026.04.14

简介

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

接入前注意事项

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

商户需先通过发起转账接口申请创建转账单，获取到跳转领取页面的package信息后，商户APP再通过微信Open SDK（详见鸿蒙接入指南）的sendReq方法拉起用户确认收款页。

接口说明

支持商户：【普通商户】

接口名称：WXOpenBusinessView

需要引用新的openSDK：

HarmonyOS Next openSDK下载地址（版本>=1.0.5）：鸿蒙资源下载

HarmonyOS Next 接入文档链接：openSDK说明文档

接口兼容：

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

接口参数

HarmonyOS Next对应对象：OpenBusinessViewReq

请求参数

businessType 必填 string(16)

【业务类型】固定配置：requestMerchantTransfer

query 必填 string(2048)

【查询参数】使用URL的query string方式传递参数，格式为key=value&key2=value2，其中value、value2需要进行UrlEncode处理。

属性

调用示例

HarmonyOS Next示例

1import * as wxopensdk from '@tencent/wechat_open_sdk'; // 导入微信sdk包
2
3export const WXApi = wxopensdk.WXAPIFactory.createWXAPI(APP_ID); // APP_ID为移动应用appid，建议全局共享同一份WXApi实例
4
5// 发送请求
6async sendRequestMerchantTransfer() {
7    let req = new wxopensdk.OpenBusinessViewReq
8    req.businessType = "requestMerchantTransfer"; // 固定值
9    req.query = "mchId=1230000000&appId=wx8888888888888888&package=affffddafdfafddffda%3D%3D"; // 拼接参数
10    let finished = await WXApi.sendReq(getContext(this) as common.UIAbilityContext, req); // 发送请求给微信客户端，其中this为函数所在的组件
11}

返回参数

HarmonyOS Next对应对象：OpenBusinessViewResp

businessType 必填 string(16)

【业务类型】打开的业务类型。

extMsg 必填 string

【扩展信息】返回的业务数据，格式为JSON字符串，如 {"result":"success"}。具体内部字段如下

属性

result 　必填　string

【结果信息】

success：展示页面成功。

fail：展示页面失败。

cancel：用户取消。发生场景：用户未确认收款，点击取消，返回APP

返回示例

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

注意：

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

文档是否有帮助

LLM请查看llms.txt

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服