APP拉起支付

更新时间：2025.01.07

通过APP支付下单接口获取到发起支付的必要参数prepay_id，可以按照接口定义中的规则，使用微信支付提供的SDK调起APP支付。

1. 接口说明

适用对象:直连模式机构模式

2. 接口定义

此API无后台接口交互，需要将列表中的数据签名

客户端请求字段（注意：以下字段名字母大小写敏感）：

参数名	变量	类型[长度限制]	必填	描述
APPID	appid	string[1,32]	是	商户注册具有支付权限的公众号成功后即可获得示例值：wx8888888888888888
商户号	partnerid	string[1,32]	是	请填写商户号mchid对应的值。示例值：1900000109
预支付交易会话ID	prepayid	string[1,64]	是	微信返回的支付交易会话id。示例值： WX1217752501201407033233368018
订单详情扩展字符串	package	string[1,128]	是	暂填写固定值Sign=WXPay 示例值：Sign=WXPay
随机字符串	noncestr	string[1,32]	是	随机字符串，不长于32位。推荐随机数生成算法。示例值： 5K8264ILTKCH16CQ2502SI8ZNMTM67VS
时间戳	timestamp	string[1,10]	是	时间戳示例值：1412000000
签名	sign	string[1,256]	是	签名，使用字段appId、timeStamp、nonceStr、prepayid计算得出的签名值注意：取值RSA格式示例值：oR9d8PuhnIc+YZ8cBHFCLw4jq\/xDg==

3. paySign生成规则

3.1.构造签名串

签名串一共有四行，每一行为一个参数。行尾以\n（换行符，ASCII编码值为0x0A）结束，包括最后一行。如果参数本身以\n结束，也需要附加一个\n

参与签名字段及格式:

1   公众号id
2   时间戳
3   随机字符串
4   预支付交易会话ID

待签名串举例：

1   wx8888888888888888
2   1414561699
3   5K8264ILTKch16CQ2502SI8ZNMTM67VS
4   123456789

3.2. 计算签名值：

绝大多数编程语言提供的签名函数支持对签名数据进行签名。强烈建议商户调用该类函数，使用商户私钥对待签名串进行SHA256 with RSA签名，并对签名结果进行Base64编码得到签名值。

下面我们使用命令行演示如何生成签名。

1$ echo -n -e \
2"wx8888888888888888\n1414561699\n5K8264ILTKCH16CQ2502SI8ZNMTM67VS\nWX1217752501201407033233368018\n" \
3  | openssl dgst -sha256 -sign apiclient_key.pem \
4  | openssl base64 -A
5  uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9Bx7cob8H/4nLBiCwIUFluw==

注意

signType参数不参与签名，但需要传递，默认值为“RSA”，生成的签名需要通过字段paySign传递。

示例代码如下：

IOS

1PayReq *request = [[[PayReq alloc] init] autorelease];
2request.partnerId = @"10000100";
3request.prepayId= @"1101000000140415649af9fc314aa427";
4request.package = @"Sign=WXPay";
5request.nonceStr= @"a462b76e7436e98e0ed6e13c64b4fd1c";
6request.timeStamp= @"1397527777";
7request.sign= @"oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvkYD7rthRAZ\/X+QBhcCYL21N7cHCTUxbQ+EAt6Uy+lwSN22f5YZvI45MLko8Pfso0jm46v5hqcVwrk6uddkGuT+Cdvu4WBqDzaDjnNa5UK3GfE1Wfl2gHxIIY5lLdUgWFts17D4WuolLLkiFZV+JSHMvH7eaLdT9N5GBovBwu5yYKUR7skR8Fu+LozcSqQixnlEZUfyE55feLOQTUYzLmR9pNtPbPsu6WVhbNHMS3Ss2+AehHvz+n64GDmXxbX++IOBvm2olHu3PsOUGRwhudhVf7UcGcunXt8cqNjKNqZLhLw4jq\/xDg==";
8[WXApi sendReq：request];

Android

1IWXAPI api;
2PayReq request = new PayReq();
3request.appId = "wxd930ea5d5a258f4f";
4request.partnerId = "1900000109";
5request.prepayId= "1101000000140415649af9fc314aa427",;
6request.packageValue = "Sign=WXPay";
7request.nonceStr= "1101000000140429eb40476f8896f4c9";
8request.timeStamp= "1398746574";
9request.sign= "oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvkYDSs2+AehHvz+n64GDmXxbX++IOBvm2olHu3PsOUGRwhudhVf7UcGcunXt8cqNjKNqZLhLw4jq\/xDg==";
10api.sendReq(request);