提示

• 必须.
• 取消订单如果返回是cancelPending状态，接入方需要支持多次取消
• 如果是下单超时,此时无供应商订单号,若后续查询订单详情也无法获取最终的订单状态,则走强制取消(此时只有klook的订单号)

URL

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

入参

取消订单接口响应参数

字段	类型	是否必须	说明
klookOrderCode	String	true	klook 订单号
hotelId	String	true	供应商酒店 id 1：部分托管供应商使用的是 klook 酒店为主，则此处使用 klook 酒店 id参考 idType
supplierOrderCode	String	false	供应商订单号,下单超时时无供应商订单号,走强制取消

入参示例

示例

{
    "base": {
        "requestAgent": "KLOOK",
        "openApiSign": "301e4cfefbc376c4f4c4dac8b096efcdee47810c2a3627b29b2d3a66b8ae04af27f4ff38c4a8d40dff48f6729fe0d7959fdd90f1848f25c595b574872b8ec69a",
        "requestId": "xxxxx111bbbbbcccc",
        "requestTime": "2025-11-28T12:06:15.890+08:00"
    },
    "requestData": {
         "hotelId":"",
         "supplierOrderCode":"",
         "klookOrderCode":"" //超时情况下 强制取消
    }
}

Curl示例说明

curl --location 'https://api.klookxxxxxxx.com.tw/xxxx/klook/cancelOrder' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic T3BlbkFwaUtsb29rOxxxkQxxxxxx==' \
--data '{
    "base": {
        "openApiSign": "ed55b368d26a9c2be0f7bcfda2e174e31e7d31f59a48685e6f8a7ecbddd63bd05bf61292b19297caa30280bc900a66259829f17a",
        "requestAgent": "KLOOK",
        "requestId": "BB1CEDE37C214219BE7C32468173D4B1",
        "requestTime": "2025-06-18T11:59:59.045Z"
    },
    "requestData": {
        "hotelId": "4054",
        "klookOrderCode": "GFE439622",
        "supplierOrderCode": "m20250618xxxsP"
    }
}'

出参

字段	类型	是否必须	说明
status	String	true	取消状态 - 见 3.1 订单状态 service_error, system_maintenance, cancelSuccess, cancelPending, cancelFailed

出参示例

取消成功示例

{
  "success": true,
  "error": {
    "code": "",
    "message": ""
  },
  "result": {
    "status": "cancelSuccess"
  }
}

取消失败示例

{
  "success": true,
  "error": {
    "code": "",
    "message": ""
  },
  "result": {
    "status": "cancelFailed"
  }
}

取消异常示例

{
  "success": false,
  "error": {
    "code": "异常码",
    "message": "异常信息"
  },
  "result": null
}

贡献者: Rich, lei.zhong

上一页2.3.4: 订单预取消

下一页3.1 订单状态说明