查询速住订单
接口说明
| 接口url | https://api.mch.weixin.qq.com/wxv/queryhotelbill |
|---|---|
请求方式 |
POST |
传输格式 |
XML |
注意事项
- 当返回错误码为“SYSTEMERROR”时，请不要更换商户订单号，一定要使用原商户订单号重试，否则可能造成重复支付等资金风险。
- XML具有可扩展性，因此返回参数可能会有新增，而且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请商户务必不要换单重试，请商户联系客服确认付款情况。如果有新回包字段，会更新到此API文档中。
- 因为错误代码字段err_code的值后续可能会增加，所以商户如果遇到回包返回新的错误码，请商户务必不要换单重试，请商户联系客服确认付款情况。如果有新的错误码，会更新到此API文档中。
- 错误代码描述字段err_code_des只供人工定位问题时做参考，系统实现时请不要依赖这个字段来做自动化处理。
是否需要证书
是，详见证书说明
前置条件
商户下单待受理后。
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 接口版本号 | version | 是 | String(32) | 1.0 | 接口版本号，默认值1.0 |
| 公众账号ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信公众平台分配的与传入的商户号建立了支付绑定关系的appid，可在公众平台查看绑定关系 需要在本系统先进行配置. 需要与创建订单时保持一致. |
| 商户号 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商户号 需要在本系统先进行配置. 需要与创建订单时保持一致. |
| 随机字符串 | nonce_str | 是 | String(32) | ibuaiVcKdpRxkhJA | 随机字符串，长度要求在32位以内。推荐随机数生成算法 |
| 签名 | sign | 是 | String(128) | 029B52F67573D7E3BE74904BF9AEA | 通过签名算法计算得出的签名值，详见签名生成算法 |
| 签名类型 | sign_type | 是 | String(32) | HMAC-SHA256 | 签名类型，仅支持HMAC-SHA256 |
| 商户服务订单号 | out_order_no | 只允许二选一 | String(32) | 1234323JKHDFE1243252 | 商户系统内部服务订单号（不是交易单号），，要求32个字符内，只能是数字、大小写字母_-|* 且在同一个商户号下唯一。详见商户订单号 需要和创建租借订单的商户服务订单号一致 |
| 回跳查询id | return_query_id | String | jm3WvLD7qZf2mSv8hLTmtig2nqVRkakfkgryG/OgW94= | 微信侧回跳到商户前端时用于查单的单据查询id.详见章节”小程序跳转接口.回跳商户接口” | |
| 服务ID | service_id | 是 | String(32) | 该服务ID有本接口对应产品的权限 需要与创建订单时保持一致. |
返回参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信标识，非业务标识，是否成功需要查看result_code来判断 |
| 返回结果 | return_msg | 否 | String(128) | 签名失败 | 返回信息，如非空，为错误原因，如签名失败，参数格式校验错误 |
以下字段在return_code为SUCCESS的时候有返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 签名 | sign | 是 | String(128) | 029B52F67573D7E3BE74904BF9A | 通过签名算法计算得出的签名值，详见签名生成算法 |
| 随机字符串 | nonce_str | 是 | String(32) | ibuaiVcKdpRxkhJA | 随机字符串，长度要求在32位以内。推荐随机数生成算法 |
| 业务结果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 查询成功返回SUCCESS,否则返回FAIL. FAIL情况需要根据err_code进行不同处理. |
| 错误代码 | err_code | 否 | String(32) | SYSTEMERROR | 错误码，详见错误码说明 |
| 错误描述 | err_code_des | 否 | String(128) | 系统错误 | 错误信息描述 |
| 公众账号ID | appid | 是 | String(32) | wxd678efh567hg6787 | 调用接口提交的公众账号ID |
| 商户号 | mch_id | 是 | String(32) | 1230000109 | 调用接口提交的商户号 |
| 商户服务订单号 | out_order_no | 是 | String(32) | 1234323JKHDFE1243252 | 调用接口提交的商户服务订单号 |
| 服务ID | service_id | 是 | String(32) | 调用该接口提交的服务ID |
以下字段当return_code、result_code都为SUCCESS时有返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 单据状态 | state | 是 | String(32) | CREATED | 表示当前单据状态. CREATED:商户下单已受理 USER_ACCEPTED:用户成功使用服务 FINISHED:商户完结订单 USER_PAID:用户订单支付成功 REVOKED:商户撤销订单 EXPIRED:订单已失效. “商户下单已受理”状态超过1小时未变动，则订单失效 |
| 房间 | room | 是 | String(40) | 几木双床房2间 | 订单房间信息 |
| 入住时间 | start_time | 是 | String(14) | 20091225091010 | 订单入住时间，根据商户传入格式返回 |
| 预定离店时间 | end_time | 否 | String(14) | 20091225091010 | 订单预定离店时间，根据商户传入格式返回 |
| 酒店 | service_location | 是 | String(20) | 北京亦庄亚朵酒店 | 订单酒店名称 |
| 押金 | deposit_amount | 是 | int | 50000 | 整数展示,单位为人民币:分 |
| 房费 | room_rate | 是 | int | 30000 | 整数展示,单位为人民币:分 |
| 房费说明 | room_rate_desc | 是 | String(30) | 标间1晚 | 房费说明 |
| 实际离店时间 | real_end_time | 否 | String(14) | 20091225091010 | 订单实际离店时间，根据商户传入格式返回 |
| 是否入住 | checked_in | 是 | Bool | true | 是否入住:true 是 ,false 否 |
| 其他费用 | other_fee | 否 | int | 1000 | 存在其他费用时返回. 整数展示,单位为人民币:分 |
| 其他费用说明 | other_fee_desc | 否 | String(30) | XX消费 | 存在其他费用时返回 |
| 赔偿金费用 | compensation_fee | 否 | int | 10000 | 存在赔偿费用时返回 整数展示,单位为人民币:分 |
| 赔偿金说明 | compensation_fee_desc | 否 | String(30) | 打破房间杯子一个 | 存在赔偿金时返回 |
| 延迟退房费 | overdue_fine | 否 | int | 10000 | 存在延迟退房费用时返回 整数展示,单位为人民币:分 |
| 延迟退房说明 | overdue_fine_desc | 否 | String(30) | 延迟退房2小时，增加50元房费 | 存在延迟退房费用时返回 |
| 取消费用 | cancel_fee | 否 | int | 10000 | 存在取消费用时返回 整数展示,单位为人民币:分 |
| 取消费用说明 | cancel_fee_desc | 否 | String(30) | 存在取消费用时返回 | |
| 微信支付服务订单号 | order_id | 是 | String(128) | 微信支付服务订单号 每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应 | |
| 完结凭证 | finish_ticket | 是 | String(512) | 用于完结订单时传入,确保订单完结时数据完整. 只有单据状态为USER_ACCEPTED才返回完结凭证 | |
| 回调数据包 | attach | 否 | String(200) | 回调数据包 | |
| 结单交易单号 | finish_transaction_id | 否 | String(200) | 结单交易单号，等于普通支付接口中的transaction_id，可以使用该订单号在APP支付->API列表->查询订单、申请退款。只有单据状态为USER_PAID，且收款成功渠道为支付分渠道，收款金额大于0，才会返回结单交易单号。 | |
| 支付方式 | pay_type | 否 | string | MchChannelPayType | 支付方式，枚举值： MchChannelPayType-商户渠道类型 |
错误码
| 名称 | 描述 | 原因 | 解决方案 |
|---|---|---|---|
| SYSTEMERROR | 系统错误 | 系统超时 | 系统异常，请使用相同参数稍后重新调用 |
| PARAM_ERROR | 参数错误 | 请求参数不合法 | 请使用正确的参数重新调用 |
| INVALID_REQUEST | 无效的请求 | 商户没有接口权限 重入情况下参数不一致 | 请申请接口权限 请确认相同单号是否使用了不同的参数 |
| ORDERNOTEXIST | 单据不存在 | 查询单据不存在 | 确认入参,传入正确单据 |
| RATE_LIMITED | 频率限制 | 超过接口调用频率限制 | 请求量不要超过XX/XX |