小程序调起充值到商户账户
更新时间：2026.07.17||
提示：本功能目前处于灰度测试阶段、暂未开放使用，待全量开放后将通过文档门户公告同步，感谢您的理解。 商户通过申请二级商户充值接口获取充值的必要参数package_info后，可使用微信支付提供的小程序方法调起微信充值到商户账户页面，引导用户充值到指定商户账户。
接口说明
接口名称: wx.openBusinessView
| 兼容性表现说明 小程序版本库 >= 2.6.0，低版本需提示用户升级微信版本。 iOS兼容性表现：若微信版本>=8.0.51，开发者可以通过此微信小程序接口跳转到微信充值到商户账户页面；若微信版本< 8.0.51，开发者将无法通过此微信小程序接口跳转到微信充值到商户账户页面。 Android兼容性表现：同iOS。 鸿蒙兼容性表现：若微信版本>=8.0.17.33，开发者可以通过此微信小程序接口跳转到微信充值到商户账户页面；若微信版本< 8.0.17.33，开发者将无法通过此微信小程序接口跳转到微信充值到商户账户页面。
|
|
字段说明
请求参数
businessType 必填 string(32)
固定值，请传入liteAppMerchantRecharge
queryString 必填 string(2048)
使用URL的query string方式传递参数，格式为key=value&key2=value2，其中value，value2需要进行UrlEncode处理。
 | 属性 |
| mchid 必填 string(32) 【商户号】平台商户号，由微信支付生成并下发，发起充值的指令方商户号。
subMchid 必填 string(32) 【二级商户号】二级商户号，由微信支付生成并下发，出资方商户号。
packageInfo 必填 string(1024) 【package信息】对应申请二级商户充值接口返回的package_info，用于唤起微信充值到商户账户页面。 |
wx.openBusinessView 请求示例
1if (wx.openBusinessView) {
2 wx.openBusinessView({
3 businessType: 'liteAppMerchantRecharge',
4 queryString: 'mchid=1230000000&subMchid=1230000003&packageInfo=affffddafdfafddffda%3D%3D',
5 success() {
6
7 },
8 fail() {
9
10 },
11 complete() {
12
13 }
14 });
15} else {
16
17}返回参数
触发场景: 用户从商户小程序页面进入到微信充值到商户账户页面再返回到商户小程序页面。
data 必填 string
【业务数据】格式为JSON字符串，如 {"code":"SUCCESS"}。具体内部字段如下
| 属性 |
| code 必填 string(32) 【返回码】 SUCCESS：充值成功。
USER_CANCEL：用户取消或者充值失败。
PARAM_ERROR：参数错误，请检查传入参数格式是否正确。
INVALID_REQUEST：请求失败，参数格式正确，但不符合业务规则，请查看失败原因。
message 选填 string(1024) 【失败原因】不建议展示给用户，仅用于商户的开发人员定位失败原因。 |
成功回调的参数示例
1{
2 errno: 0,
3 errMsg: 'openBusinessView:ok',
4 data: {
5 code: 'SUCCESS' | 'USER_CANCEL' | 'PARAM_ERROR' | 'INVALID_REQUEST',
6 message: '...'
7 }
8}
9无论成功、失败都会触发 complete 回调，返回参数与同次请求的成功回调或失败回调相同。
| 成功回调不代表充值成功，应根据返回码判断充值是否成功。 |
|
