订单预订

约 923 字大约 3 分钟

2026-03-27

POST 订单预订

此 API 用于创建酒店订单。

⚠️ 注意：

创建订单前我们会调用【价格确认接口】获取 ReferenceNo，参数携带"PreBook": true。
订单参数会与 PriceConfirm 保持一致（入住日期 / 人数 / 房间数等）

接口地址

POST /booking/HotelBookingConfirm?$format=json

请求参数说明

{
  "CheckOutDate": "2025-12-23",
  "CheckInDate": "2025-12-22",
  "NumOfRooms": 1,
  "GuestList": [
    {
      "RoomNum": 1,
      "GuestInfo": [
        {
          "IsAdult": true,
          "Name": {
            "Last": "四",
            "First": "李"
          }
        },
        {
          "IsAdult": false,
          "Age": 0
        }
      ]
    }
  ],
  "Contact": {
    "Name": {
      "Last": "li",
      "First": "Lucas"
    },
    "Email": "455407767@qq.com",
    "Phone": "19909258553"
  },
  "ClientReference": "251000067",
  "ReferenceNo": "15442173799"
}

属性	类型	必填	说明
CheckOutDate	DateTime	是	离店日期
CheckInDate	DateTime	是	入住日期
NumOfRooms	number	是	房间数
GuestList	List	是	入住人信息
Contact	Object	是	联系人
ClientReference	String	否	商户订单号
ReferenceNo	String	是	价格确认返回

GuestList 说明

属性	类型	必填	说明
RoomNum	number	是	房间序号
GuestInfo	List	是	客人信息

GuestInfo 说明

属性	类型	必填	说明
Name.First	String	否	名
Name.Last	String	否	姓
IsAdult	boolean	是	是否成人
Age	number	否	年龄（儿童必填）
Gender	String	否	性别（M/F）
Phone	String	否	电话
Email	String	否	邮箱

Contact 说明

属性	类型	必填	说明
Name.First	String	是	名
Name.Last	String	是	姓
Phone	String	是	电话
Email	String	是	邮箱

请求示例

curl --location --request POST '{{domain}}/booking/HotelBookingConfirm?$format=json' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"CheckOutDate":"2025-12-23",
"CheckInDate":"2025-12-22",
"NumOfRooms":1,
"GuestList":[
  {
    "RoomNum":1,
    "GuestInfo":[
      {
        "IsAdult":true,
        "Name":{
          "Last":"四",
          "First":"李"
        }
      },
      {
        "IsAdult":false,
        "Age":0
      }
    ]
  }
],
"Contact":{
  "Name":{
    "Last":"li",
    "First":"Lucas"
  },
  "Email":"455407767@qq.com",
  "Phone":"19909258553"
},
"ClientReference":"251000067",
"ReferenceNo":"15442173799"
}'

返回示例

{
  "Success": {
    "BookingDetails": {
      "BookingID": "15442173799",
      "Status": 2,
      "CheckInDate": "2025-12-22 00:00:00",
      "CheckOutDate": "2025-12-23 00:00:00",
      "OrderDate": "2025-10-23 17:46:03.877",
      "NumOfRooms": 1,
      "TotalPrice": 154,
      "GuestList": [
        {
          "RoomNum": 1,
          "GuestInfo": [
            {
              "Name": {
                "First": "李",
                "Last": "四"
              },
              "IsAdult": true
            },
            {
              "Age": 0,
              "IsAdult": false
            }
          ]
        }
      ],
      "Contact": {
        "Name": {
          "First": "Lucas",
          "Last": "li"
        },
        "Phone": "19909258553",
        "Email": "455407767@qq.com"
      },
      "ClientReference": "251000067",
      "Hotel": {
        "HotelID": 1080044,
        "HotelName": "贵族酒店 - 贝斯特韦斯特辛尼雀精选系列",
        "Destination": {
          "CityCode": "178305"
        },
        "RatePlanList": [
          {
            "RoomOccupancy": {
              "RoomNum": 1,
              "AdultCount": 1,
              "ChildCount": 1,
              "ChildAgeDetails": [0]
            },
            "RoomTypeID": 4673056,
            "RatePlanID": "574308669677820045",
            "RatePlanName": "1 King Bed...",
            "Currency": "USD",
            "TotalPrice": 154,
            "PriceList": [
              {
                "Price": 154,
                "StayDate": "2025-12-22 00:00:00"
              }
            ]
          }
        ],
        "CancellationPolicyList": [
          {
            "LocalFromDate": "2026-03-24T23:00:00+07:00",
            "Amount": 154
          }
        ]
      }
    }
  }
}

返回参数说明

属性	类型	必填	说明
BookingID	String	是	订单ID
Status	number	是	订单状态
CheckInDate	DateTime	是	入住日期
CheckOutDate	DateTime	是	离店日期
OrderDate	DateTime	是	下单时间（北京时间）
NumOfRooms	number	是	房间数量
TotalPrice	Decimal	是	订单总价
GuestList	List	是	入住人信息
Contact	Object	是	联系人信息
ClientReference	String	否	商户订单号
CustomerRequest	String	否	特殊需求
Hotel	Object	是	酒店信息
ConfirmationCode	String	否	酒店确认号

GuestList说明

属性	类型	必填	说明
RoomNum	number	是	房间序号
GuestInfo	List	是	客人列表

GuestInfo说明

属性	类型	必填	说明
Name	Object	否	客人姓名
Name.First	String	否	名
Name.Last	String	否	姓
Age	number	否	年龄（儿童必填）
IsAdult	boolean	是	是否成人

Contact 说明

属性	类型	必填	说明
Name	Object	是	联系人姓名
Name.First	String	是	名
Name.Last	String	是	姓
Phone	String	是	电话
Email	String	是	邮箱

Hotel 说明

属性	类型	必填	说明
HotelID	number	是	酒店ID
HotelName	String	是	酒店名称
Destination.CityCode	String	否	城市编码
RatePlanList	List	是	房价信息
CancellationPolicyList	List	否	取消政策

RatePlanList说明

属性	类型	必填	说明
RoomOccupancy	Object	是	入住信息
RoomTypeID	number	否	房型ID
RatePlanID	String	是	房价ID
RatePlanName	String	是	房价名称
Currency	String	是	币种
TotalPrice	Decimal	是	房间总价
PriceList	List	是	每日价格

RoomOccupancy 说明

属性	类型	必填	说明
RoomNum	number	是	房间序号
AdultCount	number	是	成人数
ChildCount	number	是	儿童数
ChildAgeDetails	List	否	儿童年龄

PriceList 说明

属性	类型	必填	说明
Price	Decimal	是	每日价格
StayDate	DateTime	是	日期

CancellationPolicyList 说明

属性	类型	必填	说明
LocalDateTime	String	否	当地酒店时间
Amount	Decimal	否	取消罚金