APP调起签约-iOS

更新时间：2025.12.19

简介

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

接入前注意事项

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

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

接口说明

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

接口名称：WXOpenBusinessView

需要引用新的openSDK：

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

接口兼容：

iOS兼容性表现：若微信版本 >= 8.0.51，开发者可以通过此openSDK接口调起签约自动还款页面；若微信版本 < 8.0.51，开发者通过此openSDK接口可以跳转到微信，但不能调起签约自动还款页面，此时微信会提示用户可能由于应用的请求非法或者微信版本过低。

接口参数

iOS对应对象：WXOpenBusinessViewReq

请求参数

businessType 必填 string(128)

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

query 必填 string(2048)

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

属性

调用示例

1WXOpenBusinessViewReq *req = [WXOpenBusinessViewReq object];
2req.businessType = redirect_service; // 预签约返回的 redirect_service 填充
3req.query = @"presign_token=111111"; // 预签约返回的 presign_token 填充
4[WXApi sendReq:req]

返回参数

iOS对应对象：WXOpenBusinessViewResp

businessType 必填 string(128)

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

extMsg 必填 string

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

属性

result 必填 string(32)

【调用微信支付结果】

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

返回示例

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

注意

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

文档是否有帮助

更多支持

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