# 聚合支付（统一下单）
# 简要描述
- 公众号、小程序/生活号商城：用户通过公众号/小程序下单，输入密码完成付款动作
# 请求URL
/openapi/v1/open/pay/webJsPay
# 请求方式
- post
# 具体步骤：
- 步骤1：用户通过扫描台卡或公众号/小程序商城，发起支付
- 步骤2：请求聚合支付接口获取调起控件的参数
- 步骤3：调起微信/支付宝/云闪付APP的支付控件，输入支付密码
- 步骤4：密码验证通过，支付成功后可以得到推送通知
# 注：调用官方的拉起控件地址
- 微信公众号拉起控件： https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=7_7&index=6
- 微信小程序拉起控件： https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_7&index=5
- 支付宝拉起控件： https://docs.alipay.com/mini/api/openapi-pay
# 业务参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| openId | 是 | string | 微信openid或者支付宝uid |
| totalPrice | 是 | string | 金额 单位：元 |
| payWay | 是 | string | 支付方式 1：微信 2：支付宝 |
| orderNumber | 是 | string | 订单号 |
| callBackUrl | 是 | string | 回调地址 参见支付异步回调 支付异步回调 |
| jspayFlag | 是 | string | 支付产品 2：微信公众号/支付宝生活号/银联js支付/支付宝小程序 3：微信小程序 |
| subAppid | 否 | string | 微信子公众号，最大长度32位 小程序必传，仅微信使用 |
| goodName | 否 | string | 商品名称 |
| royalty | 否 | string | 分账标记 1：否 2：是 |
| royaltyEffectTime | 否 | string | 分账有效时间（单位天，最大30） |
# 返回示例
{
"msg": null,
"code": 200,
"obj": {
"jsPayResponse": {
"timeStamp": "1677576520",
"orderNumber": "20210709175451748107",
"paySign": "OCF/KH/T03zwgRFoKb23NZZz48EEPLKBsXRcAbzLJ8edcLtoXlNLkQB0ZXHmtwWVXzd0Y5HNOcuXKapCTGwcatitg6ixUZDUdhQwnXIEQGZtuz3pZhQGMKo/Nh4ShiifSew1eYK+mfGF/2P57u1ozP1sEkWjUcs84kHbF8Z7LJX8IkY6jBm/SSP0oXhZjeMxhgSOmLBVpeWnpE6ohpHZqcx2CACVHOgyCGaxPIHJAWPNuQGe80z10FO+s/mSDh15/li2UgCQaCqL6YMZibUq4iOWLnAoQ/cDVePbk1QfUv+1XcTObl0m5+tEX3bcWdJ29V+9mNx9xxSLBfn2LaQgSw==",
"price": "0.01",
"appId": "wxdadswetr12f5676",
"signType": "RSA",
"pkg": "prepay_id=wx28172840667766bfc4e9c4ed5ec7830000",
"nonceStr": "cc9f50fc52a040d8aae86d751716635a"
},
"channel": 12
},
"sign": "15ef49caa5df7001af74cf74337a6aac"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 返回参数说明
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| tradeNO | string | 支付宝收银台流水号 | |
| appId | string | 微信appId | |
| timeStamp | string | 时间戳，自1970年以来的秒数 | |
| nonceStr | string | 随机串 | |
| pkg | string | 微信pkg | |
| signType | string | 微信签名方式 | |
| price | string | 金额 | |
| paySign | string | 微信签名 |
# 托管下单参数说明
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| prePayTn | string | 预支付标识信息 | |
| miniProgramOrgId | string | 小程序原始id | |
| appId | string | 小程序appId | |
| miniProgramPath | string | 跳转小程序的路径 |