码交易对接指引：
一、接口版本简要描述：
- 海科Saas平台支付业务可按照标准版或聚合版选择其一对接，优先推荐聚合版对接：
1、标准版即海科Saas将各支付业务开放原生接口，适用于需要业务灵活处理的接口服务商按需对接；
2、聚合版即海科Saas将各支付业务做聚合处理，适用于受理聚合业务的接口服务商对接；
- 按照支付类型划分，可分为被扫支付（付款码支付）和主扫支付（公众号支付/小程序支付/JS支付）：
1、被扫支付：收银员使用扫码设备读取用户微信、支付宝、银联云闪付APP的付款码后，将二维码或条码信息传送至商户收银台，由商户收银台或者商户后台调用该接口发起支付。支付通常会有用户免密和验密两种情况。
2、主扫支付（海科统称为公众号支付接口）：除被扫支付场景以外，商户系统先通过调用该接口在微信、支付宝或银联支付服务后台生成预支付交易单，返回正确
的预支付交易会话标识后再按扫码、JSAPI等不同场景生成交易串调起支付。
- 注：因微信官方政策调整。已经关闭间联通道的动态码主扫支付接口，建议服务商如场景需要，请使用公众号接口自行包装动态码扫码业务
二、支付接口流程图及简要描述：
- 被扫支付对接流程：
- 被扫支付（付款码支付）主要流程说明：
1、用户向收银员展示微信/支付宝/银联云闪付app内的付款码；
2、商户收银员使用扫码设备读取用户手机屏幕上的条码，并生成支付订单；
3、商户系统（商户系统也包含接口服务商后台系统），向海科Saas发起支付请求，海科Saas系统通过校验后向通道侧发起支付请求；
4、微信、支付宝、银联系统处理该笔支付业务订单；
5、当用户免密的情况下，微信、支付宝业务会同步返回支付结果；银联二维码不返回支付结果，只返回受理结果；
6、当用户非免密（输入密码）的情况下，微信、支付宝、银联会异步返回结果；
7、支付完成后，用户侧微信客户端会收到微信的推送结果；商户也会收到海科发送的支付结果；
8、当支付结果未明确时，海科Saas系统会进入内部轮询获取支付结果策略；
9、当商户系统调用查询时，海科Saas系统返回当前的订单状态。
- 被扫支付异常处理
1、当海科Saas系统在轮询期内仍然无法获取通道侧的支付状态，则会触发撤销订单逻辑 ；用户若已完成扣款，后续会原路退回；
2、微信支付宝被扫轮询周期为211秒，轮询15次，银联二维码被扫轮训周期为474秒，轮询13次，据数据统计一般2.5秒内95%交易都可获得支付结果
3、当用户微信端的支付结果与商户侧支付结果不一致时，请以海科Saas返回的商户侧支付结果为准 ，避免商户出现逃单、错单、少收款的情况；若海科次工作日收到用户两笔款项，则会进行原路退回；
4、建议服务商在系统内做轮询策略时不要频繁向海科Saas发起查询，以免造成不必要的系统压力；
5、用户微信端弹出支付失败提示，例如：余额不足，信用卡失效。需要重新发起支付；
- 公众号支付对接流程：
- 公众号支付（主扫支付）主要流程说明：
1、用户与商户在线下收单下发起支付；
2、商户系统需要通过页面向微信、支付宝、银联云闪付获取用户userid，获取方法参考下方链接；
3、商户系统组装参数，向海科Saas发起支付请求，海科Saas系统通过校验后向通道侧发起支付请求；
4、微信、支付宝、银联系统生成预付订单；
5、微信、支付宝业务同步返回预支付标识，银联云闪付返回可访问链接；
6、微信、支付宝业务组装预支付标识调起官方支付收银台，银联云闪付直接访问链接，调起方法参考下方链接；
7、微信、支付宝、银联处理该笔支付请求；
8、用户输入密码完成支付
9、支付完成后，用户侧微信客户端会收到微信的推送结果；商户也会收到海科发送的支付结果；
10、当支付结果未明确时，海科Saas系统会进入内部轮询获取支付结果策略；
11、当商户系统调用查询时，海科Saas系统返回当前的订单状态。
- 公众号支付（主扫支付）异常处理：
1、当海科Saas系统在轮询期内仍然无法获取通道侧的支付状态，则会触发关闭订单逻辑 ；用户若已完成扣款，后续会原路退回；
2、微信支付宝主扫轮询周期为1798秒，轮询13次，银联云闪付主扫轮训周期为628秒，轮询10次；
3、当用户微信端的支付结果与商户侧支付结果不一致时，请以海科Saas返回的商户侧支付结果为准 ，避免商户出现逃单、错单、少收款的情况；若海科次工作日收到用户两笔款项，则会进行原路退回；
4、用户微信端弹出支付失败提示，例如：余额不足，信用卡失效。需要重新发起支付；
- 公众号支付获取用户userid和调起支付参考链接：
1）微信公众号（子商户）：
获取userid（openid）: https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_4
调js支付： https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6
2）支付宝生活号
获取userid: https://docs.alipay.com/fw/api/105942
调js支付：https://alipay.open.taobao.com/docs/doc.htm?&docType=1&articleId=105591
3）银联js支付
获取userid：http://39.106.84.215:8181/docs/saas/saas-1bjio41r2aqmm
三、开发对接注意事项
1、平台提供一对一技术支持服务，商户开发过程中请联系贵司商务人员，由商务人员建立微信群安排对应技术支持协助联调，以保证项目上线后的稳定性。
2、接口中可空项规则为，M-必填；C-条件必填；O-非必填；请商户遵循接口要求进行开发，投产前务必在测试环境完成各项验证。
3、请求参数及返回参数，均采用相同机制进行签名。SAAS平台的接口可能增加字段，验证签名时必须支持增加的扩展字段。
4、其它注意事项
（1） 参数大小写问题
请留意文档中要求的字符大小写问题， 如 “md5 运算后， 字符串的字符要转换为大写” 。
（2） 参数格式问题
所有传入参数，一般为字符串类型，请注意文档中各处的具体要求。
（3） 时间戳问题
请使用Linux时间戳，注意为字符串格式。
刷卡交易对接指引：
现可提供【商米P2】和【联迪A8】两款型号终端的银行卡交易SDK，如需对接银行卡刷卡交易，请联系商务人员获取SDK对接技术支持。
