iOS

更新时间：2025.06.25

简介

商户在申请批量结算后，可在移动端应用APP中集成开放SDK调起微信，请求用户确认收款。

接入前注意事项

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

该能力依赖微信Open SDK，需按照指引在微信开放平台申请开通移动应用的微信支付能力，以完成相关初始化配置
该能力需要使用微信支付商户号，需配置 Api key 配置商户号证书等内容，详情可参考开发必要参数说明

接口说明

支持商户：【平台商户】

接口名称：WXOpenBusinessView

需要引用新的openSDK：

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

接口兼容：

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

接口参数

iOS对应对象：WXOpenBusinessViewReq

请求参数

businessType 必填 string(16)

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

query 必填 string(2048)

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

属性

mchid 必填 string(32)

【商户号】商户号，由微信支付生成并下发

appid 必填 string(32)

【商户AppID】微信开放平台审核通过的移动应用appid

package 必填 string(256)

【结算详情扩展字符串】需拼接申请个人收款批量结算接口返回的 settle_batch_no，参数格式：settle_batch_no=***

timeStamp 必填 string(32)

【签名时间戳】签名时的系统时间戳，自格林威治时间 1970-01-01 00:00:00（北京时间 1970-01-01 08:00:00）至现在的总秒数。

注意：部分系统取到的值为毫秒级，需要转换成秒（10位数字）。

nonceStr 必填 string(32)

【随机字符串】签名使用的随机字符串，不超过 32 字节

signType 必填 string(32)

【签名类型】默认为 RSA，仅支持 RSA

certSerialNo 必填 string(64)

【证书序列号】签名使用的商户 API 证书序列号

signature 必填 string(512)

【签名值】使用字段 appid timeStamp nonceStr package 计算得出的签名值，具体算法见下文签名步骤。

调用示例

1WXOpenBusinessViewReq *req = [WXOpenBusinessViewReq object];
2req.businessType = @"liteAppSettleC2CUserConfirmPay";
3req.query = @"mchid=111111&appid=222222&package=settle_batch_no%3D3333&timeStamp=1750819431&nonceStr=444&signType=RSA&certSerialNo=5555&signature=666";
4[WXApi sendReq:req]

返回参数

iOS对应对象：WXOpenBusinessViewResp

businessType 必填 string(16)

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

extMsg 必填 string

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

属性

result 必填 string(32)

【调用微信支付结果】

SUCCESS：代表请求已经发动到微信支付，但实际业务结果要根据 code和服务端回调或者主动查单的详情为准

code 必填 string(32)

【结果信息】

SUCCESS：展示页面成功。

其他失败情况请参考错误码

message 选填 string(1024)

【失败原因】当code不为SUCCESS时必填

不建议展示给用户，仅用于商户的开发人员定位失败原因

settleBatchNo 选填 string(64)

【微信支付结算批次单号】当code为SUCCESS时必填

微信支付系统内部生成的结算批次单号，全局唯一对应一笔商户结算批次单号

outSettleBatchNo 选填 string(64)

【商户结算批次单号】当code为SUCCESS时必填

商户在申请个人收款批量结算时传入的商户结算批次单号

返回示例

1// 展示成功的返回数据示例
2resp.businessType == "liteAppSettleC2CUserConfirmPay"
3resp.extMsg == "{\"result\":\"success\",\"code\":\"SUCCESS\",\"settleBatchNo\":\"3333\",\"outSettleBatchNo\":\"444\"}"

注意：

带有返回结果信息不代表收款成功，具体状态应以服务端收到回调或主动查单的详情为准。

错误码

错误码	描述	解决方案
PARAM_ERROR	参数错误	请检查传入参数是否符合格式要求
INVALID_REQUEST	请求失败	参数格式正确，但不符合业务规则，请查看失败原因
SIGN_ERROR	签名验证不通过	请参阅签名常见问题
NO_AUTH	无接口权限	没有调用此接口的权限，请查看失败原因
RATELIMIT_EXCEEDED	频率超限	请降低请求接口频率
USER_ERROR	用户原因失败	客户端不受支持、用户主动取消、网络异常等用户原因失败，通常无需处理注意：网络异常时，可能用户已发出确认请求，最终收款状态请以服务端回调或主动查单为准
ALREADY_EXISTS	资源已经存在	请求创建的资源重复，或者请求执行的操作已经完成，请检查资源状态例如：存在已受理过的结算单，不可重复发起结算
SYSTEM_ERROR	系统异常，请稍后再试	请稍后再试

签名步骤

构造待签名串

待签名串共有四行，每行为一个参数值，并以 \n（换行符，ASCII 编码值为 0x0A）结尾，最后一行也需要以 \n 结尾。

如果参数值以 \n 结束，也需要额外附加一个 \n。

待签名串的结构：

1小程序AppID
2签名时间戳
3随机字符串
4结算详情扩展字符串
5

待签名串的内容示例：

1wx8888888888888888
21414561699
35K8264ILTKCH16CQ2502SI8ZNMTM67VS
4settle_batch_no=1236698745558870
5

计算签名值

使用商户私钥对待签名串进行 SHA256 with RSA 签名，并对签名结果进行 Base64 编码，得到签名值 signature。

以命令行为例：

1echo -n -e \
2"wx8888888888888888\n1414561699\n5K8264ILTKCH16CQ2502SI8ZNMTM67VS\nsettle_batch_no=1236698745558870\n" \
3  | openssl dgst -sha256 -sign apiclient_key.pem \
4  | openssl base64 -A

输出结果示例：

1uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r5wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI1XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8alLDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/4nLBiCwIUFluw==

在以上计算签名值的过程中，没有使用到 signType 参数，但调用接口时仍需要传递默认值 RSA

文档是否有帮助

更多支持

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