Join our community at https://www.reddit.com/r/HotelByte/

HotelByte
HomepageWaitlist
HomepageWaitlist
Hotel Partners Roadmap
Submit issues
    • 1. Get started
      • Overview
      • Booking flow
      • Certification and Go Live
      • Frequently Asked Questions (FAQ)
    • 2. Guides
      • Quick start
      • Error handling
      • Rate limit
      • Certification cases
      • Test more scenarios
    • 3. API Reference
      • Authentication
        • Ticket
      • Content
        • Destinations
        • HotelStaticDetail
        • HotelsMetadata
      • Search
        • HotelList
        • HotelRates
      • Make bookings
        • CheckAvail
        • Book
      • Manage bookings
        • QueryOrders
        • Cancel
    • Schemas
      • Schemas
      • hotel.common.bff.Table
      • OrderHomeFunctionReq
      • TicketReq
      • TicketResp
      • DestinationInclude
      • DestinationExtra
      • Coordinates
      • CheckAvailReq
      • CheckAvailResp
      • HotelsMetadataListResp
      • HotelsMetadataReq
      • ComputedCancelPolicyItem
      • OrderHomeFunctionResp
      • OriginalRoomNaming
      • Rate
      • CancelResp
      • Tax
      • Holder
      • HotelOrder
      • OrderRoomRefundInfo
      • HotelListReq
      • HotelListResp
      • HotelListBasicInfo
      • BaseHeader
      • BookingHeader
      • ContentHeader
      • HotelMeta
      • DestinationType
      • Guest
      • DestinationsReq
      • DestinationsResp
      • OrderStatus
      • GuestPerRoom
      • RatePkgId
      • RoomRatePkg
      • HotelRatesReq
      • BookReq
      • HotelRatesResp
      • BookResp
      • CancelReq
      • QueryOrdersReq
      • HotelStaticDetailReq
      • QueryOrdersResp
      • HotelStaticDetailResp

    hotel.trade.protocol.BookResp(BookResp)

    {
        "hotelOrder": {
            "status": 0,
            "statusRemark": "aborted",
            "checkIn": "now()",
            "checkOut": "now()+7",
            "nightCount": 0,
            "roomCount": 0,
            "bookingTime": "2026-01-01T10:00:00Z",
            "hotelConfirmNo": "123456",
            "holder": {
                "email": "johndoe@example.com",
                "firstName": "John",
                "lastName": "Doe",
                "phone": {
                    "countryCode": "1",
                    "number": "1234567890"
                }
            },
            "platformReferenceNo": "1234567890",
            "customerReferenceNo": "1234567890",
            "hotel": {
                "hotelId": "string",
                "destinationId": "804028047",
                "name": {
                    "en": "Jumeirah Beach Hotel"
                },
                "rating": 4.5,
                "address": {
                    "en": "Millenium Al Barsha"
                },
                "latlngCoordinator": {
                    "google": {
                        "lat": 25.0478,
                        "lng": 121.5319
                    },
                    "gaode": {
                        "lat": 25.0478,
                        "lng": 121.5319
                    }
                },
                "logoURL": "https://static.hotelbyte.com/Images/Hotel/804028047_1.jpg"
            },
            "rooms": [
                {
                    "roomTypeId": "string",
                    "roomTypeName": {
                        "en": "string",
                        "zh": "string",
                        "ar": "string"
                    },
                    "hotelId": "string",
                    "rates": [
                        {
                            "ratePkgId": "string",
                            "refundableMode": "full",
                            "refundableUntil": "2006-01-02T15:04:05Z07:00",
                            "cancelFees": [
                                {
                                    "until": "2006-01-02T15:04:05Z07:00",
                                    "fee": {
                                        "currency": "string",
                                        "amount": 0
                                    }
                                }
                            ],
                            "originalRoomNaming": {
                                "id": "string",
                                "name": "string",
                                "supplier": 0
                            },
                            "rate": {
                                "commissionableRate": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "netRate": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "grossRate": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "respectGrossRate": true
                            },
                            "totalRate": {
                                "commissionableRate": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "netRate": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "grossRate": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "respectGrossRate": true
                            },
                            "rateComment": "string",
                            "includesPackaging": true,
                            "checkIn": "now()",
                            "checkOut": "now()+7",
                            "board": {
                                "boardId": "RO",
                                "boardName": {
                                    "en": "string",
                                    "zh": "string",
                                    "ar": "string"
                                },
                                "boardDesc": {
                                    "en": "string",
                                    "zh": "string",
                                    "ar": "string"
                                }
                            },
                            "tax": {
                                "total": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "items": [
                                    {
                                        "taxType": "string",
                                        "taxName": "string",
                                        "amount": {
                                            "currency": "string",
                                            "amount": 0
                                        },
                                        "desc": "string"
                                    }
                                ]
                            }
                        }
                    ],
                    "ratePkgId": "string",
                    "refundableMode": "full",
                    "refundableUntil": "2006-01-02T15:04:05Z07:00",
                    "cancelFees": [
                        {
                            "until": "2006-01-02T15:04:05Z07:00",
                            "fee": {
                                "currency": "string",
                                "amount": 0
                            }
                        }
                    ],
                    "originalRoomNaming": {
                        "id": "string",
                        "name": "string",
                        "supplier": 0
                    },
                    "rate": {
                        "commissionableRate": {
                            "currency": "string",
                            "amount": 0
                        },
                        "netRate": {
                            "currency": "string",
                            "amount": 0
                        },
                        "grossRate": {
                            "currency": "string",
                            "amount": 0
                        },
                        "respectGrossRate": true
                    },
                    "totalRate": {
                        "commissionableRate": {
                            "currency": "string",
                            "amount": 0
                        },
                        "netRate": {
                            "currency": "string",
                            "amount": 0
                        },
                        "grossRate": {
                            "currency": "string",
                            "amount": 0
                        },
                        "respectGrossRate": true
                    },
                    "rateComment": "string",
                    "includesPackaging": true,
                    "checkIn": "now()",
                    "checkOut": "now()+7",
                    "board": {
                        "boardId": "RO",
                        "boardName": {
                            "en": "string",
                            "zh": "string",
                            "ar": "string"
                        },
                        "boardDesc": {
                            "en": "string",
                            "zh": "string",
                            "ar": "string"
                        }
                    },
                    "tax": {
                        "total": {
                            "currency": "string",
                            "amount": 0
                        },
                        "items": [
                            {
                                "taxType": "string",
                                "taxName": "string",
                                "amount": {
                                    "currency": "string",
                                    "amount": 0
                                },
                                "desc": "string"
                            }
                        ]
                    },
                    "roomIndex": 0,
                    "guests": [
                        {
                            "roomIndex": 0,
                            "firstName": "John2",
                            "lastName": "Doe",
                            "nationalityCode": "US",
                            "age": 18,
                            "isChild": false
                        }
                    ],
                    "refundInfo": [
                        {
                            "date": "string",
                            "refunded": true,
                            "refundedMoney": {
                                "currency": "string",
                                "amount": 0
                            }
                        }
                    ]
                }
            ]
        }
    }
    Built with