Tích hợp Expedia Rapid API
Tích hợp API Expedia: Rapid API, luồng đặt phòng và chạy thật
Mọi điều một OTA, đại lý hay startup du lịch cần để kết nối Expedia Group: API Expedia nào phù hợp với mô hình kinh doanh, luồng đặt phòng Rapid và chữ ký hoạt động ra sao, vòng duyệt ra mắt kiểm tra những gì, chi phí bao nhiêu, và PHPTRAVELS giúp bạn chạy thật thế nào với luồng khách sạn đã được xây dựng sẵn.
- Rapid Lodging API
- API key và chữ ký SHA-512
- Sandbox và đặt phòng thử
- Duyệt ra mắt và chạy thật
Các API của Expedia Group
API Expedia nào phù hợp với doanh nghiệp của bạn
Expedia Group vận hành các chương trình API riêng cho bên bán, đối tác liên kết, khách sạn và đại lý du lịch. Hãy chọn dựa trên một câu hỏi trước tiên: khách du lịch thanh toán ở đâu?
- Phía cầu
Rapid API
Trọng tâm của chúng tôi- Dành cho
- OTA, đại lý du lịch, ứng dụng du lịch và chương trình khách hàng thân thiết bán du lịch dưới thương hiệu riêng.
- Bạn nhận được
- Kho phòng Expedia trực tiếp và toàn bộ luồng đặt chỗ: tìm kiếm, kiểm tra giá, đặt phòng, thay đổi và hủy.
- Nơi khách đặt
- Trên website hoặc ứng dụng của bạn, trong trang thanh toán của chính bạn.
- Với PHPTRAVELS
- Luồng khách sạn đã có sẵn trong mô-đun lưu trú; bạn chỉ cần cấu hình, mapping và chứng nhận.
- Phía liên kết
Travel Redirect API
- Dành cho
- Trang nội dung, blog du lịch và trang dạng metasearch kiếm hoa hồng từ lượt giới thiệu.
- Bạn nhận được
- Danh sách lưu trú và chuyến bay để hiển thị trên trang của bạn, kèm liên kết tới thương hiệu Expedia bạn chọn.
- Nơi khách đặt
- Trên Expedia, Hotels.com hoặc Vrbo, sau khi chuyển hướng.
- Với PHPTRAVELS
- Dùng được dưới dạng danh sách và liên kết trên website PHPTRAVELS; không có đặt chỗ trên website của bạn.
- Phía cung
API cung ứng và kết nối
- Dành cho
- Khách sạn, hệ thống quản lý cơ sở lưu trú và channel manager.
- Bạn nhận được
- Đẩy giá, tình trạng phòng và điều kiện hạn chế lên Expedia, đồng thời lấy về các đặt phòng Expedia nhận được.
- Nơi khách đặt
- Trên Expedia; cơ sở lưu trú nhận đặt phòng.
- Với PHPTRAVELS
- Dành cho khách sạn bán trên Expedia qua extranet hoặc channel manager.
- Đại lý du lịch
Expedia TAAP
- Dành cho
- Đại lý du lịch đặt chỗ cho khách hàng và nhận hoa hồng.
- Bạn nhận được
- Cổng đại lý của Expedia với giá đại lý và theo dõi hoa hồng.
- Nơi khách đặt
- Trong cổng TAAP, do đại lý đặt.
- Với PHPTRAVELS
- Đại lý có thể ghi nhận đặt chỗ TAAP trong hệ thống quản trị của bạn; con đường API là Rapid.
Expedia đã tạm dừng nhận đơn đăng ký Travel Redirect API mới do lượng yêu cầu quá lớn.
Các sản phẩm Rapid API
- Rapid Lodging APICó sẵn trong PHPTRAVELS
- Rapid Car APITích hợp tùy chỉnh
- Rapid Flight APITích hợp tùy chỉnh
- Rapid Activities APITích hợp tùy chỉnh
Khách sạnChương trình tiếp thị liên kết du lịchExpedia ExtranetTích hợp API Expedia TAAPTích hợp API tùy chỉnh
Luồng đặt phòng Rapid
Một lượt đặt phòng khách sạn Expedia diễn ra qua từng lệnh gọi
Đặt phòng Rapid Lodging đi theo một chuỗi cố định. Chọn một bước để xem lệnh gọi, cách PHPTRAVELS xử lý và những điểm cần lưu ý khi chứng nhận.
Lệnh gọi Rapid
GET /v3/properties/content- PHPTRAVELS xử lý
- Nhập tên cơ sở lưu trú, địa chỉ, hình ảnh, tiện nghi, loại phòng và chính sách vào các trang khách sạn, và làm mới theo lịch.
- Lưu ý
- Dùng tệp nội dung cơ sở lưu trú cho toàn bộ danh mục và API nội dung cho cập nhật; không bao giờ lấy nội dung từ phản hồi tìm kiếm.
Lệnh gọi Rapid
GET /v3/properties/availability- PHPTRAVELS xử lý
- Tìm theo ngày, số khách và ID cơ sở lưu trú, rồi hiển thị từng phòng kèm giá, thuế và phí, cùng chính sách hủy.
- Lưu ý
- Hiển thị tổng giá gồm thuế và phí trước khi thanh toán, và gửi IP cùng header phiên của khách trong mọi yêu cầu.
Lệnh gọi Rapid
GET {price_check link}- PHPTRAVELS xử lý
- Gọi liên kết kiểm tra giá của mức giá đã chọn ngay trước khi thanh toán, và chỉ tiếp tục khi giá khớp.
- Lưu ý
- Giá thay đổi hoặc hết phòng phải dừng thanh toán và đưa ra lựa chọn mới, tuyệt đối không thu theo giá cũ.
Lệnh gọi Rapid
POST /v3/itineraries- PHPTRAVELS xử lý
- Tạo hành trình với thông tin khách và thanh toán, lưu ID hành trình Expedia và gửi voucher.
- Lưu ý
- Các mức giá cho phép giữ chỗ hỗ trợ mô hình hai bước: giữ phòng không thu tiền, sau đó tiếp tục để hoàn tất đặt phòng.
Lệnh gọi Rapid
GET /v3/itineraries/{itinerary_id}- PHPTRAVELS xử lý
- Đọc lại hành trình để xác nhận ngày, phòng, giá, số xác nhận và trạng thái trong trang quản trị.
- Lưu ý
- Sau khi hết thời gian chờ, hãy truy xuất trước và chỉ thử lại nếu chưa có hành trình, để khách không bao giờ bị đặt hai lần.
Lệnh gọi Rapid
DELETE /v3/itineraries/{id}/rooms/{room_id}- PHPTRAVELS xử lý
- Thực hiện thay đổi và hủy từ trang quản trị và tài khoản khách hàng, theo chính sách của mức giá.
- Lưu ý
- Phí phạt lấy từ chính sách hủy của mức giá; hãy hiển thị cho khách trước khi xác nhận.
Lệnh gọi Rapid
POST https://your-site/webhooks/expedia- PHPTRAVELS xử lý
- Nhận sự kiện webhook về thay đổi hành trình tại một URL trong bản cài đặt của bạn và cập nhật đặt phòng.
- Lưu ý
- Phản hồi webhook nhanh chóng, và coi bản ghi của Expedia là nguồn chuẩn cho trạng thái.
Đường dẫn lệnh gọi theo tài liệu Rapid v3; luôn kiểm tra Expedia Group Developer Hub phiên bản mới nhất.
API key và chữ ký
Cách xác thực Expedia Rapid API hoạt động
Mỗi yêu cầu Rapid mang một header xác thực chứa API key và chữ ký của bạn: chữ ký là hàm băm SHA-512 của API key, shared secret và dấu thời gian UNIX hiện tại tính bằng giây.
- Khung năm phút
- Dấu thời gian phải lệch không quá năm phút so với giờ máy chủ của Expedia, và giá trị bạn băm phải trùng với giá trị trong header.
- Secret chỉ nằm ở máy chủ
- Shared secret là một mật khẩu. PHPTRAVELS lưu nó trong cấu hình máy chủ, không bao giờ trong trình duyệt hay ứng dụng.
- Endpoint thử nghiệm
- Lệnh gọi sandbox được gửi tới test.ean.com và không tạo đặt phòng thật hay giao dịch thẻ; một header thử nghiệm mô phỏng các kết quả như hết phòng hoặc giá thay đổi.
- Vì sao lại là EAN
- EAN là Expedia Affiliate Network, tên cũ của chương trình. Tên này vẫn còn trong cơ chế header và các endpoint.
1// keys come from the server config, never from the browser 2$key = getenv('EXPEDIA_API_KEY'); 3$secret = getenv('EXPEDIA_SHARED_SECRET'); 4$ts = time(); // UNIX seconds, within 5 minutes of Expedia 5 6$signature = hash('sha512', $key . $secret . $ts); 7 8$headers = [ 9 "Authorization: EAN APIKey=$key,Signature=$signature,timestamp=$ts",10 'Accept: application/json',11 'Accept-Encoding: gzip',12 'Customer-Ip: ' . $travellerIp,13];1415// sandbox: https://test.ean.com · live: https://api.ean.com
Hướng dẫn triển khai
Tích hợp API Expedia, từng bước
Từ đơn đăng ký đối tác đến đặt phòng thật đầu tiên. Mỗi bước cho biết ai thực hiện.
- 01
Đăng ký làm đối tác Expedia Group
Đăng ký qua Expedia Group partner solutions với thông tin công ty, tên miền và mô hình kinh doanh. Điều khoản thương mại được thỏa thuận với Expedia theo khu vực và sản lượng của bạn.
BạnExpedia - 02
Nhận API key và shared secret
Sau khi được duyệt, bạn nhận thông tin xác thực Rapid và quyền truy cập tài liệu trong developer hub.
Expedia - 03
Cấu hình connector Expedia
Nhập thông tin xác thực trong trang quản trị PHPTRAVELS, nhập nội dung, đặt mức markup và tiền tệ, rồi mapping phòng và chính sách vào các trang khách sạn.
PHPTRAVELSBạn - 04
Chạy các đặt phòng thử
Đặt phòng trên endpoint thử nghiệm và mô phỏng hết phòng, giá thay đổi, hết thời gian chờ và mã lỗi cho đến khi mọi trường hợp đều được xử lý.
PHPTRAVELSBạn - 05
Vượt qua vòng duyệt ra mắt
Expedia đánh giá website của bạn theo yêu cầu ra mắt và yêu cầu Chứng nhận Tuân thủ PCI (AOC) trước khi chạy thật.
ExpediaBạn - 06
Chuyển sang môi trường thật và bán hàng
Thông tin xác thực thật được nhập vào trang quản trị, đặt phòng thật bắt đầu, và nhật ký nhà cung cấp vẫn bật để xử lý yêu cầu hỗ trợ.
BạnPHPTRAVELS
Thời gian và lựa chọn
Bốn cách bán kho phòng Expedia
Tự xây dựng trên Rapid từ đầu cho bạn toàn quyền kiểm soát nhưng tốn nhiều tháng phát triển. Hệ thống đặt phòng có sẵn, chuyển hướng liên kết và cổng đại lý mỗi cách đánh đổi một điều khác nhau.
| Cách thức | Thời gian ra mắt | Thanh toán trên website của bạn | Ai bảo trì | Phù hợp nhất cho |
|---|---|---|---|---|
| Tự xây dựng trên Rapid | Thời gian ra mắtNhiều tháng: tìm kiếm, thanh toán, quản trị và chứng nhận đều xây từ con số không | Thanh toán trên website của bạnCó | Ai bảo trìĐội lập trình của bạn, mỗi khi API Expedia thay đổi | Phù hợp nhất choOTA lớn có đội kỹ thuật riêng |
| Hệ thống đặt phòng có sẵn (PHPTRAVELS)PHPTRAVELS | Thời gian ra mắtVài tuần: luồng khách sạn đã có, thời gian dành cho cấu hình và vòng duyệt của Expedia | Thanh toán trên website của bạnCó | Ai bảo trìCác bản cập nhật của hệ thống, với toàn bộ mã nguồn trong tay bạn | Phù hợp nhất choĐại lý và startup muốn nhanh chóng có thương hiệu và trang thanh toán riêng |
| Chuyển hướng liên kết | Thời gian ra mắtVài ngày, nếu Expedia chấp nhận đơn đăng ký | Thanh toán trên website của bạnKhông | Ai bảo trìExpedia vận hành luồng đặt chỗ | Phù hợp nhất choTrang nội dung và blog kiếm hoa hồng giới thiệu |
| Cổng đại lý (TAAP) | Thời gian ra mắtKhông cần xây dựng: đại lý đặt trong cổng của Expedia | Thanh toán trên website của bạnKhông | Ai bảo trìExpedia | Phù hợp nhất choĐại lý đặt từng chuyến cho khách hàng |
Yêu cầu ra mắt
Expedia kiểm tra gì trước khi bạn chạy thật
Vòng duyệt xem xét cách website của bạn vận hành, không chỉ việc lệnh gọi có thành công hay không. Đánh dấu những gì hệ thống của bạn đã làm được; PHPTRAVELS đáp ứng mọi mục trong luồng khách sạn tiêu chuẩn.
Chi phí
Tích hợp API Expedia tốn bao nhiêu?
Expedia không công bố bảng giá cho quyền truy cập API; bạn có doanh thu từ đặt phòng theo điều khoản thỏa thuận với Expedia. Chi phí của riêng bạn là phần mềm, hosting và tuân thủ.
Quyền truy cập Expedia
Thỏa thuận với Expedia: hoa hồng hoặc biên lợi nhuận trên đặt phòng, tùy hợp đồng, khu vực và sản lượng của bạn.
Hệ thống đặt phòng
PHPTRAVELS là giấy phép một lần từ kèm toàn bộ mã nguồn, nên không có phí hằng tháng theo đặt phòng.
Hosting
Máy chủ của riêng bạn hoặc dịch vụ hosting được quản lý của chúng tôi; connector Expedia chạy trong bản cài đặt của bạn.
Thanh toán và PCI
Một cổng thanh toán và tuân thủ PCI cho dữ liệu thẻ, điều mà Expedia yêu cầu bạn chứng minh khi ra mắt.
Câu hỏi thường gặp
Câu hỏi về tích hợp API Expedia
Câu trả lời ngắn cho những điều đại lý hỏi trước khi đăng ký.
Liên hệ kinh doanhExpedia không thu phí công khai cho quyền truy cập Rapid API. Bạn cần quan hệ đối tác được phê duyệt, và có doanh thu qua hoa hồng hoặc biên lợi nhuận theo điều khoản thỏa thuận với Expedia. Chi phí của bạn là phần mềm đặt phòng, hosting và tuân thủ PCI.
Đăng ký làm đối tác qua Expedia Group partner solutions. Sau khi được duyệt, bạn nhận API key và shared secret cho Rapid, cùng quyền truy cập sandbox để xây dựng và thử nghiệm trước vòng duyệt ra mắt.
Rapid là API REST và JSON của Expedia Group để bán du lịch dưới thương hiệu riêng của bạn. API bao gồm lưu trú, thuê xe, chuyến bay và hoạt động, với các lệnh gọi tìm kiếm, kiểm tra giá, đặt chỗ và quản lý.
EAN, Expedia Affiliate Network, là tên cũ của chương trình đối tác của Expedia. Rapid là API hiện tại; tên EAN vẫn còn trong header xác thực và địa chỉ endpoint.
Dùng Rapid nếu khách du lịch cần đặt trên website hoặc ứng dụng của chính bạn. Dùng TAAP nếu đại lý của bạn đặt chuyến cho khách hàng trong cổng của Expedia và nhận hoa hồng.
Có. Yêu cầu gửi tới endpoint thử nghiệm không tạo đặt phòng thật hay giao dịch thẻ, và một header thử nghiệm cho phép mô phỏng các kết quả như hết phòng hoặc giá thay đổi.
Xây dựng từ đầu mất nhiều tháng. Với PHPTRAVELS, luồng khách sạn đã có sẵn, nên thời gian dành cho cấu hình, mapping nội dung và vòng duyệt ra mắt do Expedia lên lịch.
Luồng khách sạn Expedia đã có sẵn trong mô-đun lưu trú. Thuê xe, chuyến bay và hoạt động của Rapid có thể được bổ sung dưới dạng tích hợp tùy chỉnh trên các mô-đun thuê xe, chuyến bay và tour.
Khám phá thêm
Thêm về nền tảng
- Tích hợp API Expedia TAAPKhách sạn TAAP, hoa hồng và thay đổi trên cổng của bạn
- Expedia ExtranetCổng đối tác quản lý giá, tồn kho và đặt phòng
- Tích hợp Hotelbeds APIContent và Booking API, kiểm tra giá và ánh xạ khách sạn
- API Booking.com và PricelineTruy cập API khách sạn Booking.com, Priceline và Expedia
- Khách sạnBedbank và hợp đồng trực tiếp
- Tích hợp API tùy chỉnhKết nối mọi API nhà cung cấp hoặc đối tác với PHPTRAVELS
