---

POST 订单预取消

此 API 用于预取消订单，返回取消罚金及取消确认号（ConfirmID）。

⚠️ 注意：

• 此接口 不是真正取消订单
• 需要调用两个接口：
  1. 预取消（当前接口）
  2. 确认取消（下一步接口）

---

重要说明

• 返回的 ConfirmID 是取消确认的关键参数
• ConfirmID 有效期至少：10分钟
• 超时会重新调用本接口获取新的 ConfirmID

---

接口地址

POST /booking/HotelBookingCancel?$format=json

请求参数说明

{
  "BookingID": "15442173799",
  "ConfirmID": null
}

属性	类型	必填	说明
BookingID	String	是	订单号
ConfirmID	String	否	取消确认号（预取消时传 null）

---

请求示例

curl --location --request POST '{{domain}}/booking/HotelBookingCancel?$format=json' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "BookingID":"15442173799",
  "ConfirmID": null
}'

---

返回示例

{
  "Success": {
    "BookingID": "15442173799",
    "ConfirmID": "DCC251023174704250",
    "Currency": "USD",
    "Amount": 0
  }
}

---

返回参数说明

属性	类型	必填	说明
BookingID	String	是	订单ID
ConfirmID	String	是	取消确认号（10分钟有效）
Currency	String	是	币种
Amount	Decimal	是	取消罚金

上一页订单查询

下一页预取消