For the complete documentation index, see llms.txt. This page is also available as Markdown.

Rules

  • Idempotency by requestId — re-sending the same requestId with the same payload within 10 minutes returns the original response; nothing is processed twice. When retrying after a timeout, keep the requestId and change only timestamp, then re-sign. Applies only to price-check, bookings/create, bookings/commit, bookings/cancel.

  • Idempotency by partnerReference — bookings/create with a partnerReference that already has a booking returns that booking.

  • Timeout on create or commit — do not create a new booking. Call bookings/get by partnerReference to learn the real state.

  • Concurrent commit — if another bookings/commit for the same booking is running, Gotadi returns code 01 and does not charge twice. If Gotadi charged but a later step failed, the result is 09 PENDING, not an error: do not refund the guest, re-check with bookings/get.

  • Pricing — prices from availability and offers are cached indicative prices. The price is binding only at price-check; the guest pays exactly the booking's totalAmount. price.total covers the whole stay, all rooms, taxes included (taxAndFees). totalBeforePromo uses the same basis as total and exists only when promo = true.

  • Lifetimes — offerId 30 minutes, bookingToken 15 minutes, payment before the paymentDeadline returned by create.

  • Limits — availability accepts at most 50 masterIds, 30 nights, 8 rooms. Call rates follow the contract; exceeding them returns HTTP 429 from the gateway.

  • Content — sync the whole catalogue by countryCode and cursor and store it on your side. Do not call content/properties inside 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