Rules
Idempotency by
requestId— re-sending the samerequestIdwith the samepayloadwithin 10 minutes returns the original response; nothing is processed twice. When retrying after a timeout, keep therequestIdand change onlytimestamp, then re-sign. Applies only toprice-check,bookings/create,bookings/commit,bookings/cancel.Idempotency by
partnerReference—bookings/createwith apartnerReferencethat already has a booking returns that booking.Timeout on
createorcommit— do not create a new booking. Callbookings/getbypartnerReferenceto learn the real state.Concurrent commit — if another
bookings/commitfor the same booking is running, Gotadi returns code01and does not charge twice. If Gotadi charged but a later step failed, the result is09 PENDING, not an error: do not refund the guest, re-check withbookings/get.Pricing — prices from
availabilityandoffersare cached indicative prices. The price is binding only atprice-check; the guest pays exactly the booking'stotalAmount.price.totalcovers the whole stay, all rooms, taxes included (taxAndFees).totalBeforePromouses the same basis astotaland exists only whenpromo = true.Lifetimes —
offerId30 minutes,bookingToken15 minutes, payment before thepaymentDeadlinereturned bycreate.Limits —
availabilityaccepts at most 50masterIds, 30 nights, 8 rooms. Call rates follow the contract; exceeding them returns HTTP 429 from the gateway.Content — sync the whole catalogue by
countryCodeandcursorand store it on your side. Do not callcontent/propertiesinside the guest search flow.Personal data — guest names, emails and phone numbers are used for the booking only; never log them in clear text.
Cập nhật lần cuối