/booking_cancel_v7

Booking cancel requests are sent by adding /booking_cancel to your endpoint and sending the parameters explained below in a POST request.

The "booking_cancel" API call will allow travelers to cancel their reservations directly from their TripAdvisor login page. This is a major convenience for travelers that delivers a positive user experience, which in turn greatly increases the value of the overall offering provided by Partners to participating hotels.

Request

https://partner-site.com/api_implementation/booking_cancel

ContentType: application/json

{
  "partner_hotel_code": "sfssc1",
  "reservation_id": "AB0006"
}

Properties

Field Type Description
partner_hotel_code string
The partner specific code for this hotel.
reservation_id string
Unique partner identifier for the reservation.

Response

ContentType: application/json

{
"partner_hotel_code": "sfssc1",
"reservation_id": "AB0006",
"status": "Success",
"cancellation_number": "12345678",
"customer_support": { "phone_numbers": [ { "contact": "5555555555", "description": "Phone" } ], "emails": [ { "contact": "paul.revere@tripadvisor.com", "description": "Email" } ], "urls": [ { "contact": "http://www.tripadvisor.com", "description": "Url" } ] }
}

 

Properties

Field Type Description
partner_hotel_code string
Echo the partner_hotel_code in the request by TripAdvisor.
reservation_id string
Echo the reservation_id in the request by TripAdvisor.
status string
An overall status of the booking. One of the following:
 
  • Success
  • AlreadyCancelled
  • CannotBeCancelled
  • UnknownReference
  • Error
cancellation_number string
The associated cancellation number. Required if status is Success or AlreadyCancelled.
customer_support CustomerSupport  

[Optional]. An object containing the hotel’s customer support contact information for guests. We recommend returning this on both successes and failures.