7.3 第三方平台对接授权
企业通过在线授权的方式,将企业在我方平台生产的对接秘钥通过接口的方式提供给第三方平台。
授权流程:
1、先确保企业客户已经跟我方完成客户合同签订,SAAS系统开通流程(重点是已经配置了安全手机)。
2、第三方平台根据我方规则,生成授权跳转链接。
3、第三方平台引导企业操作人员打开授权链接。
4、企业操作人员,在我方授权链接基于企业预留安全手机完成短信验证码授权。
5、我方平台将企业对接秘钥推送给第三方平台。
跳转URL:
请求方式:
- GET
授权链接URL示例:
授权链接参数说明:
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
bizLicenseCode | string | 是 | 企业统一信用代码 |
providerId | string | 是 | 服务公司的唯一Id,第三方平台可以线下向合作服务商获取 |
notifyUrl | string | 是 | 企业授权成功后,平台会将corpId,providerId,appKey,appSecret等参数回传到该链接。详细回传格式,请见下方秘钥回传至notifyUrl地址说明: |
redirectUrl | string | 是 | 需要对redirectUrl进行url_encode转码.当企业操作员操作完成后,可以通过该链接,跳回至第三方平台系统。 |
redirectName | string | 是 | 第三方平台名称,需要进行url_encode转码,在我方系。 |
ipWhite | string | 是 | IP白名单,提现订单相关接口需要指定IP白名单,否则无法使用,可以在此处配置第三方平台调用的IP白名单,如果IP比较多,可以用英文逗号进行分隔,也支持10.0.0.*此种格式的范IP.例如:10.1.1.2,222.222.222.222,192.168.1.*,需要url_encode |
apiNotifyUrl | string | 否 | 企业在我方开放平台全局回调链接,实时提现、签约等接口场景可能会用到,如果此处不指定,则需要在各个接口单独指定回调链接。 |
秘钥回传至notifyUrl地址说明:
请求方式:
- POST
回调请求示例
{
"providerId": "12345678",
"corpId":"123455",
"appKey":"xxxxxxxxxxx",
"appSecret":"bbbbbbbbbbbb",
"bizLicenseCode":"yyyyyyy",
"phone":"151****1234"
}
第三方平台回调响应结果示例
请确保回调响应的http状态码为200,并且按照下方指定的json格式进行响应。否则我方系统将认定为企业方未接收到回调结果,我方系统将自动进行二次回调(1、2、4、8、16、32、64、128分钟后分别再次回调,直到正确返回,最多再多回调8次)。
成功示例
{
"code": "SUCCESS"
}
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
providerId | string | 是 | 服务商Id |
corpId | string | 是 | 企业Id |
appKey | string | 是 | 对接用的appKey |
appSecret | string | 是 | 该值后续无法在SAAS查询到,只能重置,所以务必保存好该值。 |
bizLicenseCode | string | 是 | 企业信用代码,用于给第三方平台来做企业匹配使用。 |
phone | string | 是 | 当前企业的管理员手机号码,该号码可以用于7.1快捷登录 |