合单支付

1、接口清单

2、接口调用流程

2.1、合单支付-微信公众号、小程序支付接口调用流程

1、用户使用微信扫商户的收款二维码，或者用户在微信APP内访问了商户的商品下单页面。
2、用户输入金额或选择好商品，确认下单和支付。
3、商户的H5页面接受用户的请求后，向商户后台发起下单的请求。
4、商户后台按商户前台的请求完成下单，生成商户订单。
5、商户后台调用银盛支付的合单支付-微信公众号、小程序下单接口。请注意，调用微信公众号、小程序下单接口时，subOpenid必传。具体获取方式请参考https://pay.weixin.qq.com/wiki/doc/apiv3/terms_definition/chapter1_1_3.shtml#part-3获取
6、银盛支付生成预付单信息。
7、银盛支付将预付单信息、微信侧返回的参数等订单参数同步返回给商户后台。
8、商户后台将唤起微信收银台的JS API参数返回给商户前台。
9、商户前台用商户后台返回的订单参数，调用微信JSAPI以唤起微信收银台。
10、用户在微信收银台进行支付，微信处理用户的支付。
11、微信前端展示支付结果给用户。
12、微信后台将异步将支付结果通知给银盛支付。
13、银盛支付将订单的支付结果异步通知给商户后台。
14、商户后台在收到银盛支付的异步通知后，应答“success”以表示接收成功，否则银盛支付将最多重复发送10次该通知。商户也需要具备处理重复通知的能力。
15、商户前台向商户后台查询支付结果。
16、商户后台如果未收到银盛支付的回调通知结果，则可以调用“合单支付 - 订单及明细查询”接口向银盛支付查询支付结果。
17、银盛支付将支付结果返回给商户后台。
18、商户后台将支付结果返回给商户前台。
19、商户前台按照商户后台的结果展示对应的支付结果页，如支付成功、支付失败、支付处理中等。

2.2、合单支付-支付宝生活号接口调用流程

1、用户使用支付宝扫商户的收款二维码，或者用户在支付宝APP内访问商户的商品下单页面。
2、用户输入金额或者选择好商品生成前台订单，确认下单和支付。
3、商户前端H5页面接收用户请求后，向商户后台发起下单的请求。
4、商户后台按照商户前台的请求生成商户订单。
5、商户后台在生成商户订单后调用银盛支付的合单支付-支付宝生活号接口完成下单。请注意，买家支付宝用户ID（buyerId），和买家支付宝账号（buyerLogonId**【该字段于2023-9-1已不支持使用，请使用buyerId对接，如有疑问请咨询银盛技术支持！】**）不能同时为空。buyerId获取方法：https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.8ujLD6&treeId=115&articleId=104114&docType=1通过网页授权获取用户信息，同步响应结果中的user_id对应文档中的buyer_id。</font>
6、银盛支付生成预付订单。
7、银盛支付将预付订单信息、以及调用支付宝JSAPI的参数等订单参数同步返回给商户后台。
8、商户后台将调用支付宝JSAPI支付的参数返回给商户前台。
9、商户前台使用商户后台返回的JSAPI支付参数，调用支付宝JSAPI唤起支付宝收银台。
10、用户在支付宝确认支付、并输入支付密码。
11、支付宝前端展示支付结果给用户。
12、支付宝后台将支付结果异步通知给银盛支付。
13、银盛支付将订单的支付结果异步通知给商户后台。
14、商户后台在收到银盛支付的异步通知后，对应修改订单信息。
15、商户后台在收到银盛支付的异步通知后，应答"success"以标识接收成功，否则银盛支付将最多重复发送10次该通知。商户也需要具备处理重复通知的能力。
16、商户前台向商户后台查询支付结果，可以采用轮询或者长链接等方式。
17、商户后台在一定时间内未收到银盛支付的回调通知，可以调用“合单支付-订单及明细查询”接口向银盛支付发起支付结果查询。
18、银盛支付将支付结果返回给商户后台。
19、商户后台将支付结果返回给商户前台。
20、商户前台根据商户后台返回的支付结果，给用户展示对应的支付结果页面。

2.3、合单支付-行业码支付接口调用流程

1、用户使用云闪付扫商户的行业码，或者在云闪付APP内访问商户的商品下单页面。请注意，用户云闪付APP访问的二维码URL，需要到银联进行白名单报备。
2、用户输入金额或者选择好商品生成前台订单，确认下单和支付。
3、商户前端H5页面接收用户请求后，将用户下单信息请求到商户后台，完成下单请求。
4、商户后台按照商户前台的请求生成商户订单。
5、商户后台调用银盛支付的行业码获取用户标识接口。调用此接口之前需要先获取用户授权码，用户授权码获取方式：云闪付app浏览器前端跳转到https://qr.95516.com/qrcGtwWeb-web/api/userAuthversion=1.0.0&redirectUrl=callbackUrl 获取授权码,回调回来时 callbackUrl 后面添加 userAuthCode 和 respCode 两个参数， respCode=00标识成功， userAuthCode 为后台获取 APP 用户信息的临时授权码，有效期为5分钟
6、银盛支付返回用户标识信息。
7、商户后台使用用户标识、订单信息等调用银盛支付的合单支付-行业码支付接口进行下单。
8、银盛支付生成预订单。
9、银盛支付将预付订单信息、以及支付地址（web_url）同步返回给商户后台。
10、商户后台将支付地址(web_url)返回给商户前台。
11、商户前台通过支付地址（web_url）唤起唤起云闪付收银台。
12、用户在云闪付收银台界面完成付款操作。
13、云闪付前端展示支付结果给用户。
14、云闪付后台将支付结果异步通知给银盛支付。
15、银盛支付将订单支付结果异步通知给商户后台。
16、商户后台在收到银盛支付的异步通知后，对应修改订单信息。
17、商户后台在收到银盛支付的异步通知后，应答"success"以标识接收成功，否则银盛支付将最多重复发送10次该通知。商户也需要具备处理重复通知的能力。
18、商户前台向商户后台查询支付结果，可以采用轮询或长连接等方式。
19、商户后台在一定时间内未收到银盛支付的回调通知，可以调用“合单支付-订单及明细查询”接口向银盛支付发起支付结果查询。
20、银盛支付将支付结果返回给商户后台。
21、商户后台将支付结果返回给商户前台。
22、商户前台根据商户后台返回的支付结果给用户展示对应的支付结果页面。

2.4、合单支付-银联wap支付接口调用流程

1、用户进入商户前台页面。
2、用户选择好商品，确认下单。
3、商户前台发起下单请求，生成订单信息发送到商户后台。
4、商户后台生成商户订单。
5、商户后台返回商户订单信息到商户前台。
6、商户前台使用form表单提交商户订单，调用合单支付-银联wap支付接口，注意根据参数payMode区别，目前支持wap前台快捷支付。
7、银盛后台处理生成web收银台页面。
8、银盛后台返回银盛web收银台页面到商户前台。
9、用户访问使用浏览器访问银盛web收银台页面。
10、用户输入密码、点击确认完成支付。
11、银盛后台将支付结果异步通知给商户后台。
12、商户后台接收到支付结果异步通知后，修改商户订单信息并保存入库，同时应答“success”以表示接收成功，否则银盛后台将最多重复发送10次该通知。商户也需要具备处理重复通知的能力。
13、商户前端在支付完成后，主动调用商户后台订单支付结果查询接口，可采用轮询的方式。
14、商户后台如果未收到银盛后台的回调通知结果，则可以向银盛后台查询支付结果。
15、银盛后台将支付结果返回给商户后台。
16、商户后台将支付结果返回给商户前台，商户前台展示对应的支付结果页面。

2.5、合单支付-二维码支付接口调用流程

示例以支付宝为例

1、用户进入商户前台页面。
2、用户选择好商品，确认下单。
3、商户前台发起下单请求，生成订单信息发送到商户后台。
4、商户后台生成商户订单。
5、商户后台调用银盛合单支付-二维码支付接口，注意根据参数bankType区别，目前支持支付宝，QQ扫码，银联扫码，招商银行。
6、银盛后台生成预付订单信息，包含qrCodeUrl二维码链接地址。
7、银盛后台返回订单参数包含二维码地址等订单信息到商户后台。
8、商户后台返回二维码地址到商户前台。
9、商户前台根据二维码地址生成二维码图片，展示给用户。
10、用户扫描二维码，输入密码、点击确认完成支付。
11、银盛后台将支付结果异步通知给商户后台。
12、商户后台接收到支付结果异步通知后，修改商户订单信息并保存入库，同时应答“success”以表示接收成功，否则银盛后台将最多重复发送10次该通知。商户也需要具备处理重复通知的能力。
13、商户前端在支付完成后，主动调用商户后台订单支付结果查询接口，可采用轮询的方式。
14、商户后台如果未收到银盛后台的回调通知结果，则可以向银盛后台查询支付结果。
15、银盛后台将支付结果返回给商户后台。
16、商户后台将支付结果返回给商户前台，商户前台展示对应的支付结果页面。

2.6、合单支付-银联手机控件接口调用流程

1、用户进入商户前台页面。
2、用户选择好商品，确认下单。
3、商户前台发起下单请求，生成订单信息发送到商户后台。
4、商户后台生成商户订单。
5、商户后台调用银盛合单支付-银联手机控件支付接口，获取预付订单信息，包含tn流水号等。
6、银盛后台返回预付订单信息到商户后台。
7、商户后台返回预付订单信息到商户前台。
8、商户前台接收到预付订单信息，通过tn流水号等调用银联SDK跳转到云闪付App进行支付。
8.1、如果用户已安装云闪付App，商户前台会调用银联SDK跳转到云闪付App中完成支付。
8.2、如果用户未安装云闪付App，商户前台会调起银联SDK内嵌的收银台完成支付-待确认。
9、用户输入密码、点击确认完成支付。
10、云闪付展示支付结果。
11、云闪付异步通知支付结果到银盛后台。
12、银盛后台将支付结果异步通知给商户后台。
13、商户后台接收到支付结果异步通知后，修改商户订单信息并保存入库，同时应答“success”以表示接收成功，否则银盛后台将最多重复发送10次该通知。商户也需要具备处理重复通知的能力。
14、商户前端在支付完成后，主动调用商户后台订单支付结果查询接口，可采用轮询的方式。
15、商户后台如果未收到银盛后台的回调通知结果，则可以向银盛后台查询支付结果。
16、银盛后台将支付结果返回给商户后台。
17、商户后台将支付结果返回给商户前台，商户前台展示对应的支付结果页面。