众科云开放平台
  1. 7、账号管理
众科云开放平台
  • 概述
  • 对接流程
  • 场景介绍
  • 安全规范
  • 获取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 进件行业列表
  1. 7、账号管理

7.3 第三方平台对接授权

企业通过在线授权的方式,将企业在我方平台生产的对接秘钥通过接口的方式提供给第三方平台。
授权流程:
1、先确保企业客户已经跟我方完成客户合同签订,SAAS系统开通流程(重点是已经配置了安全手机)。
2、第三方平台根据我方规则,生成授权跳转链接。
3、第三方平台引导企业操作人员打开授权链接。
4、企业操作人员,在我方授权链接基于企业预留安全手机完成短信验证码授权。
5、我方平台将企业对接秘钥推送给第三方平台。
跳转URL:‌
https://SAAS系统的域名/login/api/authorize
请求方式:‌
GET
授权链接URL示例:‌
https://saas-test.gzlle.com/login/api/authorize?bizLicenseCode=91430104MA4L77EH9Y\&ipWhite=203.195.154.33,42.193.183.199\&redirectName=%E5%B1%B1%E8%A5%BF%E4%BF%AE%E4%B8%80%E7%94%9F%E6%96%87%E5%8C%96%E4%BC%A0%E5%AA%92%E6%9C%89%E9%99%90%E8%B4%A3%E4%BB%BB%E5%85%AC%E5%8F%B8\&notifyUrl=http%3A%2F%2Fsaas-test.gzlle.com\&apiNotifyUrl=http%3A%2F%2Fsaas.gzlle.com\&redirectUrl=http%3A%2F%2Fsaas.gzlle.com\&providerId=372692174988378112#contract_sign_pageb
‌
授权链接参数说明:
参数类型是否必须说明
bizLicenseCodestring是企业统一信用代码。
providerIdstring是服务公司的唯一ID,第三方平台可以线下向合作服务商获取。
notifyUrlstring是企业授权成功后,平台会将 corpId、providerId、appKey、appSecret 等参数回传到该链接。详细回传格式请参考 秘钥回传至 notifyUrl 地址说明。
redirectUrlstring是需要对 redirectUrl 进行 url_encode 转码。当企业操作员操作完成后,可以通过该链接跳回至第三方平台系统。
redirectNamestring是第三方平台名称,需要进行 url_encode 转码,在我方系统中展示。
ipWhitestring是IP 白名单,提现订单相关接口需要指定 IP 白名单,否则无法使用。可在此处配置第三方平台调用的 IP 白名单,如果 IP 较多,可使用英文逗号 , 分隔,也支持 10.0.0.* 这种格式的范 IP,例如:10.1.1.2,222.222.222.222,192.168.1.*,需要 url_encode 转码。
apiNotifyUrlstring否企业在我方开放平台的 全局回调链接,实时提现、签约等接口场景可能会用到。如果此处不指定,则需要在各个接口单独指定回调链接。
秘钥回传至notifyUrl地址说明:
请求方式:‌
POST
回调请求示例
第三方平台回调响应结果示例
请确保回调响应的http状态码为200,并且按照下方指定的json格式进行响应。否则我方系统将认定为企业方未接收到回调结果,我方系统将自动进行二次回调(1、2、4、8、16、32、64、128分钟后分别再次回调,直到正确返回,最多再多回调8次)。
参数类型必须说明
providerIdstring是服务商ID。
corpIdstring是企业ID。
appKeystring是对接用的 appKey。
appSecretstring是该值后续无法在 SAAS 查询到,只能重置,所以务必保存好该值。
bizLicenseCodestring是企业信用代码,用于第三方平台进行企业匹配。
phonestring是当前企业的管理员手机号码,该号码可用于 7.1 快捷登录。
修改于 2025-02-07 08:25:27
上一页
7.2 快捷登录页面跳转
下一页
8.1 开票订单列表
Built with