众科云开放平台
    众科云开放平台
    • 概述
    • 对接流程
    • 场景介绍
    • 安全规范
    • 获取accessToken
    • 参数规定
    • 支持银行
    • 1、业务签约
      • 1.1 业务签约接入指南
      • 1.2 添加自由职业者
      • 1.3 获取自由职业者签约userToken
      • 1.4 页面签约跳转
      • 1.5 查询签约结果
      • 1.6 回调签约结果
      • 1.7 获取自由职业者信息
      • 1.8 修改自由职业者信息
      • 1.9 生成合同
      • 1.10 查询自由职业者列表
      • 1.11 快捷签约
      • 1.12 获取签约电子合同下载链接
    • 2、实时提现
      • 2.1 接入指南
      • 2.2 添加订单
      • 2.3 订单详情查询
      • 2.4 查询订单列表
      • 2.5 查询企业余额
      • 2.6 提现结果回调
      • 2.7 历史订单同步
    • 3、经营费用计算
      • 3.1 接入指南
      • 3.2 历史订单导入
      • 3.3 经营费用批量计算
    • 4、批量交易
      • 4.1 创建交易订单
      • 4.2 确认支付订单
      • 4.3 取消订单
      • 4.4 查询订单列表
      • 4.5 查询订单详情
      • 4.6 查询订单明细
      • 4.7 查询企业余额
      • 4.8 回调交易进展
      • 4.9 订单明细支付凭证下载链接获取
    • 5、余额查询
      • 5.1 余额查询
      • 5.2 创建充值申请
      • 5.3 预充值回调【待上线】
      • 5.4 充值申请查询
      • 5.5 预充值汇款账号查询
      • 5.6 余额查询(分账户返回余额)
    • 6、项目管理
      • 6.1 项目列表
      • 6.2 项目类型列表
      • 6.3 添加项目
      • 6.4 项目审核回调
    • 7、账号管理
      • 7.1 获取快捷登录Code
      • 7.2 快捷登录页面跳转
      • 7.3 第三方平台对接授权
    • 8、发票管理
      • 8.1 开票订单列表
      • 8.2 创建发票申请
      • 8.3 发票申请结果回调
      • 8.4 开票配置查询
      • 8.5 发票申请记录列表
      • 8.6 查询申请记录详情
    • 9、企业进件
      • 9.1 发起进件
      • 9.2 进件状态回调
      • 9.3 进件行业列表

    对接流程

    开放平台整体对接流程图如下图所示:
    image.png

    1、签订业务合作协议#

    由于对接的很多细节跟业务合作内容直接相关,所以在正式开始系统对接之前,请企业客户与平台先签订业务合作协议,企业可以根据业务合作协议内容确定对接场景。同时,我们目前只有正式环境用于对接调试,在签订协议之后,才能方便的获取对接信息。

    2、确定对接场景#

    企业根据业务合作协议内容、业务背景、业务需求、业务流程来确定对接场景,详细的对接场景说明请看场景介绍章节。
    如果企业不确定自己适合哪类对接场景,可以通过对接群里的客服/销售经理,联系我们技术接人员,为您分析具体对接场景。

    3、开通SAAS账号#

    在签订业务合作协议后,我们会建立业务合作对接群,平台客服人员会引导客户对接人完成SAAS平台系统账号开通。

    4、获取(配置)对接秘钥信息#

    4.1 获取对接秘钥信息
    基于安全考虑,企业对接秘钥信息,只允许企业自行登录SAAS系统获取。
    对接秘钥获取操作路径:企业对接人使用SAAS账号,登录企业SAAS平台,进入-->【系统管理】-->【企业设置】-->【开发者配置】页面 点击**"初始化信息**"按钮,进行秘钥信息初始化。企业SAAS平台会自动将秘钥信息发送至企业联系人邮箱(企业客户在申请资料填写的联系人邮箱)。
    image.png
    邮件中提供的秘钥信息参数说明如下:
    参数名详细说明
    corpId企业申请,由平台分配的企业客户编号。
    providerId企业当前合作的服务商Id,企业可以与多个服务商合作,所以该值可以有多个(当企业和多家服务商进行合作时,可以切换服务商后台,再进入【开发者配置】页面去获取providerId信息)。
    appKey用途:1 调用接口生成签名的密钥 2 结合appSecret获取accessToken的身份标识。appKey仅保留在企业客户系统和API后台,不会在网络中传播。企业客户应当妥善保管该Key,切勿在网络中传输,不能在其他客户端中存储,保证key不会被泄漏。
    appSecret结合appKey获取接口调用凭证accessToken时使用。该秘钥非常重要,可以用于资金交易,平台不会明文存储,请勿随意泄露。如果有需要,可以进入开发者配置进行重置。(SAAS平台无法获取appSecret,如果企业开发者遗忘该信息,请在开发者配置中进行重置)

    4.2 配置回调链接、IP白名单#

    在业务签约、企业提现等场景下,需要企业开发者配置的回调链接、IP白名单。
    配置项详细说明
    回调链接在企业系统和SAAS平台交互过程中,会存在需要系统主动后端回调通知企业系统的场景,所有的后端回调,都会通过该链接回调。建议使用https链接作为回调链接。
    IP白名单在企业系统调用资金操作类相关接口时,为了安全考虑,SAAS系统会要求企业先配置调用方服务器IP白名单,只有在白名单内的IP,才允许调用资金操作类接口。

    5、接口对接#

    在确定业务场景、获取对接秘钥信息后,便可以正式开始进行接口对接了。在对接过程中,如果有碰到问题,可以在业务对接群中联系我们的技术支持客服。
    同时可以参考我们的接口调用示例:
    java代码示例:https://github.com/carryliuz/open-demo-java\ postman请求示例:openapi.gzlle.com-v1.1.postman_collection

    6、准备上线#

    在技术对接完成后,准备上线时,如果有需要,可以联系我们技术支持清理相应的测试业务数据。

    7、正式上线#

    在技术对接完成后,企业便可以自行上线。
    修改于 2025-02-28 08:18:14
    上一页
    概述
    下一页
    场景介绍
    Built with