文档中心 > 会员接入文档

会员互通

更新时间:2023/12/01 访问次数:7803

业务说明

1、会员注册分为同步返回注册结果、异步查询注册结果、异步告知注册结果,具体详见会员注册文档
2、qimen.alitrip.partner.member.info.query进入飞猪卡包才会触发查询,商家要主动更新会员信息需通过alitrip.partner.member.info.update进行更新;
3、商家端会员信息有更新(eg:等级积分等信息变化)可通过alitrip.partner.member.info.update进行更新,注意并非所有字段都允许更新,飞猪端对字段有权限校验
4、商家可通过fliggy_member_LevelChange 和alitrip.partner.member.levelmatchinfo.get 获得新的飞猪等级,商家需根据飞猪会员等级和酒店等级返回最高等级(例如航旅会员为f1,酒店返回为v3;航旅升级为f2后,酒店返回仍为v3。例如航旅会员为f1,酒店为v1,升级为f2后,应返回v2。)

接口说明:
接口1【必接】:qimen.alitrip.partner.member.register 用于注册接口,必接接口
接口2【必接】:qimen.alitrip.partner.member.info.query 用于飞猪侧查询商家会员信息,以帮助用户更新商家会员信息的展示,必须接入。
接口3【必接】:alitrip.partner.member.info.update 用于商家侧主动通过接口更新用户最新的会员信息展示,必须接入。
接口4:fliggy_member_LevelChange 飞猪侧将通过本接口发送用户等级情况变动信息,商家通过本接口获取消息之后通过接口5获取用户的飞猪会员等级,以根据合作协议为该用户升级/保级商家会员等级;该接口适用于飞猪会员升级,商家会员也升级的合作场景,且需要与接口5一起接入。
接口5:alitrip.partner.member.levelmatchinfo.get 商家通过本接口获知用户的飞猪会员等级,配合接口4将可以根据合作协议对用户的商家会员等级进行相应的升级/保级;需要与接口4一起接入。
接口6:alitrip.partner.member.status.invalid 如图说明,按需接入。

image

业务流程

image

会员接口

API接口名称 类型 接口说明
qimen.alitrip.partner.member.register 奇门 注册接口,用于飞猪向商家提交注册申请,建议商家使用suggest_partner_level
qimen.alitrip.partner.member.info.query 奇门 查询商家会员信息接口,飞猪查询商家会员来更新飞猪端存储的信息。目前进入飞猪端端卡包会触发此逻辑
alitrip.partner.member.info.update top 商家通过该接口更新飞猪端存储的会员等级以及积分,注意并非所有字段都允许更新,飞猪端对字段有权限校验
fliggy_member_LevelChange 消息 飞猪向商家发送的消息,通知商家互通的飞猪会员的飞猪会员等级发生变化。在合作协议中商家会员等级需要随飞猪会员等级更新而更新的场景,商家收到此消息后,调用alitrip.partner.member.levelmatchinfo.get获取当前飞猪会员登记,然后需更新自己商家会员等级。
alitrip.partner.member.levelmatchinfo.get top 商家调该接口获取飞猪会员等级和对应的商家会员等级
alitrip.partner.member.status.invalid top 用户在商家侧的会员失效,商家可通过此接口告知飞猪进行会员解绑

消息

fliggy_member_LevelChange
image

消息示例:
{
“openuid”: “123456”,
“dataid”: “123456”,
“partner_key”: “123456_taobao”,
“fliggy_user_name”: “ABCDEFG”,
“partner_member_id”: “123456”
level_change_type”: “prolong” 备注:新增字段String类型 prolong:延期 upgrade:升级
}

FAQ

关于此文档暂时还没有FAQ
返回
顶部