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

Quy Tắc

  • Chống trùng theo requestId — gửi lại cùng requestId và cùng payload trong 10 phút thì nhận lại đúng response cũ, không xử lý lần hai. Khi retry vì timeout, giữ nguyên requestId, chỉ đổi timestamp và ký lại. Chỉ áp dụng cho price-check, bookings/create, bookings/commit, bookings/cancel.

  • Chống trùng theo partnerReference — bookings/create với partnerReference đã có booking sẽ trả lại booking đó.

  • Timeout ở create hoặc commit — không tạo booking mới. Gọi bookings/get theo partnerReference để biết trạng thái thật.

  • Commit song song — nếu một bookings/commit khác cho cùng booking đang chạy, Gotadi trả mã 01 và không trừ tiền lần hai. Nếu Gotadi đã trừ tiền nhưng bước sau gặp lỗi, kết quả là 09 PENDING, không phải lỗi: đừng hoàn tiền cho khách, tra lại bằng bookings/get.

  • Giá — giá ở availability và offers là giá tham khảo có cache. Giá chỉ chốt ở price-check; khách trả đúng totalAmount của booking. price.total là tổng cả kỳ ở, mọi phòng, đã gồm thuế (taxAndFees). totalBeforePromo cùng cơ sở với total, chỉ có khi promo = true.

  • Thời hạn — offerId 30 phút, bookingToken 15 phút, thanh toán trước paymentDeadline trong response create.

  • Giới hạn — availability tối đa 50 masterIds, 30 đêm, 8 phòng. Tần suất gọi theo hợp đồng; vượt thì nhận HTTP 429 từ gateway.

  • Content — đồng bộ toàn bộ danh mục theo countryCode và cursor, lưu ở hệ thống đối tác. Không gọi content/properties trong luồng tìm của khách.

  • Dữ liệu cá nhân — tên, email, số điện thoại khách chỉ dùng cho booking, không ghi log dạng rõ.