接口对接流程图

一、对接全景

对接方在自己的平台完成展示、收款，酒店 API 提供查询、下单、查单、退单能力。

所有请求均需携带签名参数 appId / timestamp / nonce / sign（生成规则见《签名鉴权文档.md》）。

二、查询流程

合作方引导用户选城市 → 选酒店 → 选房型，全程只读。

三、下单流程

用户支付完成后，合作方用渠道单号调创建订单接口（幂等，重复调用不会重复建单）。

四、查单 / 退单流程

订单确认、入住等状态变更通过查单接口获取；退订通过取消接口完成。

五、取消 / 退单异常处理

用户申请取消订单失败或报错时：

请联系我方客服协助处理；

如订单涉及罚金，由双方线下协商处理。

六、接口清单与对接顺序

步骤	接口	说明	前置
1	`GET /api/data/cities`	支持城市列表	无
2	`GET /api/data/businessCircles/{cityCode}`	城市商圈字典	城市
3	`GET /api/data/brands`	酒店品牌列表（分页）	无
4	`GET /api/hotel/search`	酒店列表搜索（cityCode 必填）	城市
5	`GET /api/hotel/detail`	酒店详情 + 房型报价 + 三价	hotelId
6	`GET /api/hotel/ratePlan`	房型/产品/间夜价格明细	hotelId
7	`POST /api/order/create`	创建订单（服务端定价）	第 5/6 步选定的 hotelId/roomTypeId/keyId
8	`GET /api/order/detail`	查单（订单状态 + 退改规则）	channelOrderNo
9	`POST /api/order/cancel`	退单（remark 必填）	channelOrderNo
10	`GET /api/channel/balance`	渠道账户余额	无

对接顺序建议：先 cities/brands 拿字典 → search 选酒店 → detail/ratePlan 拿房型报价 → 用户支付后 order/create 下单 → order/detail 跟踪状态 → 需要时 order/cancel 退单。

接口对接流程图

一、对接全景#

二、查询流程#

三、下单流程#

四、查单 / 退单流程#