2.2.2.6 订单取消
约 442 字大约 1 分钟
2025-11-04
注意
- 必须.
- 取消订单如果返回是
cancelPending状态,接入方需要支持多次取消 - 如果是下单超时,此时无供应商订单号,若后续查询订单详情也无法获取最终的订单状态,则走强制取消(此时只有klook的订单号)
URL
接入方自行定义并提供给klook
入参
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
klookOrderCode | String | true | Klook 订单号。超时情况下,此字段用于强制取消 |
supplierOrderCode | String | false | 供应商订单号 |
configData | String | false | 接入方预取消返回的自定义数据,长度不超过 64。如果存在,Klook 会将该参数带入取消请求入参 |
Base 入参扩展字段
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
supplierAccount | String | false | openApi 供应商账号数据 接入方自行定义账号数据1:账号是为了处理供应商不同账号下资源露出不同的问题,支持多账号2:若接入方无多账号,则传值为null3:长度不超过128字符串 |
入参示例
示例
{
"base": {
"requestId": "xxxx",
"requestTime": "xxx",
"requestAgent": "xxx",
"openApiSign": "xx",
"supplierAccount": "account1",
"version": "xxx"
},
"requestData": {
"supplierOrderCode": "SUPPLIERORDER987",
"klookOrderCode": "KLOOKORDER12345",
"configData": "AAAABBBDDDBBDDDDDDD"
}
}出参
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
supplierOrderCode | String | true | 供应商订单号 |
hotelCancelCode | String | false | 酒店取消订单号 |
status | String | true | 取消状态。 请参考3.1 订单状态说明 |
出参示例
取消成功示例
{
"success": true,
"error": {
"code": "",
"message": ""
},
"result": {
"supplierOrderCode": "XYZ123456",
"hotelCancelCode": "h-XYZ123456-cancel",
"status": "cancelSuccess"
}
}取消失败示例
{
"success": true,
"error": {
"code": "",
"message": ""
},
"result": {
"status": "cancelFailed"
}
}取消异常示例
{
"success": false,
"error": {
"code": "异常码",
"message": "异常信息"
},
"result": null
}