APP调起签约-Android

更新时间：2025.12.19

简介

商户在完成预签约后，可在移动端应用APP中集成开放SDK调起微信，请求用户签约。

接入前注意事项

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

该能力依赖微信Open SDK，需按照指引在微信开放平台申请开通移动应用的微信支付能力，以完成相关初始化配置
该能力需要使用微信支付商户号，需配置 Api key 配置商户号证书等内容，详情可参考开发必要参数说明
预签约成功后，调起微信有严格的时间限制：需在 10 分钟内调起微信。因此，建议在确认用户有签约意愿后再发起预签约，且预签约一旦成功，需立即通过 SDK 调起微信，以确保流程顺利进行

接口说明

支持商户：【普通服务商】

接口名称：WXOpenBusinessView

需要引用新的openSDK：

Android openSDK下载地址（版本>=5.3.1）：Android资源下载
Android 接入文档链接：openSDK说明文档

接口兼容：

Android兼容性表现：若微信版本>=8.0.51，开发者可以通过此openSDK接口调起签约自动还款页面；若微信版本< 8.0.51，开发者通过此openSDK接口不能跳转到微信，此时开发者应提示用户更新微信版本。

接口参数

Android对应对象：WXOpenBusinessView.Req

请求参数

businessType 必填 string(128)

【业务类型】预签约接口返回的 redirect_service 值。

query 必填 string(2048)

【查询参数】使用URL的query string方式传递参数，格式为key=value。

属性

调用示例

1int wxSdkVersion = api.getWXAppSupportAPI();
2if (wxSdkVersion >= Build.OPEN_BUSINESS_VIEW_SDK_iNT) {
3  WXOpenBusinessView.Req req = new WXOpenBusinessView.Req();
4  req.businessType = redirect_service; // 预签约返回的 redirect_service
5  req.query = "presign_token=xxx"; // 预签约返回的 presign_token
6  Boolean ret = api.sendReq(req);
7} else {
8  /*需提示用户升级微信版本*/
9}

返回参数

Android对应对象：WXOpenBusinessView.Resp

businessType 必填 string(16)

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

extMsg 必填 string

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

属性

result 必填 string(32)

【调用微信支付结果】

success：代表已经成功拉起微信客户端进行签约

返回示例

1// 展示成功的返回数据示例
2resp.businessType == "xxx"
3resp.extMsg == "{\"result\":\"success\"}"

注意

客户端返回的结果只表示拉起微信客户端成功，不代表用户签约成功，最终是否签约成功的结果请通过《查询协议》接口返回的为准

文档是否有帮助

更多支持

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