对接流程
开放平台整体对接流程图如下图所示:
.png)
1、签订业务合作协议
由于对接的很多细节跟业务合作内容直接相关,所以在正式开始系统对接之前,请企业客户与平台先签订业务合作协议,企业可以根据业务合作协议内容确定对接场景。同时,我们目前只有正式环境用于对接调试,在签订协议之后,才能方便的获取对接信息。
2、确定对接场景
企业根据业务合作协议内容、业务背景、业务需求、业务流程来确定对接场景,详细的对接场景说明请看场景介绍章节。
如果企业不确定自己适合哪类对接场景,可以通过对接群里的客服/销售经理,联系我们技术接人员,为您分析具体对接场景。
3、开通SAAS账号
在签订业务合作协议后,我们会建立业务合作对接群,平台客服人员会引导客户对接人完成SAAS平台系统账号开通。
4、获取(配置)对接秘钥信息
4.1 获取对接秘钥信息
基于安全考虑,企业对接秘钥信息,只允许企业自行登录SAAS系统获取。
对接秘钥获取操作路径:企业对接人使用SAAS账号,登录企业SAAS平台,进入-->【系统管理】-->【企业设置】-->【开发者配置】页面 点击"初始化信息"按钮,进行秘钥信息初始化。企业SAAS平台会自动将秘钥信息发送至企业联系人邮箱(企业客户在申请资料填写的联系人邮箱)。
.png)
邮件中提供的秘钥信息参数说明如下:
参数名 | 详细说明 |
---|---|
corpId | 企业申请,由平台分配的企业客户编号。 |
providerId | 企业当前合作的服务商Id,企业可以与多个服务商合作,所以该值可以有多个(当企业和多家服务商进行合作时,可以切换服务商后台,再进入【开发者配置】页面去获取providerId信息)。 |
appKey | 用途:1 调用接口生成签名的密钥 2 结合appSecret获取accessToken的身份标识。appKey仅保留在企业客户系统和Gzlle 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、正式上线
在技术对接完成后,企业便可以自行上线。