文档中心 > 酒店客栈-线上预订

飞猪旅行酒店会员对接

更新时间:2017/03/01 访问次数:11089

商家提供给航旅会员绑定服务(HTTPS)

触发场景:

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

业务逻辑:

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

HTTPS接口描述:

  • URL:https://${domain}/${service}
  • 请求方式:POST
  • 性能要求:800ms
  • 输入、输出编码格式都是UTF-8
  • POST内容:经过urlencode,接收放需要urldecode取出数据

请求参数

名称

类型

是否必须

说明

描述

taobaoId

Long

 

淘宝用户ID,例如:123456

suggestLevel

String

 

接入方对接等级建议:V1~V999

具体参考接入方等级说明

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版本引入

接口对接用的唯一标识

 返回:

  • 输出参数:utf-8编码,不需要urlencode给我们
  • 输出参数为JSON串,形式如下:                                                    

           正常返回:{"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 

技术需要约定的配置

  • 绑定会员需要的相关字段,阿里(用户名称,手机,或身份证号),合同中约定。
  • 唯一性判断标准
  • 阿里旅行给接入方发送消息的编码格式
  • 阿里旅行接收的编码格式
  • 接入方提供的https服务地址,证书不要客户端验证。也可提供http服务地址
  • 双方等级的映射关系,相应等级的权益的文案 (PD/BD提供)

FAQ

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