注意

• 必须.
• 以下场景会触发订单详情查询
  1. 下单接口超时
  2. 下单接口返回bookPending状态,klook会在接下来的30分钟内查询30次订单详情,以便获取最新的订单状态`
• 需要支持仅klook订单号查询订单的能力,因为存在下单接口超时情况下无供应商订单号
• 订单查询status永远返回订单最新的状态.比如先下单后取消,查询订单状态会返回cancelSuccess状态

URL

接入方自行定义并提供给klook

入参

字段	类型	是否必须	说明
klookOrderCode	String	true	Klook 订单号
supplierOrderCode	String	false	供应商订单号 下单接口超时情况下查询订单详情时可无此字段

Base 入参扩展字段

字段	类型	是否必须	说明
supplierAccount	String	false	openApi 供应商账号数据 接入方自行定义账号数据 1:账号是为了处理供应商不同账号下资源露出不同的问题,支持多账号 2:若接入方无多账号，则传值为null 3:长度不超过128字符串

入参示例

示例

{
    "base": {
        "requestId": "xxxx",
        "requestTime": "xxx",
        "requestAgent": "xxx",
        "openApiSign": "xx",
        "supplierAccount": "account1",
        "version": "xxx"
    },
    "requestData": {
        "klookOrderCode": "KLOOKORDER12345",
        "supplierOrderCode": "SUPPLIERORDER987"
    }
}

出参

字段	类型	是否必须	说明
supplierOrderCode	String	true	供应商订单号
supplierConfirmCode	String	false	供应商确认号
hotelConfirmCode	String	false	酒店确认号，如果有多个逗号分割
status	String	true	订单状态 请参考3.1 订单状态说明
hotelId	String	true	接入方酒店 ID
roomId	String	true	接入方房型 ID
ratePlanId	String	true	接入方 Rate Plan ID
checkIn	String	true	入住时间，格式：yyyy-MM-dd
checkOut	String	true	离店时间，格式：yyyy-MM-dd
currency	String	true	标准币种三字码
contact	Contact	true	联系人信息 默认语言是en_US
specialRequest	String	false	特殊要求 默认语言是en_US
rooms	List<Room>	true	入住信息List size = 房间数量
cancelPolicyList	List<CancelPolicy>	false	取消政策列表 1：需按照起始时间start从小到大排列列表 2：为空代表不可取消 3：start之前的时间段，Klook 侧会全部当成免费取消处理
mealInfo	MealInfo	false	餐食若未给餐食，统一当成无餐食处理
totalPrice	TotalPrice	true	总房间价

Contact

字段	类型	是否必须	说明
firstName	String	true	名
lastName	String	true	姓
email	String	true	邮箱
phone	String	true	电话

Room

字段	类型	是否必须	说明
guests	List<Guest>	true	入住人信息

Guest

字段	类型	是否必须	说明
firstName	String	true	名
lastName	String	true	姓

CancelPolicy

字段	类型	是否必须	说明
start	String	true	起始时间 需带上时区，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
end	String	true	结束时间 需带上时区，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
amount	String	true	金额 (罚金)

MealInfo

字段	类型	是否必须	说明
mealCode	String	true	接入方的餐食类型 Klook会根据字典进行转换 (dataType = 8)
mealCount	integer	false	餐食份数 为空或 -1 或 -100 时, Klook 侧目前会全部处理成餐食份数 = 人数

TotalPrice

字段	类型	是否必须	说明
amountBeforeTax	String	false	税前价单位：元
amountAfterTax	String	true	税后价单位：元
commission	String	false	佣金 若接入方能提供，则使用接入方的佣金,否则 Klook 按商户合作的设定自行计算

出参示例

示例

{
  "success": true,
  "error": {
    "code": "",
    "message": ""
  },
  "result": {
    "supplierOrderCode": "SUPPLIERORDER987",
    "supplierConfirmCode": "CONFIRM12345",
    "hotelConfirmCode": "HOTELCFM6789",
    "status": "bookSuccess",
    "hotelId": "26546159",
    "roomId": "room1",
    "ratePlanId": "AABBCC",
    "checkIn": "2025-05-26",
    "checkOut": "2025-05-28",
    "currency": "CNY",
    "contact": {
      "firstName": " ",
      "lastName": " ",
      "email": " ",
      "phone": " "
    },
    "specialRequest": " ",
    "rooms": [
      {
        "guests": [
          {
            "firstName": " ",
            "lastName": " "
          }
        ]
      }
    ],
    "cancelPolicyList": [
      {
        "amount": "449.10",
        "start": "2022-11-25T12:00:00.000+08:00",
        "end": "2025-08-20T00:00:00.000+08:00"
      }
    ],
    "mealInfo": {
      "mealCode": "breakfast",
      "mealCount": 1
    },
    "totalPrice": {
      "amountBeforeTax": "45",
      "amountAfterTax": "50",
      "commission": "0.55"
    }
  }
}

贡献者: Rich

上一页2.2.2.3 订单创建

下一页2.2.2.5: 订单预取消