2.3.5 订单取消
约 376 字大约 1 分钟
2025-04-24
提示
- 必须.
- 取消订单如果返回是
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
}