注意

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

URL

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

入参

字段	类型	是否必须	说明
klookOrderCode	String	true	Klook 订单号。超时情况下，此字段用于强制取消
supplierOrderCode	String	false	供应商订单号
configData	String	false	接入方预取消返回的自定义数据， 长度不超过 64。如果存在，Klook 会将该参数带入取消请求入参

Base 入参扩展字段

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

贡献者: Rich

上一页2.2.2.5: 订单预取消

下一页3.1 订单状态说明