1、接口清单
接口名称 | 必须 | 备注 |
---|---|---|
收银台预下单 | Y | 商户通过此接口进行预下单 |
收银台异步通知 | Y | 支付结果异步通知商户 |
交易结果明细查询 | N | 查询交易结果 |
交易退款 | N | 调用接口,可发起条码类交易退款 |
退款交易查询 | N | 查询退款交易信息 |
2、接口调用流程
以微信小程序支付为例:
聚合收银台步骤说明:
1、用户进入商户前台页面,选择商品,提交订单。
2、商户系统后台生成订单,并调用聚合收银台预下单接口,进行预下单。
3、收银台服务系统收到下单请求,校验下单信息,校验通过,生成订单支付信息和加密字符串并返回商户。
4、商户系统后台根据接口返回的信息,拉起银盛收银台(微信小程序半屏打开方法参考:调用半屏打开api)。
5、用户确认支付金额等信息,提交支付,聚合收银台前端发起支付请求。
6、收银台系统后台处理支付请求,进行交易处理,处理成功后,返回支付结果。
7、用户支付成功后,商户可通过以下两种方式获取订单状态:
- 方法一:收银台异步通知。用户完成付款后,收银台会将支付成功的结果以回调通知的形式同步给商户,商户的回调地址需要在调用收银台预下单接口时传入backUrl参数,异步通知参数:收银台异步通知。
- 方法二:当因网络问题或本身backUrl存在问题等原因,导致无法接收到回调通知时,商户也可主动调用交易结果明细查询来获取订单状态。
8、商户获取到订单状态后,可以向用户展示支付结果。