一、接口版本简要描述:
- 海科Saas平台入网可按照标准版或聚合版选择其一对接,优先推荐聚合版对接:
1、标准版即海科Saas将本平台的商户入网及外平台的各业务报备流程开放原生接口,适用于需要业务灵活处理的接口服务商对接;
2、聚合版即海科Saas将本平台的商户入网及外平台的业务报备做聚合处理,适用于受理聚合业务的接口服务商对接;
二、商户入网及业务开通主要流程:
标准版入网对接流程:
聚合版入网对接流程:
三、商户入网及业务开通状态说明:
标准版入网状态说明:若服务商使用标准版入网接口对接,则按照入网接口和业务申请接口解析入网和报备各自的状态进行下一步处理;若判断入网状态或报备状态有失败时,可调用对应的入网驳回修改接口或业务申请接口
聚合版入网状态说明:若服务商使用聚合版入网接口对接,其商户的入网状态和报备状态仍然独立存在,需要服务商针对入网和报备状态做联合判断,有任一状态为失败,则后续携带入网商编、更换请求号、修改对应信息后再次调用聚合版入网接口
系统对接时对入网状态和报备状态说明:
如何判定为可展业的商户入网成功:即入网状态(status)=3-自动审核/4-待审核/7-审核成功,同时报备状态(report_status)=2-报备成功时;商户可发起交易;
如何判定为业务上商户入网失败即对应解决方案:
1) 入网状态(status)=1-提交失败时,重新调用接口;
2) 入网状态(status)=5-审核失败,或报备状态(report_status)=3-报备失败;按照报错提示,走对应修改流程;
3) 入网状态(status)=8运营审核退回 ,服务商需调用商户入网成功修改接口重新上传商户资料
4) 入网状态(status)=9运营审核退回未处理完成 ,服务商需调用商户入网成功修改接口重新上传商户资料。注意:该状态下运营审核通过后商户才可以交易。系统无法继续处理的失败:入网状态(status)=6-审核拒绝,运营人工抽审后认为该商户不符合展业标准或认为该商户有风险,拒绝该商户入网,此状态为终态。注意:运营操作审核拒绝前会其他与服务商对接人员沟通
入网状态(status)=8-运营审核退回 ,运营人工抽审后认为该商户入网资料不符合标准,需要服务商重新上传该商户资料,如果服务商在一定周期内未上传商户资料或者上传资料运营未审核通过,则会关闭商户交易,服务商需调用商户入网成功修改接口重新上传商户资料
入网状态(status)=9运营审核退回未处理完成,运营退回后服务商在一定周期内未重新上传商户资料或者在周期内上传资料运营未审核通过,服务商需调用商户入网成功修改接口重新上传商户资料。注意:该状态下运营审核通过后商户才可以交易。
1、入网状态流程图
2、报备状态流程图
四、接口汇总说明:
接口说明 | 主流程接口 | 相关配套接口 | 运营规则说明 |
---|---|---|---|
图片上传 | 1、图片上传 | 1.1图片上传API | 上传商户资质,如营业执照图片、法人身份图片等 |
标准版入网 | 2.1、商户入网 2.2、业务申请 |
2.1.1商户入网申请-标准版API 2.1.2商户入网驳回信息修改API 2.2.1银联业务申请API 2.2.2微信业务申请API 2.2.3支付宝业务申请API 2.2.4结算方式业务申请API 2.2.5商户申请单异步通知API 2.2.6商户申请单结果查询API | 未获得商编则重新调用入网接口 已获得商编则调用商户入网驳回信息修改接口 业务申请失败,则修改信息后重新调用对应业务申请接口 |
聚合版入网 | 2、商户入网 | 2.1商户入网申请-聚合版API 2.2商户状态及业务开通查询API 2.2.1银联业务申请API 2.2.2微信业务申请API 2.2.3支付宝业务申请API | 未获得商编则重新调用入网接口 已获得商编且商户在未审核通过状态前,则带商编、换流水号、修改对应信息后再次调用聚合入网接口 已获得商编,且商户状态为审核通过,需要补开通业务时,需要调用单独的业务申请接口 该接口同时支持商户申请单异步通知接口和查询接口获取入网状态及业务报备状态 |
商户终端绑定 | 3、商户终端绑定 | 3.1商户终端绑定【259】 3.2商户终端解绑【259】 3.3终端绑定查询【259】 |
为商户绑定收单设备类型(包含实体终端和软件类收银工具等) |
商户实名认证 | 4.1、微信二次认证 4.2、支付宝二次认证 |
4.1.1实名认证申请API 4.1.2实名认证撤销API 4.1.3实名认证查询申请单审核结果API 4.1.4获取商户开户意愿确认状态API 4.2.1创建申请单API 4.2.2申请单状态查询API 4.2.3关闭申请单API 4.2.4商户认证状态查询API |
商户完成报备后,服务商需调用微信、支付宝实名认证接口完成商户二次认证,才能获取微信、支付宝支付权限 |
微信公众号及授权目录配置 | 5、微信公众号配置 | 5.1微信公众号配置API 5.2微信公众号配置查询API |
使用微信公众号或小程序时,需完成配置才能获取微信支付权限 |
辅助类接口 | 6、修改接口 7、其他接口 |
6.1商户入网成功修改API 6.2商户入网成功修改查询API 6.3修改商户结算卡API 6.4商户结算卡信息查询API 6.5修改商户费率API 6.6接收退汇通知API 7.1商户产品开通及费率查询API 7.2商户名称查询API | 修改结算卡接口仅受理同名修改,非同名请联系运营线下变更 修改商户费率不得低于服务商签约底价 服务商需提前提供接受退汇通知地址,才可接收系统推送的退汇通知 |
五、对接前需要服务商提前完成的申请:
1、申请微信渠道服务商,联系海科运营提交申请,服务商联系人完成渠道号确认;获取到微信渠道号,即入网接口中微信业务的channel_no参数;
渠道号查看请参考在官方发送渠道号确认的邮件内容;
2、申请支付宝pid,自行到支付宝官方注册服务商主体的支付宝账号,从后台获取pid参数;即入网接口中支付宝业务的channel_no参数;
pid查看请参考链接:https://opendocs.alipay.com/p/00wcbg
3、如使用微信公众号业务,需申请与渠道号主体一致的微信公众号,且公众号类型为服务号,不接受订阅号;申请公众号请登录微信公众平台:https://mp.weixin.qq.com/