Confirm a hotel booking

Finalize a held hotel booking. This is when the total is charged and the reservation is confirmed.

POST/v2/Hotel/HotelOrder

Access requires the permission hotel_order

Call this after the traveller has paid you and before the hold lapses. The booking total is deducted from your office balance and the reservation is confirmed. Miss the window and the hold is released, so you validate the rate and book again.

Two versions. The v1 path /Hotel/HotelOrder is the same operation. New integrations should use the v2 path above.

Path parameters

None.

Query parameters

None.

Body parameters

Name	Type	Required	Description
`SessionId`	string	Yes	Your session id.
`UniqueId`	string	Yes	The booking id from book.

Request

curl -X POST https://api.hermeseus.com/api/v2/Hotel/HotelOrder \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "HB-2026-004417"
  }'

const res = await fetch("https://api.hermeseus.com/api/v2/Hotel/HotelOrder", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "HB-2026-004417"
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.hermeseus.com/api/v2/Hotel/HotelOrder",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "HB-2026-004417",
    },
)

data = res.json()

Response

Field	Type	Description
`Success`	boolean	`true` on success.
`UniqueId`	string	The confirmed booking id.
`Status`	integer	Booking status after confirmation.
`Error`	object	`null` on success.

{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "Status": 20,
  "Error": null
}

This charges the booking. Balance is deducted only here, never at book. Confirm the traveller has paid you before you call it.

Errors

Code	Meaning	Fix
`Err0104002`	Hotel booking not found.	Check the `UniqueId`.
`Err0102003`	The hold lapsed and the rate is gone.	Validate the rate and book again.