对接流程

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

1、签订业务合作协议

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

2、确定对接场景

企业根据业务合作协议内容、业务背景、业务需求、业务流程来确定对接场景,详细的对接场景说明请看场景介绍章节。

如果企业不确定自己适合哪类对接场景,可以通过对接群里的客服/销售经理,联系我们技术接人员,为您分析具体对接场景。

3、开通SAAS账号

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

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

4.1 获取对接秘钥信息

基于安全考虑,企业对接秘钥信息,只允许企业自行登录SAAS系统获取。

对接秘钥获取操作路径:企业对接人使用SAAS账号,登录企业SAAS平台,进入-->【系统管理】-->【企业设置】-->【开发者配置】页面 点击"初始化信息"按钮,进行秘钥信息初始化。企业SAAS平台会自动将秘钥信息发送至企业联系人邮箱企业客户在申请资料填写的联系人邮箱)。

邮件中提供的秘钥信息参数说明如下:

参数名 详细说明
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、正式上线

在技术对接完成后,企业便可以自行上线。

results matching ""

    No results matching ""