Bốn khả năng quan trọng
Phần tiêu đề “Bốn khả năng quan trọng”| Khả năng | Ý nghĩa | Tại sao sản phẩm bị đình trệ nếu thiếu |
|---|---|---|
| Giá và tình trạng phòng trực tiếp | Giá hiện tại và những gì thực sự có thể đặt được, theo khoảng ngày | Giá lưu cache thất bại khi xác nhận và làm giảm niềm tin |
| Tạo đặt phòng | Tạo một đặt phòng thực sự mà khách sạn nhận được | Nếu không có, bạn chỉ là liên kết giới thiệu, không phải sản phẩm |
| Thanh toán | Nhận tiền như một phần của đặt phòng | Chuyển sang trang khác là nơi chuyển đổi bị mất |
| Xác nhận và webhooks | Thông báo cho khách, khách sạn và hệ thống của bạn về những gì đã xảy ra | Hỗ trợ tải và bù trừ nếu không có |
Hầu hết “API khách sạn” mà nhà phát triển tìm thấy chỉ bao phủ phần đầu tiên và đôi khi phần thứ hai. Giao dịch là phần khó, và đó là phần quyết định bạn có sản phẩm hay không.
Bạn đang tích hợp nguồn cung của ai?
Phần tiêu đề “Bạn đang tích hợp nguồn cung của ai?”Câu hỏi này định hình mọi thứ phía sau. Nguồn cung được bán lại qua chuỗi có giá đã bao gồm phí, tình trạng phòng cũ hơn, và không có đường liên hệ lại khách sạn để hỏi về đặt phòng. Nguồn cung trực tiếp từ khách sạn mang giá của khách sạn, tình trạng phòng trực tiếp và khách sạn biết đặt phòng tồn tại.
Với bất cứ thứ gì mà khách du lịch sẽ so sánh với trang web của khách sạn — mà hầu hết đều vậy — nguồn cung do khách sạn kiểm soát tránh được khoảnh khắc khó xử khi giá của bạn cao hơn.
Ai là người bán chính thức
Phần tiêu đề “Ai là người bán chính thức”Nếu bạn tự xây dựng đặt phòng khách sạn, trở thành người bán chính thức có nghĩa là chịu trách nhiệm thanh toán, hoàn tiền, xử lý thuế và thường phải có giấy phép đại lý du lịch ở mỗi thị trường.
Trên Wink, khách sạn vẫn là người bán chính thức và thanh toán được thu cho khách sạn, nên người tích hợp không phải chịu trách nhiệm này. Các thỏa thuận người bán chính thức có sẵn cho các tích hợp API khi đối tác thực sự cần nhận thanh toán, và con đường đó có yêu cầu giấy phép riêng.
Ba cấp độ tích hợp
Phần tiêu đề “Ba cấp độ tích hợp”- Thành phần web. Thả một tìm kiếm có thể đặt, danh sách phòng hoặc thanh toán vào trang hiện có. Không cần backend; kiểm soát bố cục ít nhất.
- REST API. Kiểm soát đầy đủ tìm kiếm, giá, tạo đặt phòng và xác nhận, xác thực bằng OAuth2. Dùng khi luồng đặt phòng là một phần trải nghiệm của sản phẩm bạn.
- Máy chủ MCP. Các khả năng tương tự được cung cấp cho đại lý AI, để trợ lý có thể tìm kiếm, định giá và hoàn tất đặt phòng thay vì chuyển người dùng sang trang web.
Ba cách này không loại trừ nhau — một sản phẩm thường dùng thành phần cho bề mặt marketing và API cho luồng chính.
Nên xây dựng gì trước
Phần tiêu đề “Nên xây dựng gì trước”- Tìm kiếm và định giá cho một thành phố và một khoảng ngày. Lấy giá thực tế trước khi thiết kế gì.
- Tạo một đặt phòng thử nghiệm từ đầu đến cuối, bao gồm thanh toán và xác nhận.
- Đăng ký
booking.createvà các sự kiện hủy trước khi xây dựng giao diện người dùng. - Quyết định mô hình gán nhãn sớm — ngữ cảnh nguồn cần đi cùng đặt phòng, nếu không báo cáo sẽ chỉ là phỏng đoán sau này.
- Xử lý các trường hợp thất bại: mất tình trạng phòng giữa báo giá và đặt, thanh toán bị từ chối, hoàn tiền một phần.
Giá mà nhà phát triển nên biết
Phần tiêu đề “Giá mà nhà phát triển nên biết”API Consumer và Booking Engine miễn phí. API Partner bao gồm 10.000 đêm khách sạn miễn phí mỗi tháng, sau đó tính phí theo đơn vị. Đặt phòng xác nhận chịu phí nền tảng 1,5% của khách sạn cộng với phí xử lý thẻ theo giá vốn, và hoa hồng mặc định 10% áp dụng khi sản phẩm của bạn tạo ra đặt phòng — đó là cách người tích hợp kiếm tiền thay vì trả tiền.
Những sai lầm phổ biến
Phần tiêu đề “Những sai lầm phổ biến”- Xây dựng trên giá lưu cache. Chúng trông ổn khi phát triển nhưng thất bại khi chạy thực tế.
- Để thanh toán qua chuyển hướng. Mỗi lần chuyển giao mất đặt phòng.
- Bỏ qua webhooks cho đến khi ra mắt. Việc đối chiếu trở thành công việc thủ công.
- Trở thành người bán chính thức khi không cần. Đây là quyết định về giấy phép và trách nhiệm, không chỉ là kỹ thuật.
- Không truyền ngữ cảnh nguồn. Không thể tái tạo gán nhãn sau này.