Understanding the Booking Webhook¶

What does it do?¶

Once a customer has selected a rate and completed the purchase, we’ll create a booking for their journey. At this point, the booking will be allocated to a supply partner and our API will issue a “webhook” to inform you of the booking.

Why use it?¶

Our booking webhook enables you to create an endpoint that we can make a request to in order to inform you that you’ve been allocated a new booking. You can then use this information to update your systems as necessary.

How does it work?¶

The webhook endpoint must be secured using our recommended OAuth flow (documented separately) as the payload data contains personal information. Once you’ve implemented the booking webhook contract, you’ll need to provide us with the URI. Booking.com Taxi will then send you a booking request, the payload will contain all the information you require for the booking. You do not need to respond to the booking webhook.

It’s important to note that webhooks are considered “fire & forget” therefore we do not guarantee delivery of the payloads. You shouldn’t rely solely on the booking webhook to be informed of new bookings, you should also make use of our “/v1/bookings” endpoint.

Your API should be served via HTTPS with a valid SSL certificate.