会员互通整体流程
1.入驻淘宝开放平台
注意需要有淘宝帐号才能登录开放平台,开放平台地址https://work.open.taobao.com/workspace-home
在首页选择飞猪开发者
2.申请应用获得appkey、secret信息
申请类目流程如下
没有店铺可以选择飞猪-新业务,有店铺可正常按店铺业务选择应用标签
3.填写回调地址、上线应用并获取到top的sessionkey
回填地址填写流程如下:
回填地址填写后,可上线应用,应用上线不会导致线上入单,可直接上线应用,上线应用流程如下:
sessionkey获取流程如下:
打开此链接https://open.alitrip.com/apitools/sessionPage.htm?spm=a21tt.7629140.0.0.6e98c486MeVjA8
用你们申请appkey的淘宝去登录授权即可
4.提供appkey给飞猪技术支持申请top权限包和奇门权限
appkey 按照如下获取后,发送群内提供给飞猪技术支持,等待审批
5.权限通过后,下载SDK包开发
下载SDK包流程如下:
选择你对应的版本点击生成并下载,生成一般需要3-5分钟,需要等待一会
6.开发完成后,登录奇门配置地址并上线
奇门配置时,线上地址和测试地址都需要填写一下,如果还为正式发布的话,可以将线上地址和测试地址填成一样的,后续上线时在替换,也可以直接上线发布 奇门配置如下:
填写商家自己的正式/测试的服务器URL地址信息,如: http://testfliggy.crs.cn/orderModify
该过程中产生的验签可参考该文档:https://open.alitrip.com/docs/doc.htm?treeId=702&articleId=121117&docType=1
7.登陆开放平台,订阅fliggy_member_LevelChange
按步骤点击订阅TMC即可
该步骤下还涉及消息的服务使用,具体可参考平台提供的消息服务使用介绍说明
https://open.taobao.com/docV3.htm?spm=a219a.15212433.0.0.68d1669aXf5pvT&source=search&docId=101663&docType=1
8.联系飞猪技术支持测试奇门接口及老用户绑定逻辑
此阶段,飞猪技术支持只测试注册和查询这两个奇门接口,所使用的的测试数据,都是随机生成的非飞猪的正式会员信息,无法进行top的测试回调。
测试“老用户绑定就高”能力时,需要商家侧提供一个老会员的信息,由飞猪技术支持调用注册接口,进行测试;如商家提供一个V4会籍的老会员信息,飞猪技术支持以“F1,建议V1”的信息调用注册接口,测试是否返回为V4。
9.奇门及老用户绑定测试通过后,等待飞猪运营同学在飞猪预发环境测试注册及top接口(包含同升、同保)
调用商家测试地址
1)测试注册能力
测试新用户注册,及老用户绑定(如上个步骤测试顺利也可跳过);
涉及接口:
注册接口,用于飞猪向商家提交注册申请,商家须使用suggest_partner_level |
2)商家会籍等级、卡号、积分等信息回传及更新
涉及接口
查询商家会员信息接口,飞猪查询商家会员来更新飞猪端存储的信息。目前进入飞猪端端卡包会触发此逻辑 |
||
top |
商家通过该接口更新飞猪端存储的会员等级以及积分,注意并非所有字段都允许更新,飞猪端对字段有权限校验 |
3)测试用户F等升级,商家会员等级是否同步根据匹配关系升级(同升)
涉及接口
消息 |
飞猪向商家发送的消息,通知商家互通的飞猪会员的飞猪会员等级发生变化。在合作协议中商家会员等级需要随飞猪会员等级更新而更新的场景,商家收到此消息后,调用alitrip.partner.member.levelmatchinfo.get获取当前飞猪会员登记,然后需更新自己商家会员等级。 |
|
top |
商家通过该接口更新飞猪端存储的会员等级以及积分,注意并非所有字段都允许更新,飞猪端对字段有权限校验 |
对应消息变更类型 level_change_type:pgrade 升级
step1:飞猪运营使用飞猪测试账号,用较低F等会员去注册匹配商家会员
step2:使用飞猪飞鸟工具,修改测试账号的F等。
step3:重新进入飞猪相关页面,观察商家会员卡是否升级至合作offer对应的V等
4)测试用户F等同保,商家会员是否同步根据协议同步保级(同保)
涉及接口
消息 |
飞猪向商家发送的消息,通知商家互通的飞猪会员的飞猪会员等级发生变化。在合作协议中商家会员等级需要随飞猪会员等级更新而更新的场景,商家收到此消息后,调用alitrip.partner.member.levelmatchinfo.get获取当前飞猪会员登记,然后需更新自己商家会员等级。 |
|
top |
商家调该接口获取飞猪会员等级和对应的商家会员等级 |
对应消息变更类型 level_change_type:prolong 延期
注:该步骤中因运营同学测试时是在飞猪预发环境测试同升及同保,所以消息是通过飞猪预发环境发出,需要保证 tmc client 需要连接到ws://premc.api.taobao.com,API消费的的需要推送到预发去拉取 ,否则消息无法处理,具体如何修改到对应的环境参考步骤7内的平台服务使用说明
10.正式上线测试
正式线上环境测试,如整体流程正常后可慢慢放开资源位展示。
仍需测试注册、信息回传更新展示、同升等;可增加积分累积的测试,测试购买订单是否能累积相应积分。
If you get gains,please give a like