飞猪旅行酒店会员对接

更新时间：2021/10/27 访问次数：20928

商家提供给航旅会员绑定服务（HTTPS）

触发场景：

新用户通过飞猪旅行领取酒店会员卡时，飞猪旅行会员系统会调用商家提供的HTTPS接口，将飞猪旅行会员信息传递给商家，商家处理完自身逻辑后，将绑定后的会员信息返回到飞猪旅行会员系统。
新用户查看到会员商品—》选择下单—》用户绑定会员—》提交订单

业务逻辑：

若用户在酒店没有注册过会员，则根据飞猪旅行会员等级实时创建相应等级的酒店会员，并实时返回卡号进行下单。
若用户在酒店注册过会员，则根据飞猪旅行会员等级，若航旅会员等级高于已有会员等级，则酒店升级会员等级，并返回相应的等级和卡号进行下单。若航旅会员等级低于或等同于已有会员等级，则返回已有会员等级和卡号进行下单。
用户在下单做绑定操作时，用户的会员绑定信息（姓名，手机号，身份证）均来自于航旅会员平台。
用户绑定失败，则不会成功提交订单，会弹框提示用户绑定会员失败，请重新提交下单

HTTPS接口描述：

请求参数

名称	类型	是否必须	说明	描述
taobaoId	Long	是		淘宝用户ID，例如：123456
suggestLevel	String	是		接入方对接等级建议：V1~V999 具体参考接入方等级说明
taobaoLv	String	是		飞猪会员等级，例如F1
applyDate	String	是		申请日期，格式：yyyy-MM-dd
name	String	待定（产品定）	这是会员映射的字段产品决定怎么映射	用户姓名，例如：张三
phone	String（11字符）	待定（产品定）		用户手机号，例如：13811111111
idcard	String （经过校验）	待定（产品定）		用户身份证号，例如：110111111111111111
email	String	待定（产品定）		Xxx@xxx.XXX
secureKey	String	是	V4版本引入，之前不存在的接入保持现状，后续升级	验证请求的合法性 KEY_taobaoId_ApplyDate 做MD5，接入方通过约定的Key按照上述规则，根据参数中的taobaoId和ApplyDate计算md5，与这个secureKey比较，通过后才认为是合法请求，否则直接打回 taobaoId是淘宝用户的id ApplyDate是申请日期
logId	String	否	V4版本引入	接口对接用的唯一标识

正常返回：{"code":0,"taobaoId":123456,"partnersId":123456789, "cardNo":"987654321","grade":"V4","fromDate":"2015-05-01","toDate":"2015-12-31"}

异常返回：非0的为错误code，例如：{"code":100,"msg":”用户绑定失败”}

返回：

名称	类型	是否必须	描述
code	int	是	操作返回码，0为正常返回，非0为异常情况
msg	String	否	操作错误信息，code为非0时返回的异常信息
taobaoId	Long	是	淘宝用户ID，code=0时返回，例如：123456
partnersId	Long	是	XXX在航旅的卖家ID，例如：123456789
cardNo	String	是	XXX会员卡号，例如：987654321
grade	String	是	XXX卡级别，格式必须是V1\V2\V3\...，由于航旅这边的逻辑是通用逻辑，所以需要XXX做一次格式转换，比如金卡ID是4 传给我们时需要转换为V4.
fromDate	String	是	用户当前会员等级有效日期开始时间。如果该日期发生变化，则需商家通过更新接口推送给飞猪。比如用户从银卡升级为金卡，则推送金卡生效时间。格式：yyyyMMdd, 闭区间
toDate	String	是	用户当前会员等级有效期结束时间，如果该日期发生变化，则需商家通过更新接口推送给飞猪。比如用户从银卡升级为金卡，则推送金卡失效时间。格式：yyyyMMdd, 闭区间
logId

以下是阿里旅行对接入方必须提供的ErrorCode的要求：

注意：Code尽可能细分，msg只作为补充，不作为业务逻辑必要的参数

异常分类	异常情况	备注
secureKey校验不通过
参数校验异常（细分Code）	校验数据格式不合法	手机号码为空手机格式不合法姓名为空姓名格式不合法身份证为空身份证格式不合法其他字段不符合约定
业务异常（细分Code）	手机号码重复	合作伙伴注册新会员时，手机号码在对方会员库已经存在（且姓名不一致，无法认定为老会员，按合作伙伴规则也不能注册为新会员）
系统注册失败（细分Code）		原因1 原因2 原因3 原因4 原因5 原因6

关于此文档暂时还没有FAQ

有用(0) 我要提问