taobao.xhotel.order.official.qualification.get (官网信用住用户资质校验)

官网信用住在下单前对用户进行资质校验,资质校验通过才能进行信用支付

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
total_fee Number 必须 500 总的收费金额,单位为分(必须)
out_u_u_i_d String 必须 7560267064987558099 外部请求序列表号\流水号,单次请求的唯一标识(必须)
hotel_code String 必须 33 酒店外部编码
check_out Date 必须 2015-12-16 00:00:00 客人离店日期, 最多支持9间夜
id_number String 必须 32456788902134455 身份证号,必选
daily_price_info String 可选 {"day":"2015-08-12","price":48800} 每日房价,json格式 ,如果是多间房,则是每日多间房总房价(可选) * eg:{"day":"2015-08-12","price":48800}, {"day":"2015-08-13","price":48800}
out_member_account String 必须 user_account 外部会员账号(必选)
alipay_account String 可选 13601083144 用户支付宝唯一识别码(可选)
guest_name String 必须 张三 入住人姓名(必选)
encrypt_type Number 可选 0 加密方式, 默认0: 不加密, 信息会通过淘宝开放平台传输, 阿里旅行可以获取到具体信息; * 目前只支持不加密
id_type Number 可选 0 证件类型, 默认0:身份证; 1: 护照; 2:警官证; 3:士兵证; 4: 回乡证。目前只支持身份证
vendor String 可选 taobao 商家在淘宝给分配的渠道名(建议填充较好)
mobile_no String 可选 13601083144 用户手机号(可选)
extend_attrs String 可选 {"is_new_user":"1","is_first_stay":"1"} 扩展字段,json串,用户后续的营销、统计、定制等需求,目前已有key列表: is_new_user:是否是卖家新用户,1-是,0或者key为null,表示不是 is_first_stay:是否是卖家首住,1-是,0或者key为null,表示不是 (已有列表必须传递)
return_url String 必须 http://www.server.com 阿里旅行支付(下单)结束后跳转卖家的页面地址(必须)
notify_url String 必须 http://www.server.com 卖家接收阿里旅行订单状态变更的服务地址(需要实现阿里旅行提供的服务通知规范)
check_in Date 必须 2015-12-16 00:00:00 客人入住日期
out_oid String 必须 2222222 外部订单号(必选),阿里旅行会根据此值进行幂等性校验
room_num Number 可选 1 房间数

响应参数

名称 类型 示例值 描述
reason String 参数错误 无资格原因提示信息
match_condition Boolean true 资质校验是否成功,有资格返回true, 无资格返回false
id_number String 111111111111111111 入参信息回传, 用于校验的证件号码
out_u_u_i_d String 6492410321148894441 * 外部请求序列表号回传\流水号(如果外部订单号唯一,建议外部订单号,这样容易核对问题),用于区别一次请求和排查问题,阿里旅行不做任何格式校验(必须)
out_memeber_account String 3333 入参信息回传,用于校验的外部会员账号
extend_attrs String {"is_new_user":"1","is_first_stay":"1"} 扩展字段,json串,后续留用

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderOfficialQualificationGetRequest req = new XhotelOrderOfficialQualificationGetRequest();
req.setTotalFee(500L);
req.setOutUUID("7560267064987558099");
req.setHotelCode("33");
req.setCheckOut(StringUtils.parseDateTime("2015-12-16 00:00:00"));
req.setIdNumber("32456788902134455");
req.setDailyPriceInfo("{\"day\":\"2015-08-12\",\"price\":48800}");
req.setOutMemberAccount("user_account");
req.setAlipayAccount("13601083144");
req.setGuestName("张三");
req.setEncryptType(0L);
req.setIdType(0L);
req.setVendor("taobao");
req.setMobileNo("13601083144");
req.setExtendAttrs("{\"is_new_user\":\"1\",\"is_first_stay\":\"1\"}");
req.setReturnUrl("http://www.server.com");
req.setNotifyUrl("http://www.server.com");
req.setCheckIn(StringUtils.parseDateTime("2015-12-16 00:00:00"));
req.setOutOid("2222222");
req.setRoomNum(1L);
XhotelOrderOfficialQualificationGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_order_official_qualification_get_response>
    <reason>参数错误</reason>
    <match_condition>true</match_condition>
    <id_number>111111111111111111</id_number>
    <out_u_u_i_d>6492410321148894441</out_u_u_i_d>
    <out_memeber_account>3333</out_memeber_account>
    <extend_attrs>{&quot;is_new_user&quot;:&quot;1&quot;,&quot;is_first_stay&quot;:&quot;1&quot;}</extend_attrs>
</xhotel_order_official_qualification_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isp.system-error 系统错误 联系技术支持

API工具

如何获得此API

FAQ

返回
顶部