前言
写这篇文章目的在于笔记,两年开发经验,对接过美团和抖音b2c模式、还有o2o配送平台相关业务,刚开始我也挺懵的,完全搞不懂我们ERP属于哪个主体,平台主体如何对应我们系统主体,授权方式,扣费方式...
现在在下面都做下整理
接入主体
不管你们公司ERP(后续简称为ERP)准备对接哪个平台的什么业务都好,对于平台来讲,ERP或其他公司都被视作接入主体
接入主体大致可以分为三类(具体根据平台情况而定):
- 商家 & 没有自研能力:这类人群或公司,没有属于自己的开发团队,需要纯依赖平台方提供的技术服务来拓展公司的业务发展
- 商家 & 有自研能力:这类有属于自己的开发团队,可使用平台提供的API来统计分析更多维度的数据,拓展自己的业务
- 商家 & 没有自研能力 & 服务商提供技术桥接:这类商家一般为了省成本,可以简单理解为外包,请开发人员桥接ERP和三方平台
PS:第二类和第三类与实际并不一定对得上,比如说有的平台对第二类有更加便利的待遇,公司为享受到即使是第三类也会谎称第二类,所以大家懂我意思
确认ERP主体
你得问领导或者自己判断,公司ERP准备以哪个主体进行对接?
商户账号、店铺账号、开发者账号
商户账号(商家账号):以第三方平台商户的身份入职三方平台;站在接入主体角度,这个账号可以是商户无自研能力、自研公司的人、请外包的商家来注册
商户账号都会有个标识,比如商户ID、商家ID、企业ID等等
店铺账号:店铺账号一般是和商家账号是有关联的,一个商家允许有多个店铺,也会有个店铺ID标识
开发者账号:三方平台多数考虑到平台商户具有开发对接的能力,因此搞了个开发者账号,用于对接三方平台的接口和回调;注册人群:自研公司的人,外包服务商
开发者账号也有个标识,比如appkey、appId、dev_id等等
平台主体和ERP主体对应关系
1. 如果需要你系统的商家跟平台注册商户账号,然后你注册开发者账号,提供技术桥接。这种情况商户账号可能会有多个,开发者账号一个,多用于第三类接入主体,这样的好处是服务商只提供技术,至于平台和商家的一些结算是不干预的
对应关系:在ERP也得有个主体得和三方平台商户有个映射关系
PS:要留意下一个开发者账号是否允许关联多个商户账号,因为ERP入驻商家不止一个的;相反,如果商户除了对接ERP外,还需要对接其他公司的ERP,那么一个商户账号是否也可以绑定开发者账号
2. 如果你单独作为商家,为入驻你系统的商家提供统一的三方平台服务,那么商户账号只要注册一个就够了,然后开发者账号一个,多用于第二类接入主体,好处是商家不用跟平台结算,服务商和平台结算,服务商和商家自己内部结算
对应关系:可不需要在ERP维护映射关系,因为商户和开发者是一对一
店铺是否需要维护
有些平台上,是要求商户账号必须维护门店的,因此需要考虑在ERP这边如何跟三方平台的门店进行映射
授权
你商户打算让哪个开发者来服务于你对接ERP,需要有个绑定关系,即授权,绑定即授权。
目前主流的绑定方式有两种:
1. 在平台上直接绑定。比如登录开发者账号,发起商户绑定请求,然后商户账号来审核;但这种有个缺点,没有授权回调,授权有没成功,ERP是不清楚的,全靠人工口述通知
2. 在ERP嵌套授权链接。商户点击授权链接,登录商户账号完成授权;这种方式在于有授权回调,ERP能清楚是否授权成功,知道授权成功了就可以调用接口了
PS:授权链接的参数中一般都有开发者账号的ID标识的,比如appkey、appId、dev_id,检查下有没有这个,不然你商户登录后要绑定哪个开发者账号?
结算
这个很重要,不要以为结算不花你的钱跟你没关系,公司是很看重这个的,你对接人家三方平台的业务,人家给你提供服务,肯定要收费的,因此我们要了解收费的方式,怎么结算的
-
确定是【三方平台和外包结算、外包和商户结算】还是【三方平台直接和商户结算】?
-
平台如何获利?从一单里扣,还是给固定费
-
结算方式是什么?是记账月结、预充值月结、预充值下一扣一....
-
有没啥优惠返利政策?比如充值1000送100,下单量多少返多少钱等等
开发
请求规范
市面上http,post,json的形式相对主流点,但是我要提醒的不是这个,而是要清楚公共参数和业务参数的定义格式是咋样的
目前相对主流的参数定义有三种:
-
公共参数在请求体,如app_key、signatrue、body等等,body则是业务参数
-
公共参数在每个接口都有,但是接口参数各自独立,如dev_id、timestamp
-
公共参数跟在URL后面,业务参数放在请求体,如下:
上面三种你发现只是参数定义结构不一样,然后都要有公共参数,对应公共参数你要提前了解下面问题:
-
公共参数是否有开发者ID,商户ID?这很重要,能看出来开发者和商户是一对一还是一对多关系
-
如何计算签名?有无生成签名示例代码?
-
有无SDK?
测试
一般三方平台都会提供测试环境给开发者使用,如果你第一次对接,一定要清楚下面的问题?
-
有无提供测试域名?没有是否可用线上的
-
平台有没提供现成的测试开发者账号、测试商户账号?如果商户下还有店铺,问下有没测试店铺账号?如果有就用,没有就去注册(有的测试账号啥的是得你去注册完登录才有说明的)
-
确定你们本次要对接的接口,以及回调接口有哪些?回调地址在哪里设置?控制回调工具在哪里?
上线
- 确定线上域名,并切换
- 注册线上开发者和商户账号,提供资料
- 充值,授权,回调配置
- 正式发单