Demo trực tiếp

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.
Ký một yêu cầu Rapid (PHP)
 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
SHA-512±5 mintest.ean.com → 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.

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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
  6. 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ứcThời gian ra mắtThanh toán trên website của bạnAi bảo trìPhù hợp nhất cho
Tự xây dựng trên RapidThờ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ôngThanh 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 đổiPhù hợp nhất choOTA lớn có đội kỹ thuật riêng
Hệ thống đặt phòng có sẵn (PHPTRAVELS)PHPTRAVELSThờ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 ExpediaThanh 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ạnPhù 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ếtThờ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ôngAi 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 ExpediaThanh toán trên website của bạnKhôngAi bảo trìExpediaPhù 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.

0/8 đã sẵn sàng

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 doanh

Expedia 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.